Container Registry

Objective

This document provides instructions on how to create your container registry using VoltConsole and use them in Volterra virtual K8s (vK8s). Volterra provides mechanism to easily deploy applications using the vK8s. To know more about how Volterra distributes application deployment, see Distributed Application Management.

Container registry object is used to configure a private docker/container image registry from which the application container images are fetched.

Note: To deploy applications on your sites, first create a vK8s object as per the instructions in the Create Virtual K8s Object document.

Using the instructions provided in this guide, you can create a container registry object in VoltConsole for your application images and then use the object in vK8s deployments.


Prerequisites


Restrictions

None.


Configuration

Configuration Sequence

Deploying applications on Volterra network cloud requires you to perform the following sequence of steps:

Phase Description
Create Container Registry Create container registry object in VoltConsole.
Deploy to vK8s Using Container Registry Deploy the applications to vK8s using the container registry object.

Create Container Registry

You can create container registry in your application namespace or shared namespace. This example shows creating it in the application namespace. Log into VoltConsole and perform the following:

Step 1: Start creating container registry object.
  • Click App on the namespace selector and select your namespace to change to your namespace.
  • Navigate to Applications -> Container Registries page in the section tabs on the left.
  • Click Add Container Registry to open the container registry creation form.

nav cr
Figure: Navigate to Container Registry

Step 2:Configure metadata and the registry server.
  • Enter a name in the Name field of metadata section. Optionally, set labels and description for your container registry object.
  • Enter the fully qualified domain name for your registry server in the Server FQDN field.

Note: In case you are using docker hub as your registry server, use docker.io as the FQDN.

  • Enter username for the registry login in the User Name field.

fqdn un
Figure: FQDN and Username

Step 3: Configure secret for the password.
  • Click Configure in the Password section to open the secret configuration page.
  • Enter your password in the secret page and click Blindfold. Ensure that the Text option is selected for the Type field.

blf 1
Figure: Secret Options for Encryption

  • Wait for the encryption to complete and click Apply.

blf 2
Figure: Encrypted Secret

Step 4: Complete creating the container registry.

Click Save and Exit to complete creating the container registry object

cr final
Figure: Container Registry Created


Deploy to vK8s Using Container Registry

Deploy Kubernetes objects to vK8s using the container registry object created.

Perform the following steps in VoltConsole.

Step 1: Navigate to your vK8s object.
  • Click on the application namespace option on the namespace selector. Select your application namespace from the namespace dropdown list to change to that namespace.
  • Select Applications in the configuration menu and Virtual K8s in the options pane.
Step 2: Deploy the web application.
  • Click on the Workloads tab. Click Add vK8s workload.
  • Enter a name to your workload and select an option for the Select Type of Workload option and click Configure.
  • Enter the container name and image name in the Name and Image Name fields respectively.

Note: In case your registry is docker hub, then the value of Image Name field should be specified in the docker.io/<path>:<imagetag> format.

  • Select Private Registry for the Select Container Registry field.
  • Click on the Private Registry field. Select the container registry you created in previous chapter from the displayed list.

wkld cr
Figure: Container Registry for Workload

  • Scroll down and click Apply.
  • Click Save and Exit to create the workload. This will deploy your applications to vK8s.

Note: This step shows sample for a simple service workload. For detailed instructions on configuring workloads, see vK8s Workload.


Concepts


API References