arrow-left

All pages
gitbookPowered by GitBook
1 of 11

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Setting Up Docker Registry

Docker Registry based on Docker Hub for Private use.

hashtag
1. Move to the external registry creation screen

1) Navigate to [Build Configuration] - [External Container Registries].

[Screen] Registries

2) Click the "+ Register" button in the upper right corner to select the provider for creation.

[Screen] Select External Registries

hashtag
2. Enter Registry Registration Information

1) Click the "+ Register" button and select "Docker Registry"

2) After registering Docker Registry authentication information in the basic information, click the "Test Connection" button.

Item (* is required)
Content
  1. Enter the name of the registry to be created in the registry.

  2. Enter a description for the registry in the description.

  3. Enter the EndPoint URL in the correct format.


hashtag
Access ID & Access Secret Verification Method

1) Click on the profile in the upper right corner and select "My Account."

2) Confirm the Access ID

Access ID : User's nickname or email address

3) Click on the "Security" tab on the right, then click on "New Access Token" in the upper right.

4) Enter a description for the token and copy the Access Token upon issuance.

Access Token : Copy Access Token

Access Secret*

Docker Login Token

Enter the name of the registered registry.
  • Enter Access ID and Access Secret.

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry

    Endpoint URL*

    External Container Registry Endpoint Address

    Registry*

    Enter the name of the already registered registry

    Access ID*

    Docker Login ID

    [Screen] Select External Registries(Docker Registry)
    [Screen] Register Docker Registry Registry Authentication Information

    Setting Up Harbor

    Harbor is a container registry used in addition to the one registered through "Registry Creation" used in the internal cluster.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    [Screen] Registries

    2) Click the "+ Register" button in the upper right corner to select the provider to create.

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Harbor"

    2) After registering Harbor authentication information in the basic information, click the "Test Connection" button.

    Item (* is required)
    Content
    1. Enter the name for the registry to be created in the registry.

    2. Enter a description for the registry.

    3. Enter the EndPoint URL.

    Access Secret*

    Harbor Login Password

    Ca Certificate

    Enter the private certificate information

    Insecure

    Specify whether it's insecure

    Enter the registry name.
  • Enter Access ID and Access Secret.

  • If CA Certificate exists, enter it (optional).

  • Check the option for using Insecure (optional).

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry

    Endpoint URL*

    Enter the Endpoint Address of the external container registry

    Registry*

    Enter the name of the already registered registry

    Access ID*

    Harbor Login ID

    [Screen] Select External Registries
    [Screen] Select External Registries(Harbor)
    [Screen] Register Harbor Registry Authentication Information

    Setting Up AWS ECR

    Amazon Elastic Container Registry (Amazon ECR) is a fully managed container registry that provides highly available and secure hosting for container images and artifacts. It allows you to deploy your applications reliably anywhere.

    hashtag
    1. Navigate to the External Registry Creation Screen

    1) Move to [Build Configuration] - [External Container Registry].

    [Screen] Registry

    2) Click the "+ Register" button in the upper right corner and select the provider you want to create.

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button, and then select "AWS ECR"

    2) After entering the AWS authentication information in the basic details, click the "Test Connection" button.

    Item (* is required)
    Content
    1. Enter the name of the registry to be created in the registry.

    2. Enter a description for the registry in the description.

    3. Enter the EndPoint URL in the correct format.


    hashtag
    Access ID & Access Secret Verification Method

    1) Access the AWS Console to retrieve the necessary information.

    2) Click on the registered user, then click the tab, and click the button in the upper right corner of the "Access keys" box.

    3) Click "Other" among the next buttons and click "Next."

    4) Enter a description tag for the access key to be created and click the "Create access key" button.

    5) Confirm the generated access key and secret access key values.

    hashtag
    Creating a Registry

    You can create both private and public repositories.

    (Note: This guide is written based on the private repository in the 'us-east-1' region, and the process is the same for public repositories.)

    1) Click the "Create Repository" button in the upper right corner.

    2) Enter the repository name to create the repository.

    (In Cocktails, builds are done with "Registry Address/Image Name" so please make sure to create the registry as "Registry Name/Image Name")

    hashtag
    EndPoint URL & registry Verification Method

    1) Retrieve the necessary information from the list of created repositories in Cocktails.

    EndPoint URL : The table below provides the necessary information

    Category
    EndPoint URL

    Registry : Repository Name Created by User


    ※ Permissions need to be granted separately for Private Registries.

    hashtag
    Private Registry Permission Example

    1) Click on "Settings" in [Amazon Elastic Container Registry] for the [Private registry].

    2) Click the "Generate Policy" button in the upper right corner of [Settings] - [Permissions].

    3) lick "JSON" in the upper right corner, add the following items, and click "Save Policy" to save.

    Sid: Permission Name

    Principal: Specify one or more AWS account IDs to grant permission. Specify more than one account using a comma-separated list.

    Action : “ecr:*”

    Create Registry

    External Registry Registration

    By default, Cocktail Cloud provides Harbor (Registry) when configuring the platform. Additionally, it supports integration with external registries. You can register externally created registries in Cocktail, enabling image builds and deployments.

    Setting Up AWS ECRchevron-rightSetting Up Azure ACRchevron-rightSetting Up Docker Hubchevron-rightSetting Up Docker Registrychevron-rightSetting Up Google GCRchevron-rightSetting Up Harborchevron-rightSetting Up Naverchevron-rightSetting Up Quaychevron-right

    Access ID*

    Access Key

    Access Secret*

    Secret Access Key

    Select the region of the registered registry.
  • Enter the name of the registered registry.

  • Enter Access ID and Access Secret.

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • Name*

    Enter the name for the external container registry you want to register

    Description

    Enter the description for the external container registry you want to register

    Endpoint URL*

    Endpoint Address of the External Container Registry

    Region*

    Region of the Registered Registry

    Registry*

    Name of the Registered Registry

    Private

    (User Number).dkr.ecr.(Region).amazonaws.com

    Public

    public.ecr.aws/(User Alias)

    [Screen] Select External Registry
    [Screen] Select External Registry (AWS ECR)
    [Screen] Register AWS Registry Authentication Information

    Setting Up Docker Hub

    Docker Hub is a container registry built to enable developers and open-source contributors to discover, use, and share container images.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    [Screen] Registries

    2) Click the "+ Register" button in the upper right corner to select the provider for creation.

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Docker Hub"

    2) After registering Docker Hub authentication information in the basic information, click the "Test Connection" button.

    Item (* is required)
    Content
    1. Enter the name of the registry to be created in the registry.

    2. Enter a description for the registry in the description.

    3. Enter the EndPoint URL in the correct format.


    hashtag
    To confirm the namespace

    1) Log in to Docker Hub and click on "Repositories" at the top.

    2) Click on "Create repository" in the upper right corner.

    3) Create a namespace and the image to be generated.

    Since Docker Hub creates both the repository and image name simultaneously, the image name in the Build/Pipeline > Build section should match the Docker Hub Repository Name for image build generation.


    hashtag
    To verify Access ID & Access Secret

    1) Click on the profile in the upper right corner and select "My Account."

    2) Confirm the Access ID

    Access ID : User's nickname or email address

    3) Click on the "Security" tab on the right, then click on "New Access Token" in the upper right.

    4) Enter a description for the token and copy the Access Token upon issuance.

    Access Token : Copy Access Token

    Create Registry

    We have previously created a service map. Now, let's create a registry to register in the workspace.

    hashtag
    1. Move to the Registry Creation Screen

    1) Click the "+ Create" button in the upper right corner on the [Build Configuration] - [Container Registry] tab.

    Setting Up Azure ACR

    Azure Container Registry(ACR) is a container image storage and management service provided by Azure. ACR offers various features necessary for storing and deploying Docker images.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    2) Click the "+ Register" button in the upper right corner to select the provider to create.

    Access Secret*

    Access Secret

    Enter the name of the registered registry.
  • Enter Access ID and Access Secret.

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry.

    Endpoint URL*

    External Container Registry Endpoint Address -> Mostly fixed as https://docker.ioarrow-up-right

    Namespace*

    Enter the registered registry namespace

    Access ID*

    Access Key

    [Screen] Select External Registries
    [Screen] Select External Registries(Docker Hub)
    [Screen] Register Docker Hub Registry Authentication Information
    hashtag
    2. Enter Registry Creation Information
    [Screen] Registry Creation Basic Information
    Item (* is required)
    Content

    Registry*

    Enter the name of the registry to be created

    Description

    Enter the description for the registry to be created

    1) Enter the name of the registry to be created in the "Registry Name" field.

    2) Input a description for the registry in the "Description" field.

    3) Click the "Save" button in the upper right corner.

    hashtag
    3. Registry Creation Confirmation

    [Screen] Confirm Registry Creation

    1) Verify the newly created registry in the registry list screen.

    hashtag
    4. Next Steps

    Next, we will explain the process of creating an image registry, which is required for workspace registration. Please proceed to the "Create Workspace" page.

    [Screen] Registry
    [Screen] Select External Registries

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Azure ACR."

    [Screen] Select External Registries(Azure ACR)

    2) After registering Azure ACR authentication information in the basic information, click the "Test Connection" button.

    [Screen] Register Azure Registry Authentication Information
    Item (* is required)
    Content

    Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry

    Endpoint URL*

    Enter the login server information

    Registry*

    Enter the name of the already registered registry

    Client ID

    username

    1. Enter the name of the registry to be created in the registry.

    2. Enter a description for the registry in the description.

    3. Enter the EndPoint URL in the correct format.

    4. Select the region of the registered registry.

    5. Enter the Client ID and Client Secret.

    6. Click "Test Connection" in the upper right corner to verify if the registry is available.

    7. Click the "Save" button in the upper right corner.


    hashtag
    How to Create Azure Container and Verify Authentication Information

    1) Access the Azure Portal to retrieve the necessary information.

    2) Click on "Management Groups" to efficiently manage access, policies, and compliance for subscriptions.(All services - Management and governance - Management groups)

    2-1) Click the "Create" button to go to the creation screen.

    2-2) Create a management group to be used internally.

    3) Click on "Subscriptions" to create a set that encompasses all resources.

    3-1) Click the "Add" button to go to the creation screen.

    4) Click on "Resource Groups," a logical container for managing resources grouped together. (All services - Management and governance - Resource Group)

    4-1) Click the "Create" button to go to the creation screen.

    4-2) [Create Resource Group] - Choose a resource group name and region, then create.

    5) Click on "Resources" to create resources that can be used for Azure services.

    5-1) In the marketplace, search for "registry" and click on "Container Registry."

    5-2) Click the "Create" button.

    5-3) Register with subscription, resource group, registry name, and location (region).

    6) Click on the created resource and click on "Access Keys."

    Registry: Registry Name

    EndPoint URL: Login Server

    Client ID: User Name

    Client Secret : Password

    [Screen] Registries

    Setting Up Google GCR

    Google Container Registry provides secure private Docker storage on Google Cloud. The Container Registry is a private Docker storage compatible with widely used continuous deployment systems.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    [Screen] Registries

    2) Click the "+ Register" button in the upper right corner to select the provider for creation.

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Google GCR."

    2) After registering Google GCR authentication information in the basic information, click the "Test Connection" button.

    Item (* is required)
    Content
    • List of regions:

    1. Enter the name for the registry to be created in the registry.

    2. Enter a description for the registry in the description.

    3. Enter the EndPoint URL in the correct format.


    hashtag
    Access JSON Verification Steps

    1) Log in to the Google Cloud Console.

    2) In the Google Cloud Console, click on the "IAM & Admin" button.

    3) Under the "IAM & Admin" tab, click on "Service Accounts," then click the "+ Create Service Account" button at the top center.

    4) Set the name for the service account. then click "CREATE AND CONTINUE"button.

    5) Set the permissions for the service account to be created.

    Owner permissions grant full access to most Google Cloud resources.

    You can provide different permissions if needed, but access may be restricted based on the assigned permissions..

    6) Click on the created service account, click "Add Key," then click "Create a new key," choose JSON format, and click "Create."

    7) Verify that the JSON file has been generated locally.

    Accss JSON : File contents

    hashtag
    Project ID Verification

    Project ID : The name in the leftmost select box in the search.

    hashtag
    Registry & Endpoint URL Verification

    레지스트리 : Repository name

    Endpoint URL : Region of the registry to be created

    Setting Up Naver

    Naver Container Registry allows for the easy storage and management of container images in a private Docker registry and facilitates straightforward deployment to the Naver Cloud Platform.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    [Screen] Registries

    2) Click the "+ Register" button in the upper right corner to select the provider to create.

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Naver"

    2) After registering Naver authentication information in the basic information, click the "Test Connection" button.

    Item (* is required)
    Content
    1. Enter the name for the registry to be created in the registry.

    2. Enter a description for the registry.

    3. Enter the EndPoint URL in the correct format.


    hashtag
    Endpoint URL Guide

    Here are the steps to enable or disable the Public Endpoint.

    1. Log in to the Naver Cloud Platform Console.

    2. Click on "Services," then navigate to "Containers" > "Container Registry"

    3. Click on the target registry name in the list.

    hashtag
    Aceess ID & Access Key 발급 가이드

    Setting Up Quay

    Quay Registry is an open-source container image registry used for storing and managing Docker images. Originally developed by CoreOS, it is currently part of Red Hat.

    hashtag
    1. Move to the external registry creation screen

    1) Navigate to [Build Configuration] - [External Container Registries].

    2) Click the "+ Register" button in the upper right corner to select the provider to create.

    Access JSON*

    Enter the google service account private key (in JSON key format)

    Enter the registry name.
  • Enter Access ID and Access JSON.

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry

    Endpoint URL*

    Enter the Endpoint URL corresponding to the registry region

    Registry*

    Enter the name of the already registered registry

    Access ID*

    _json_key

    https://cloud.google.com/artifact-registry/docs/repositories/repo-locationsarrow-up-right
    [Screen] Select External Registries
    [Screen] Select External Registries(Google GCR)
    [Screen] Register Google GCR Registry Authentication Information

    Access ID*

    Enter the access key

    Access Secret*

    Enter the secret access key

    Enter the registry name.
  • Enter Access ID and Access Secret.

  • Click "Test Connection" in the upper right corner to verify if the registry is available.

  • Click the "Save" button in the upper right corner.

  • In the detailed information section, click on the gear icon in the "Configuration" tab.
  • In the Configuration settings popup, click the toggle button for the "Public Endpoint" item to enable or disable it. After setting the preference, click the [Confirm] button to save the changes.

  • Name*

    Enter the name of the external container registry to be registered

    Describe

    Enter a description for the external container registry

    Endpoint URL*

    Enter the Endpoint Address of the external container registry

    Region*

    Specify the region of the registered registry

    Registry*

    Enter the name of the registered registry

    [Screen] Select External Registries
    [Screen] Select External Registries(Naver)
    [Screen] Register Naver Registry Authentication Information
    [Screen] Select External Registries

    hashtag
    2. Enter Registry Registration Information

    1) Click the "+ Register" button and select "Quay"

    [Screen] Select External Registries(Quay)

    2) After registering Quay authentication information in the basic information, click the "Test Connection" button.

    [Screen] Register Quay Registry Authentication Information
    Item (* is required)
    Content

    Name*

    Enter the name of the external container registry to be registered

    Description

    Enter a description for the external container registry

    Endpoint URL*

    External Container Registry Endpoint Addres

    Registry*

    Enter the name of the already registered registry

    Access ID+RobotID*

    Enter the issued Access ID + Robot ID

    1. Enter the name for the registry to be created in the registry.

    2. Enter a description for the registry.

    3. Enter the EndPoint URL in the correct format.

    4. Enter the registry name.

    5. Enter Access ID + Robot ID and Access Secret.

    6. Click "Test Connection" in the upper right corner to verify if the registry is available.

    7. Click the "Save" button in the upper right corner.


    hashtag
    Access ID + RobotID & Access Secret Verification

    The robot ID needs to be associated with an existing repository.

    1) Access Quay and click on the profile in the upper right corner. Select "Account Settings."

    2) Click on "Robot Accounts," the second menu in the right tab, and then click "Create Robot Account" in the upper right corner.

    3) Create an ID for the robot, select the repository you created, and grant the necessary permissions.

    4) Click on the created RobotID to check the Access Secret.

    Access ID+ RobotID : The first value in the image.

    Access Secret : The second value in the image.

    [Screen] Registries

    Client Secret*

    password

    Access Secret*

    Enter the issued Secret

    https://portal.azure.com/#homeportal.azure.comchevron-right
    Cloud Management ConsoleGoogle Cloudchevron-right
    https://console.aws.amazon.com/console/homeconsole.aws.amazon.comchevron-right
    Logo
    Logo
    https://us-east-1.console.aws.amazon.com/ecr/us-east-1.console.aws.amazon.comchevron-right
    Logo
    Docker Hub Container Image Library | App Containerizationhub.docker.comchevron-right
    Logo
    레지스트리 정보 확인 및 관리guide-fin.ncloud-docs.comchevron-right
    https://guide.ncloud-docs.com/docs/userguide-userguideaccount-5#%EC%9D%B8%EC%A6%9D%ED%82%A4-%EA%B4%80%EB%A6%ACguide.ncloud-docs.comchevron-right
    Logo