minio/docs/gateway/azure.md
Harshavardhana e3e0532613
cleanup markdown docs across multiple files (#14296)
enable markdown-linter
2022-02-11 16:51:25 -08:00

3.1 KiB

MinIO Azure Gateway Slack

MinIO Gateway adds Amazon S3 compatibility to Microsoft Azure Blob Storage.

Support

Gateway implementations are frozen and are not accepting any new features. Please reports any bugs at https://github.com/minio/minio/issues . If you are an existing customer please login to https://subnet.min.io for production support.

Run MinIO Gateway for Microsoft Azure Blob Storage

Using Docker

podman run \
 -p 9000:9000 \
 -p 9001:9001 \
 --name azure-s3 \
 -e "MINIO_ROOT_USER=azurestorageaccountname" \
 -e "MINIO_ROOT_PASSWORD=azurestorageaccountkey" \
 quay.io/minio/minio gateway azure --console-address ":9001"

Using Binary

export MINIO_ROOT_USER=azureaccountname
export MINIO_ROOT_PASSWORD=azureaccountkey
minio gateway azure

Test using MinIO Console

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

Dashboard Creating a bucket
Dashboard Dashboard

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 alias set myazure http://gateway-ip:9000 azureaccountname azureaccountkey

List containers on Microsoft Azure

mc ls myazure
[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/

Use custom access/secret keys

If you do not want to share the credentials of the Azure blob storage with your users/applications, you can set the original credentials in the shell environment using AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY variables and assign different access/secret keys to MINIO_ROOT_USER and MINIO_ROOT_PASSWORD.

Known limitations

Gateway inherits the following Azure limitations:

  • Only read-only bucket policy supported at bucket level, all other variations will return API Notimplemented error.
  • Bucket names with "." in the bucket name are not supported.
  • Non-empty buckets get removed on a DeleteBucket() call.
  • List Multipart Uploads always returns empty list.

Other limitations:

  • Bucket notification APIs are not supported.

Explore Further