Skip to main content

Docker registry ali oss driver

Project description


This is a docker-registry backend driver based on the Open Storage Service from


Assuming you have a working docker-registry and oss api setup(you can get it here:

get source code and run:
python install

Edit your configuration so that storage reads ali oss.

You should add all the following configurations to your main docker-registry configuration to further configure it, which by default is config/config.yml.

alioss configrations:
* storage: specify the storage to use, should be alwasy alioss
* storage_path: specify the path prefix in the oss bucket
* oss_bucket: specify the bucket where you want to store these images for your registry
* oss_accessid: the access id for the oss bucket, which you get from
* oss_accesskey: the access key for the oss bucket, which you get from

example <you can copy this example into your config.yml, and modify it accordingly>:

oss: &oss
<<: *common
storage: alioss
storage_path: _env:STORAGE_PATH:/devregistry/
oss_bucket: _env:OSS_BUCKET[:default_value]
oss_accessid: _env:OSS_KEY[:your_access_id]
oss_accesskey: _env:OSS_SECRET[:your_access_key]

When you run docker-registry, you can use the following two methods to configure the storage:

* if you run docker-registry on your local host, export these configurations if you want to modify the default value in the configured in the config.yml:
export STORAGE_PATH=<the prefix of the storage path>
export OSS_BUCKET=<your oss bucket>
export OSS_KEY=<your access id>
export OSS_SECRET=<your access key>

* if you run docker-registry on your docker container, remmeber to specify these settings as cmd args:
docker run \
-e STORAGE_PATH=/dockerregistry/ \
-e OSS_BUCKET=docker-registry \
-e OSS_KEY=<your access id> \
-e OSS_SECRET=<your access key> \
-e SEARCH_BACKEND=sqlalchemy \
-p 5000:5000 \

This is licensed under the Apache license. Most of the code here comes from docker-registry, under an Apache license as well.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

docker-registry-driver-alioss-0.1.1.tar.gz (9.0 kB view hashes)

Uploaded Source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page