How to Provision Vultr Container Registry

[Suhitha]

Question: How to Provision Vultr Container Registry


The process of setting up and configuring a new server or service to make it ready for use.

Vultr Container Registry is a managed storage and distribution system for Open Container Initiative (OCI) images and related artifacts. This subscription allows you to securely host multiple container images, enabling you to build and deploy applications on platforms like Docker and Kubernetes. Vultr Container Registry simplifies the management of containerized applications, providing a reliable and scalable solution for your image storage needs.

Follow this guide to provision a Vultr Container Registry on your Vultr account using the Vultr Customer Portal, API, CLI, or Terraform.


Vultr Customer Portal


1.Navigate to Products and click Container Registry.

2.Click Add Container Registry.

3.Provide a Registry Name.

4.Choose a Container Registry Location.

5.Pick a suitable Plan.

6.By default, the visibility is set to private. Select the checkbox to set the visibility to public.

7.Click Add Container Registry.


Vultr API


1.Send a GET request to the List Registry Regions endpoint and note your target region name (e.g., ewr, sjp, blr).

Code Select Expand

console


$ curl "https://api.vultr.com/v2/registry/region/list" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

2.Send a GET request to the List Registry Plans endpoint and note your target plan key (e.g., start_up, business, premium, enterprise).

Code Select Expand

console


$ curl "https://api.vultr.com/v2/registry/plan/list" \
  -X GET \
  -H "Authorization: Bearer ${VULTR_API_KEY}"

3.Send a POST request to the Create Container Registry endpoint to create a registry with your target region and plan.

Code Select Expand

console


$ curl "https://api.vultr.com/v2/registry" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    --data '{
        "name" : "{label}",
        "public" : false,
        "region" : "{region-name}",
        "plan" : "{plan-key}"
    }'



4.Send a GET request to the List Container Registries endpoint to list all the available registries.

Code Select Expand

console


$ curl "https://api.vultr.com/v2/registries" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

Vultr CLI

1.List all Vultr Container Registry regions and note your target region name (e.g., ewr, sjp, blr).

Code Select Expand

console


$ vultr-cli container-registry regions

2.List all Vultr Container Registry plans and note your target plan (e.g., start_up, business, premium, enterprise).

Code Select Expand

console


$ vultr-cli container-registry plans

3.Create a Vultr Container Registry with your target region and plan.

Code Select Expand

console


$ vultr-cli container-registry create  --name "<label>"  --public false  --region "<region-name>"  --plan "<plan-key>"

4.List all the available Vultr Container Registry subscriptions.

Code Select Expand

console


$ vultr-cli container-registry list

Terraform

1.Ensure the Vultr Terraform provider is configured in your Terraform project.

2.Define the Container Registry resource in your Terraform configuration file.

Code Select Expand

terraform


terraform {
    required_providers {
        vultr = {
            source  = "vultr/vultr"
            version = "~> 2.27"
        }
    }
}

provider "vultr" {}

resource "vultr_container_registry" "registry" {
  name   = "container-registry"    # Registry name
  region = "sjc"                   # Registry region (e.g., ewr, sjc, blr)
  plan   = "start_up"              # Plan key (start_up, business, premium, enterprise)
  public = false                   # Visibility (false=private, true=public)
}

3.Apply the configuration and observe the following output:

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.