Polly has its own docker repository where dockers can be managed. The advantage of the Polly Docker Repository is that these dockers can also be stored within the same platform as data, code, and analyses and to access the stored dockers all you need is the Polly login credential.
Docker login and logout
In order to login/logout of the docker repository you can run the following command:
polly dockers login
polly dockers logout
The output generated from the above command should then be run on the terminal.
sudobefore the command if required according to system settings.
Create a Docker Repository
Docker repository is a collection of dockers where you can publish and access your docker images. Here you can store one or more versions of your docker image. Every docker can have a tag and if a docker with the same tag is pushed again, it will overwrite the older docker after saving its older version that can still be accessed and used.
There can be multiple such repositories for an organization and only the members of your organization with Polly login credentials can assess them.
Use the following command to create a docker repository:
polly dockers create --name ,< docker_repository_name > --description < description of the repository >
Alternatively, users can create a docker repository using interactive command prompt as shown below.
List docker repositories
You can list all the stored docker repositories in your organization by using this command.
polly dockers list --all
Alternatively, users can list all the docker repositories using interactive command prompt as shown below.
List docker repositories commits
You can list specific repository to view the various commits or tags stored within it through the Polly docker commit list.
polly dockers commit-list --name < docker_repository_name > --all
In order to reduce the indecision when there are multiple dockers with the same name and same tag, you can distinguish them by their unique identifier which is assigned to every docker commit. In case the unique identifier is not passed in the command, the latest version of the docker with that tag will be used.
You can go back to older commit as well if required by using its tag and unique identity listed in the Polly docker commit list.
Alternatively, users can list all the commit-list using interactive command prompt as shown below.
Polly Dockers Path
Typical path of a docker on Polly is
docker.polly.elucidata.io/< organization >/< dockername >:< tag >
- You can have two dockers with the same tag as well, in which case, the latest commit for that tag will be called by default if you call that docker. To call the docker with an older commit, commit hash will be required to specify in the path.
docker.polly.elucidata.io/< organization >/< dockername >@< commit_hash >
The following example contains 2 docker images with the same tag. The latest image has the tag “active“. The active image can just be called by using the usual path.
The image with the inactive tag can be called by specifying the commit hash.
Pull/push of dockers
The commands for docker’s pull/push are the same commands that you use for pulling and pushing from any other docker registry. The only difference is the path of the docker.
Example commands to pull a docker would be:
docker pull docker.polly.elucidata.io/elucidata/16june@sha256:5747316366b8cc9e3021cd7286f42b2d6d81e3d743e2ab571f55bcd5df788cc8
Alternatively, users can update the docker using interactive command prompt as shown below.
Polly CLI help
If help is needed for any command, just type
--help at the end of the command and execute.