A namespace is a collection of repositories in Container Registry Personal Edition. Use namespaces to group repositories by team or project, control repository access, and set default repository attributes.
Best practices
Group repositories that belong to the same team or project in one namespace. This prevents naming conflicts when multiple teams use the same repository name. For example, if two teams both have a repository called web-app, placing them in separate namespaces keeps the images distinct:
-
team-a/web-app -
team-b/web-app
Each team can push and pull their own web-app image without interference.
Example namespace names:
| Scope | Example |
|---|---|
| Company | aliyun, alibaba |
| Team or organization | misaka-team |
Create a namespace
Prerequisites
Before you begin, ensure that you have:
-
An Alibaba Cloud account with access to Container Registry Personal Edition
-
Decided whether repositories in this namespace should be public or private by default (see Configure a namespace)
Steps
-
Log on to the Container Registry console.
-
In the left-side navigation pane, click Instances. On the Instances page, click the Container Registry Personal Edition instance.
-
On the instance management page, choose Repository > Namespace in the left-side navigation pane.
-
On the Namespace page, click Create Namespace in the upper-left corner.
-
In the Create Namespace dialog box, enter a namespace name and click Confirm.
Deleting a namespace is irreversible. After a namespace is deleted, it cannot be recovered.
Configure a namespace
After creating a namespace, configure two settings that control how repositories in the namespace behave.
Automatically create repository
By default, pushing a container image to a repository that does not exist automatically creates the repository using the repository name you specify.
To disable this behavior, turn off Automatically Create Repository for the namespace.
Default repository type
Repositories created automatically on image push are private by default.
| Type | Behavior | When to use |
|---|---|---|
| Private | Only authorized users can pull images | Internal or sensitive images |
| Public | Any user can pull images | Open-source or shared images |
To make automatically created repositories public, set Default Repository Type to Public for the namespace.
Limits
| Limit | Value |
|---|---|
| Namespaces per Alibaba Cloud account | 3 |