Container Registry

Objective
Prerequisites
Restrictions
Configuration
Configuration Sequence
Create Container Registry
Deploy to vK8s Using Container Registry
Concepts
API References

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

Volterra Account

Note: If you do not have an account, see Create a Volterra Account.
An application image hosted on a registry server.

Note: It is required that you have access to the registry server.

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

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.
Enter username for the registry login in the User Name field.

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.

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. * 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.