Howto::Docker Registry

Introduction

We offer a docker image registry service tied with Gitlab that offers a place to share your docker images and version control them. This is a quick start guide on how to use our docker registry. There are two instances of Gitlab with different URLs:

• https://version.cs.vt.edu -> docker.cs.vt.edu (Image Registry URL)
• https://git.cs.vt.edu -> container.cs.vt.edu (Image Registry URL)

Create Project

First you must create a project in Gitlab to store your images or use an existing project.

Using Registry

These commands are run on your development machine.

Log into registry

To be able to push images up to your registry, you must log in

• docker login docker.cs.vt.edu

Build and push image

Example of building your docker image and uploading it to your registry

• Determine your image's URL with optional tag:
  • docker.cs.vt.edu/<username>/<project>/<image>:<tag>
• You tag your docker build with the image URL, example:
  • docker build -t docker.cs.vt.edu/carnold/library/hello .
• Push the image up to your registry
  • docker push docker.cs.vt.edu/carnold/library/hello

Running an image

• docker run docker.cs.vt.edu/carnold/library/hello:latest

Public vs. Internal vs. Private

Public

If your project is set as "public", this will allow anyone on the Internet to be able to download and use your images.

Internal

If your project is set as "internal", then anyone with access to git.cs.vt.edu can download and use the images after they login with their login.

Private

If your project is set as "private", then only you will be able download and use the images after you login. Unless you create a deploy token:

Deploy Token

You can create a "deploy token" that will allow anyone you share the token with to download and use your images. The user will login with the token username and password. Tokens expire after a time limit. Note: once downloaded the client will have a cached copy of the images, even after the token expires or is revoked. Find out more about deploy tokens: https://docs.gitlab.com/ce/user/project/deploy_tokens/index.html