Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

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.

oss configrations:
* storage: specify the storage to use, should be alwasy oss
* storage_path: specify the path prefix in the oss bucket
* oss_host: specify the endpoint host of oss
* 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: oss
storage_path: _env:STORAGE_PATH:/registry/
oss_host: _env:OSS_HOST[:your_oss_endpoint_host]
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_HOST=<your oss endpoint host>
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=/registry/ \
-e OSS_BUCKET=docker-registry \
-e OSS_HOST=<your oss endpoint host> \
-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.

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
docker-registry-driver-oss-0.1.3.tar.gz (10.1 kB) Copy SHA256 hash SHA256 Source None Nov 12, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page