forked from TrueCloudLab/frostfs-s3-gw
57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
|
# MinIO Azure Gateway [](https://slack.min.io)
|
||
|
|
MinIO Gateway adds Amazon S3 compatibility to Microsoft Azure Blob Storage.
|
||
|
|
|
||
|
|
## Run MinIO Gateway for Microsoft Azure Blob Storage
|
||
|
|
### Using Docker
|
||
|
|
```
|
||
|
|
docker run -p 9000:9000 --name azure-s3 \
|
||
|
|
-e "MINIO_ACCESS_KEY=azurestorageaccountname" \
|
||
|
|
-e "MINIO_SECRET_KEY=azurestorageaccountkey" \
|
||
|
|
-e "MINIO_AZURE_CHUNK_SIZE_MB=0.25" \
|
||
|
|
minio/minio gateway azure
|
||
|
|
```
|
||
|
|
|
||
|
|
### Using Binary
|
||
|
|
```
|
||
|
|
export MINIO_ACCESS_KEY=azureaccountname
|
||
|
|
export MINIO_SECRET_KEY=azureaccountkey
|
||
|
|
export MINIO_AZURE_CHUNK_SIZE_MB=0.25
|
||
|
|
minio gateway azure
|
||
|
|
```
|
||
|
|
## 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 to ensure that your server has started successfully.
|
||
|
|
|
||
|
|
|
||
|
|
## 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 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/
|
||
|
|
```
|
||
|
|
|
||
|
|
### 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
|
||
|
|
- [`mc` command-line interface](https://docs.min.io/docs/minio-client-quickstart-guide)
|
||
|
|
- [`aws` command-line interface](https://docs.min.io/docs/aws-cli-with-minio)
|
||
|
|
- [`minio-go` Go SDK](https://docs.min.io/docs/golang-client-quickstart-guide)
|