Help Center/ SoftWare Repository for Container/ User Guide (Enterprise Edition)/ Access Management/ Domain Names
Updated on 2025-04-30 GMT+08:00
View PDF
Share

Domain Names

There are two types of domain names for SWR Enterprise Edition:

  • Default domain name: It is automatically created for each new repository.
  • Custom domain name: It is created by a user.

You can create custom domain names when:

  • You want to use the domain names planned by your company.
  • Repositories are migrated from other registry services and you need to continue to use their original domain names for service continuity.

A repository can have multiple custom domain names in addition to its default domain name. To use a custom domain name, you need to provide the SSL certificate associated with it and access the repository over HTTPS. This section describes how to use a custom domain name to access a repository.

A repository can have a maximum of five custom domain names. After a domain name is added or deleted, it takes 60s to 90s to take effect.

Prerequisites

  • Domain Name Service (DNS) and Cloud Certificate Manager (CCM) cloud services have been enabled.
  • You must have permission to query a certificate list (scm:cert:list) and permission to export certificates (varying depending on the IAM console edition).
    • New IAM console: scm:cert:export
    • Old IAM console: scm:cert: download
  • A certificate has been issued for the domain name. You can purchase a certificate using the CCM service and associate the certificate with the domain name.

Adding a Domain Name

  1. Log in to the SWR console. In the upper left corner, switch to your region. In the navigation pane, choose Repositories. Click your repository name.
  2. In the navigation pane, choose Access > Domain Names.
  3. Click Add Domain Name.
  4. In the displayed dialog box, enter a domain name, select the certificate issued for it, and click OK.

Updating a Domain Name Certificate

  1. Log in to the SWR console. In the upper left corner, switch to your region.
  2. Click your repository name.
  3. In the navigation pane, choose Access > Domain Names.
  4. Locate a domain name, click Edit in the Operation column.
  5. Select the certificate to be updated and click OK.

Deleting a Custom Domain Name

  1. Log in to the SWR console. In the upper left corner, switch to your region.
  2. Click your repository name.
  3. In the navigation pane, choose Access > Domain Names.
  4. Locate a domain name, click Delete in the Operation column.
  5. Enter DELETE and click OK.

Configuring Domain Name Resolution

  • Public network access

You can configure access control and domain name resolution to access a repository through the Internet using a custom domain name. The following describes how to configure domain name resolution.

  1. Log in to the DNS console.
  2. In the navigation pane, select Public Zones.
  3. (Optional) If there is no public domain name with a custom suffix, click Create Public Zone in the upper right corner, enter a domain name, and click OK.
  4. Click your domain name to go to its details page.
  5. Click Add Record Set. Set parameters and click OK.

    Table 1 Parameters for adding a record set

    Parameter

    Description

    Name

    Enter the prefix of the domain name to be resolved.

    Type

    Type of the record set. Select CNAME.

    Line

    Resolution line. It indicates whether the DNS server will return resolution results based on visitors' carrier networks or geographical locations. Default means that, if no lines are matched, the default resolution result will be returned.

    TTL

    Cache duration of the record set. A shorter TTL is useful for domains whose records change frequently. The default value is 5 minutes.

    Value

    Set it to the default domain name of the repository.

  • Private network access

You can configure access control and domain name resolution to pull images from a repository over VPC. The following describes how to configure domain name resolution.

  1. Log in to the DNS console.
  2. In the navigation pane, select Private Zones.
  3. (Optional) If there is no private zone with a custom suffix, click Create Private Zone in the upper right corner to create one. Enter a domain name, select a region and VPC, and click OK.
  4. Click your domain name to go to its details page.
  5. Click Add Record Set. Set parameters and click OK.

    Table 2 Parameters for adding a record set

    Parameter

    Description

    Name

    Enter the prefix of the domain name to be resolved.

    Type

    Type of the record set. Select CNAME.

    Line

    Resolution line. It indicates whether the DNS server will return resolution results based on visitors' carrier networks or geographical locations. Default means that, if no lines are matched, the default resolution result will be returned.

    TTL

    Cache duration of the record set. A shorter TTL is useful for domains whose records change frequently. The default value is 5 minutes.

    Value

    Set it to the default domain name of the repository.

Parent topic: Access Management