registry-cli-apatsev 0.1.2

Installation

docker pull anoxis/registry-cli

registry.py

docker run --rm anoxis/registry-cli

docker run --rm anoxis/registry-cli -r http://example.com:5000

docker run --rm --link registry anoxis/registry-cli -r http://registry:5000

chmod 755 registry.py

sudo pip install -r requirements.txt

Listing images

The below command will list all images and all tags in your registry:

registry.py -l user:pass -r https://example.com:5000

List all images, tags and layers:

registry.py -l user:pass -r https://example.com:5000 --layers

List particular image(s) or image:tag (all tags of ubuntu and alpine in this example)

registry.py -l user:pass -r https://example.com:5000 -i ubuntu alpine

Same as above but with layers

registry.py -l user:pass -r https://example.com:5000 -i ubuntu alpine --layers

Username and password

It is optional, you can omit it in case if you use insecure registry without authentication (up to you, but its really insecure; make sure you protect your entire registry from anyone)

username and password pair can be provided in the following forms

-l username:password
-l 'username':'password'
-l "username":"password"

Username cannot contain colon (‘:’) (I don’t think it will contain ever, but anyway I warned you). Password, in its turn, can contain as many colons as you wish.

Deleting images

Keep only last 10 versions (useful for CI): Delete all tags of all images but keep last 10 tags (you can put this command to your build script after building images)

registry.py -l user:pass -r https://example.com:5000 --delete

If number of tags is less than 10 it will not delete any

You can change the number of tags to keep, e.g. 5:

registry.py -l user:pass -r https://example.com:5000 --delete --num 5

You may also specify tags to be deleted using a list of regexp based names. The following command would delete all tags containing “snapshot-” and beginning with “stable-” and a 4 digit number:

registry.py -l user:pass -r https://example.com:5000 --delete --tags-like "snapshot-" "^stable-[0-9]{4}.*"

As one manifest may be referenced by more than one tag, you may add tags, whose manifests should NOT be deleted. A tag that would otherwise be deleted, but whose manifest references one of those “kept” tags, is spared for deletion. In the following case, all tags beginning with “snapshot-” will be deleted, safe those whose manifest point to “stable” or “latest”

registry.py -l user:pass -r https://example.com:5000 --delete --tags-like "snapshot-" --keep-tags "stable" "latest"

The last parameter is also available as regexp option with “–keep-tags-like”.

Delete all tags for particular image (e.g. delete all ubuntu tags):

registry.py -l user:pass -r https://example.com:5000 -i ubuntu --delete-all

Delete all tags for all images (do you really want to do it?):

registry.py -l user:pass -r https://example.com:5000 --delete-all

Disable ssl verification

If you are using docker registry with a self signed ssl certificate, you can disable ssl verification:

registry.py -l user:pass -r https://example.com:5000 --no-validate-ssl

Important notes:

Contribution

You are very welcome to contribute to this script. Of course, when making changes, please include your changes into test.py and run tests to check that your changes do not break existing functionality.

For tests to work, install mock library

pip install -r requirements-test.txt

Running tests is as simple as

python test.py

Test will print few error messages, like so

Testing started at 9:31 AM ...
  tag digest not found: 400
error 400

this is ok, because test simulates invalid inputs also.