Name: object-storage-cli
Owner: Deis
Description: A Command Line Tool for Utilizing Multiple Object Storage Systems from a Single Interface
Forked from: arschles/object-storage-cli
Created: 2016-03-31 17:51:07.0
Updated: 2018-03-01 17:46:29.0
Pushed: 2018-03-01 16:51:34.0
Homepage: null
Size: 60
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
| | Deis Workflow is no longer maintained.
Please read the announcement for more detail. |
|—:|—|
| 09/07/2017 | Deis Workflow v2.18 final release before entering maintenance mode |
| 03/01/2018 | End of Workflow maintenance: critical patches no longer merged |
| | Hephy is a fork of Workflow that is actively developed and accepts code contributions. |
A Command Line (CLI) Tool for Utilizing Multiple Object Storage Systems from a Single Interface.
This CLI accepts a single flag called --storage-type
. The value of that flag determines which object storage API to use, and the remaining sections in this document describe how the CLI gets the location, credentials and other information it needs to work with the specified system.
s3
If the storage type is s3
, the CLI reads three files which specify access key, access secret and region. Each file location can be configured by an environment variable. Each environment variable and its default is listed below.
ACCESS_KEY_FILE
(/var/run/secrets/deis/objectstore/creds/accesskey
)SECRET_KEY_FILE
(/var/run/secrets/deis/objectstore/creds/secretkey
)REGION_FILE
(/var/run/secrets/deis/objectstore/creds/region
)BUCKET_FILE
(/var/run/secrets/deis/objectstore/creds/bucket
)gcs
If the storage type is gcs
, the CLI reads two files which specify the bucket and GCS access key. Each file location can be configured by an environment variable. Each environment variable and its default is listed below.
KEY_FILE
(/var/run/secrets/deis/objectstore/creds/key.json
)project-id
key, which specifies the GCS project IDBUCKET_FILE
(/var/run/secrets/deis/objectstore/creds/bucket
)azure
If the storage type is azure
, the CLI reads three files which specify the account name, account key and container. Each file location can be configured by an environment variable. Each environment variable and its default is listed below.
ACCOUNT_NAME_FILE
(/var/run/secrets/deis/objectstore/creds/accountname
)ACCOUNT_KEY_FILE
(/var/run/secrets/deis/objectstore/creds/accountkey
)CONTAINER_FILE
(/var/run/secrets/deis/objectstore/creds/container
)minio
If the storage type is minio
, the CLI assumes that it should use the AWS S3 API to talk to the minio
server at a given address.
In this case, the CLI requires information on where the Minio server is located, along with the authentication/authorization information.
It gets the location information from environment variables, and assumes that any value that starts with $
is itself an environment variable. It also gets the auth information from three files whose locations are specified by environment variables as well. See below for the list of environment variables and their defaults.
S3_HOST
($DEIS_MINIO_SERVICE_HOST
)S3_PORT
($DEIS_MINIO_SERVICE_PORT
)REGION
(us-east-1
)SECURE
(false
)V4_AUTH
(true
)ACCESS_KEY_FILE
(/var/run/secrets/deis/objectstore/creds/accesskey
)ACCESS_SECRET_FILE
(/var/run/secrets/deis/objectstore/creds/secretkey
)BUCKET_FILE
(/var/run/secrets/deis/objectstore/creds/bucket
)Every commit to the master
branch gets tested and cross-compiled in Travis CI. The resulting binaries get uploaded to Google Cloud Storage. If you'd like to download the latest build, use the command in one of the sections below appropriate for your system.
-o object-storage-cli https://storage.googleapis.com/object-storage-cli/objstorage-latest-darwin-amd64
ject-storage-cli --version
-o object-storage-cli https://storage.googleapis.com/object-storage-cli/objstorage-latest-darwin-386
ject-storage-cli --version
-o object-storage-cli https://storage.googleapis.com/object-storage-cli/objstorage-latest-linux-amd64
ject-storage-cli --version
-o object-storage-cli https://storage.googleapis.com/object-storage-cli/objstorage-latest-linux-386
ject-storage-cli --version