Intro

We have prepared couple of examples for Artifactory newcomers how to start using docker repositories.

Please note that that Docker repositories functionality is NOT available in Artifactory OSS distribution.

Docker commands examples

Various examples can be found in Basic docker commands article.

Docker repositories via subdomain

This is preferred option for all TDS environments and almost every TDS customer has this option enabled and supported. This Sub Domain method uses  Artifactory Docker repository key/name as the sub domain of Artifactory URL.

Examples of docker commands:

docker login -u <USER_NAME> -p <USER_PASSWORD> <REPOSITORY_KEY>.artifactory.shared.tds.CUSTOMERX.com
docker pull <REPOSITORY_KEY>.artifactory.shared.tds.CUSTOMERX.com/<IMAGE>:<TAG>
docker push <REPOSITORY_KEY>.artifactory.shared.tds.CUSTOMERX.com/<IMAGE>:<TAG>

This is recommended and most popular option due to convenience with the repository address which is easier to read, type or remember.

If subdomain option is not available, Docker repositories via port shall be used.

Docker repositories via port

In this case each Artifactory Docker repository bounds to a specific port. In TDS it should be usually from 9000-9999 range.

You can find that port number via Artifactory user interface:

Examples of docker commands:

docker login -u <USER_NAME> -p <USER_PASSWORD> artifactory.shared.tds.CUSTOMERX.com:<REPOSITORY_PORT>
docker pull artifactory.shared.tds.CUSTOMERX.com:<REPOSITORY_PORT>/<IMAGE>:<TAG>
docker push artifactory.shared.tds.CUSTOMERX.com:<REPOSITORY_PORT>/<IMAGE>:<TAG>

This option is used rather occasionally and in cases when customer did not want to have subdomains feature enabled, for example due to extra SSL certificate needs or other infrastructure limitations.

Port option is available on every Artifactory PRO provided in TDS platform via default ports from 9000-9999 range. However, in some customer cases there might be various network limitations, firewall closures preventing usage of such ports. In such cases we recommend using Dockerrepositoriesviasubdomain option. If subdomain option is not available, firewall opening needed for every necessary specific repository port or full range.