Repositories

Summary

Trustgrid provides a fully managed private container registry for each customer account. This allows customers to deploy containerized applications securely to their Trustgrid node appliances.

Container Namespace

Each customer is isolated to their own container namespace that is listed at the bottom of the Repositories page.

To push a container to your private registry it must be named with your namespace as a prefix when tagged.

List View

Uploaded container images may be viewed by navigating to Repositories in the portal.

From this view you can see all containers uploaded to your namespace.

Container Repository View

Each repository can be managed. Clicking into a container will show its uploaded tags and digests, as well as the URI that can be used to pull the container.

Deleting Container Repositories

Next to each container repository name is a box that can be selected. This allows deleting the entire repository and all its tags with a single action.

1. Select the desired container repository.
2. From the Actions dropdown select Delete.
3. Click Confirm.

   

Deleting Specific Container Tags

1. Navigate into the desired repository.
2. Select the desired tag version.
3. From the Actions dropdown select Delete.
4. Click Confirm.

   

Authentication

Docker Login

In order to push to or pull containers from the private registry, your local docker client must first authenticate with your credentials.

To authenticate with the registry, use the command provided in the Docker Login section at the bottom of the repositories page.

Use the copy button to copy the docker login command and paste it into your terminal to authenticate your docker client. This will cache your credentials locally for approximately 24 hours.

Appliance Authentication

Trustgrid appliances authenticate automatically with the Trustgrid container registry and can pull any image uploaded to the registry. All communication between the appliance and the registry occurs using the Trustgrid control plane networks and ports.

Supported image platforms

Images must be pushed as linux/amd64. Other architectures are not supported.

If you push an unsupported image, the push command will succeed but the tag will not appear in the Repositories view and appliances will not be able to pull it.

Example Usage

In the below example we will show how to pull down a container image (Alpine Linux) from the public hub.docker.com registry and then push it to the Trustgrid private registry under our namespace.

1. First pull the Alpine image from Docker Hub with the command docker pull alpine

   

   .
   Note the tag is automatically set to latest by Docker. If desired you can manually specify a specific tag to get a specific version.
2. Tag the image with your namespace prefix. docker tag alpine:latest docker.trustgrid.io/namespace.trustgrid.io/alpine:latest make sure you replace namespace.trustgrid.io with your actual namespace.

   

3. If you haven’t already, Authenticate your Docker client with the Trustgrid registry using the Docker login command provided on the Repositories page
4. Push the tagged image to the private registry. docker push docker.trustgrid.io/namespace.trustgrid.io/alpine:latest

   

5. Back on the Trustgrid portal, navigate to Repositories and you should see the pushed image listed.