Help Center> > User Guide >Namespace

Namespace

Namespaces are a way to divide cluster resources among multiple users. Namespaces are suited for scenarios where multiple users spread across multiple teams or projects.

Currently, CCI provides general-computing and GPU-accelerated namespaces. You need to select the resource type when creating a namespace, so that the container in the created workload runs on this type of clusters.

  • General-computing: Supports creation of container instances with CPU resources. This namespace type is suitable for general computing scenarios.
  • GPU-accelerated: Supports creation of container instances with GPU resources. This namespace type is suitable for scenarios such as deep learning, scientific computing, and video processing.
NOTE:

Currently, GPU-accelerated namespaces are available only in CN North-Beijing1.

Relationship Between Namespaces and Networks

A namespace corresponds to a subnet in a VPC, as shown in Figure 1. When a namespace is created, it will be associated with an existing VPC or a newly created VPC, and a subnet will be created under the VPC. Containers and other resources created under this namespace will be in the corresponding VPC and subnet.

If you want to run resources of multiple services in the same VPC, you need to consider the network planning, such as subnet CIDR block division and IP address planning.

Figure 1 Relationship between namespaces and VPC subnets

Application Scenarios

Namespaces can implement partial environment isolation. If you have a large number of projects and personnel, you can create different namespaces based on project attributes, such as production, test, and development.

Creating a Namespace

  1. Log in to the CCI console. In the navigation pane, choose Namespaces.
  2. On the page displayed on the right, click Create for the target namespace type.

    NOTE:

    If you click Quick Creation, a namespace will be created with a random name and associated with an existing VPC and subnet in random. If no VPCs are available, a VPC will be automatically created with a subnet allocated to each AZ.

  3. Enter a name for the namespace.

    NOTE:

    The namespace name must be globally unique in CCI.

  4. Select an enterprise project. In CCI, each namespace belongs to one enterprise project, but an enterprise project can have multiple namespaces.

    NOTE:
    • Skip this step if the Enterprise Management service is not enabled. To enable the service, see Enabling the Enterprise Project Function or Enterprise Multi-Account Function. For the precautions for IAM users, see (Optional) Uploading Images.
    • After you specify an enterprise project, both the namespace and the network and storage resources automatically created for the namespace belong to the enterprise project. These resources should be migrated together with the namespace. For example, when migrating a namespace from project 1 to project 2, also migrate the network and storage resources associated with the namespace to project 2. Otherwise, the workloads in this namespace may not run properly.

  5. Configure a VPC.

    You can use an existing VPC or create a VPC. If you create a VPC, it is recommended that the VPC CIDR block be set to 10.0.0.0/8–24, 172.16.0.0/12–24, or 192.168.0.0/16–24.

    The VPC CIDR block and subnet CIDR block cannot be set to 10.247.0.0/16, because this CIDR block is reserved by CCI for containerized workloads. If you use this CIDR block, IP address conflicts may occur, which may result in workload creation failures or service unavailability. If you do not need to access pods through workloads, you can allocate this CIDR block to a VPC.

  6. Configure a subnet CIDR block.

    Ensure that there are sufficient available IP addresses. If the number of IP addresses are insufficient, workloads will fail to be created.

    Figure 2 Configuring a subnet

  7. Configure an InfiniBand (IB) network.

    InfiniBand is a computer network communication standard used for high-performance computing. It provides high throughput and low latency. IB networks can effectively improve the access speed between containers.

    IB and VPC networks are independent of each other. The IB network is a high-speed access channel between containers, and the VPC network is used for other purposes, including external access.

    When creating an IB network, you can enable IP over IB (IPoIB) and set a CIDR block for the IB network.

    NOTE:
    • Only GPU-accelerated namespaces support IB network settings.
    • The CIDR block of the IB network cannot conflict with the VPC CIDR block.
    Figure 3 Configuring an IB network

  8. Click Create.

    After the creation is complete, you can view the VPC and subnet information on the namespace details page.

Deleting a Namespace

Deleting a namespace will remove all data resources (workloads, ConfigMaps, secrets, and SSL certificates) related to the namespace.

  1. Log in to the CCI console. In the navigation pane, choose Namespaces. On the page displayed on the right, click the namespace to be deleted.
  2. In the upper right corner, click Delete. In the dialog box that is displayed, enter DELETE and click Yes.

    NOTE:

    To delete a VPC or subnet, go to the VPC console.

Creating a Namespace Through kubectl

For details, see Namespace and Network.