A200161411/cloud-container-engine
1
0
Fork 0
forked from docs/cloud-container-engine
Code Pull Requests Activity
cloud-container-engine/umn/source/clusters/creating_a_cce_cluster.rst
proposalbot fce24afa88 Changes to cce_umn from docs/doc-exports#609 (CCE UMN 20230213 version for new c 
Reviewed-by: Eotvos, Oliver <oliver.eotvos@t-systems.com>
Co-authored-by: proposalbot <proposalbot@otc-service.com>
Co-committed-by: proposalbot <proposalbot@otc-service.com>
2023-04-04 09:19:26 +00:00

5.8 KiB
Raw Permalink Blame History

original_name

cce_10_0028.html

Creating a CCE Cluster

On the CCE console, you can easily create Kubernetes clusters. Kubernetes can manage container clusters at scale. A cluster manages a group of node resources.

In CCE, you can create a CCE cluster to manage VMs. By using high-performance network models, hybrid clusters provide a multi-scenario, secure, and stable runtime environment for containers.

Notes and Constraints

  • During the node creation, software packages are downloaded from OBS using the domain name. You need to use a private DNS server to resolve the OBS domain name, and configure the subnet where the node resides with a private DNS server address. When you create a subnet, the private DNS server is used by default. If you change the subnet DNS, ensure that the DNS server in use can resolve the OBS domain name.
  • You can create a maximum of 50 clusters in a single region.
  • After a cluster is created, the following items cannot be changed:
    • Cluster type
    • Number of master nodes in the cluster
    • AZ of a master node
    • Network configuration of the cluster, such as the VPC, subnet, container CIDR block, Service CIDR block, and kube-proxy (forwarding) settings
    • Network model. For example, change Tunnel network to VPC network.

Procedure

  1. Log in to the CCE console. Choose Clusters. On the displayed page, click Create next to CCE cluster.

  2. Set cluster parameters.

    Basic Settings

    • Cluster Name

    • Cluster Version: Select the Kubernetes version used by the cluster.

    • Cluster Scale: maximum number of nodes that can be managed by the cluster.

    • HA: distribution mode of master nodes. By default, master nodes are randomly distributed in different AZs to improve DR capabilities.

      You can also expand advanced settings and customize the master node distribution mode. The following two modes are supported:

      • Random: Master nodes are created in different AZs for DR.
      • Custom: You can determine the location of each master node.
        • Host: Master nodes are created on different hosts in the same AZ.
        • Custom: You can determine the location of each master node.

    Network Settings

    The cluster network settings cover nodes, containers, and Services. For details about the cluster networking and container network models, see Overview <cce_10_0010>.

    • Network Model: CCE clusters support VPC network and tunnel network models. For details, see VPC Network <cce_10_0283> and Container Tunnel Network <cce_10_0282>.
    • VPC: Select the VPC to which the cluster belongs. If no VPC is available, click Create VPC to create one. The VPC cannot be changed after creation.
    • Master Node Subnet: Select the subnet where the master node is deployed. If no subnet is available, click Create Subnet to create one. The subnet cannot be changed after creation.
    • Container CIDR Block: Set the CIDR block used by containers.
    • Service CIDR Block: CIDR block for Services used by containers in the same cluster to access each other. The value determines the maximum number of Services you can create. The value cannot be changed after creation.

    Advanced Settings

    • Request Forwarding: The IPVS and iptables modes are supported. For details, see Comparing iptables and IPVS <cce_10_0349>.
    • CPU Manager: For details, see Binding CPU Cores <cce_10_0351>.
    • Certificate Authentication:

      • Default: The X509-based authentication mode is enabled by default. X509 is a commonly used certificate format.

      • Custom: The cluster can identify users based on the header in the request body for authentication.

        You need to upload your CA root certificate, client certificate, and private key of the client certificate.

        Caution

        • Upload a file smaller than 1 MB. The CA certificate and client certificate can be in .crt or .cer format. The private key of the client certificate can only be uploaded unencrypted.
        • The validity period of the client certificate must be longer than five years.
        • The uploaded CA certificate is used for both the authentication proxy and the kube-apiserver aggregation layer configuration. If the certificate is invalid, the cluster cannot be created.
        • Starting from v1.25, Kubernetes no longer supports certificate authentication generated using the SHA1WithRSA or ECDSAWithSHA1 algorithm. You are advised to use the SHA256 algorithm.
    • Description: The value can contain a maximum of 200 English characters.

  3. Click Next: Add-on Configuration.

    By default, cordens <cce_10_0129> and everest <cce_10_0066> add-ons are installed.

    Service log

    • ICAgent:

      A log collector provided by Application Operations Management (AOM), reporting logs to AOM and Log Tank Service (LTS) according to the log collection rules you configured.

      You can collect stdout logs as required.

  4. After the parameters are specified, click Next: Confirm. The cluster resource list is displayed. Confirm the information and click Submit.

    It takes about 6 to 10 minutes to create a cluster. You can click Back to Cluster List to perform other operations on the cluster or click Go to Cluster Events to view the cluster details.

Related Operations

  • After creating a cluster, you can use the Kubernetes command line (CLI) tool kubectl to connect to the cluster. For details, see Connecting to a Cluster Using kubectl <cce_10_0107>.
  • Add nodes to the cluster. For details, see Creating a Node <cce_10_0363>.