minio/docs/gateway/gcs.md
Krishna Srinivas ce403fdaa0 GCS documentation (#4622)
* GCS documentation and review fixes.
2017-07-10 09:35:20 -07:00

2.8 KiB

Minio GCS Gateway Slack

Minio GCS Gateway adds Amazon S3 compatibility to Google Cloud Storage.

Run Minio Gateway for GCS

Create service account key for GCS and get the credentials file

  1. Go to the API Console Credentials page.
  2. Select your project or create a new project. Note down your project ID.
  3. On the Credentials page, select the Create credentials drop-down, then select Service account key.
  4. From the Service account drop-down, select New service account
  5. Fill up Service account name and Service account ID
  6. For the Role, click the selec dropdown to choose Storage -> Storage Admin (Full control of GCS resources)
  7. Click the Create button. This will download a credentials file to your desktop. Let's call this credentials.json

Note: Alternate ways to setup Application Default Credentials is explained here

Using Docker

docker run -p 9000:9000 --name gcs-s3 \
 -v /path/to/credentials.json:/credentials.json \
 -e "GOOGLE_APPLICATION_CREDENTIALS=/credentials.json" \
 -e "MINIO_ACCESS_KEY=minioaccountname" \
 -e "MINIO_SECRET_KEY=minioaccountkey" \
 minio/minio gateway gcs yourprojectid

Using Binary

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
export MINIO_ACCESS_KEY=minioaccesskey
export MINIO_SECRET_KEY=miniosecretkey
minio gateway gcs yourprojectid

Test using Minio Browser

Minio Gateway comes with an embedded web based object browser. Point your web browser to http://127.0.0.1:9000 ensure your server has started successfully.

Screenshot

Test using Minio Client mc

mc provides a modern alternative to UNIX commands such as ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage services.

Configure mc

mc config host add mygcs http://gateway-ip:9000 minioaccesskey miniosecretkey

List containers on GCS

mc ls mygcs
[2017-02-22 01:50:43 PST]     0B ferenginar/
[2017-02-26 21:43:51 PST]     0B my-container/
[2017-02-26 22:10:11 PST]     0B test-container1/

Known limitations

Limitations

Explore Further