Skip to main content

Create and manage repository

Create repository​

A repository is a storage location within a registry for storing container images. Follow the steps below to create a repository in the Container Registry service.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.

  2. In the Repository menu, click the [Create repository] button.

  3. Enter the required information and click the [Create] button.

    FieldDescription
    VisibilitySet whether the repository is public or private
    - Private: Access restricted based on IAM and repository permissions
    - Public: Anyone with the URI can pull images
    Repository nameEnter the name of the repository (cannot be modified later)
    Description (optional)Description of the repository
    - Limited to 100 characters
    Tag overwriteSet whether to allow overwriting images with the same tag name in the repository
    - Enabled: Overwriting allowed
    - Disabled: Overwriting not allowed
    Image scanConfigure whether to scan images automatically or manually when pushed
    - Auto: Images are scanned automatically upon push
    - Manual: Images must be scanned manually after push
    [Create] buttonClick to create the repository

  4. Confirm that the repository has been created in the Repository menu.

Manage repository​

You can manage repositories in the Container Registry service as follows.

View repository list​

You can view a list of currently created repositories along with basic information.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.

  2. In the Repository menu, check the list of created repositories.

    FieldDescription
    NameName of the repository
    DescriptionDescription of the repository
    ImagesNumber of images stored in the repository
    Image scanImage scan configuration for the repository
    Tag overwriteTag overwrite setting for the repository
    VisibilityRepository visibility
    - If set to public, anyone with the URI can pull images
    Last modifiedDate and time the repository was last modified

View repository details​

You can view detailed information about a repository.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.

  2. In the Repository menu, select the repository you want to view.

  3. View the details on the repository detail page.

    FieldDescription
    VisibilityVisibility of the repository
    - If public, anyone with the URI can pull images
    Image scanWhether image scan is set to automatic or manual
    Tag overwriteWhether tag overwrite is enabled or disabled
    FeaturesPermission settings, commands
    - For more information, refer to Configure repository permission and View image push/pull command

View repository usage history​

You can view the usage history of the repository, such as creation, setting changes, image pushes/pulls.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.
  2. In the Repository menu, select the repository to view.
  3. Open the Usage history tab to view the details.

Edit repository​

You can modify certain settings of a repository, including visibility, description, tag overwrite, and image scan configuration.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.
  2. Go to the Repository menu.
  3. Click the [More] icon next to the repository and select Edit.
  4. Modify the settings in the Edit repository window and click [Save].

Configure repository permission​

If your IAM role includes project admin privileges, you can assign repository permissions to other users.
There are two roles:

  • Repository member: Can push and pull images
  • Repository viewer: Can only pull images
info

Users in the same organization but not part of the project can access the repository using tools like Docker CLI via an access key issued from another project, but they cannot access it via the console.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.
  2. In the Repository menu, select the repository to configure.
  3. Click the [Permission settings] button at the top right.
  4. In the Permission settings popup, add users and assign roles, then click [Confirm].

View image push/pull command​

You can view Docker commands related to authentication, image push, and image pull.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.
  2. In the Repository menu, select the repository.
  3. Click the [View command] button at the top right.
  4. View the commands in the View command popup.

Set up alerts​

You can configure alerts for specific repositories.

info

Alerts for the Container Registry are supported via the Alert Center.

Delete repository​

You can delete repositories that are no longer needed.

  1. Go to the KakaoCloud Console > Container Pack > Container Registry menu.
  2. In the Repository menu, select the checkbox for the repository to delete.
  3. Click the [More] icon > Delete.
  4. In the Delete repository popup, enter the repository name and click [Delete].