:original_name: AddNode.html .. _AddNode: Accepting a Node ================ Function -------- This API is used to accept a node into a specified cluster. .. note:: The URL for cluster management is in the format of https://Endpoint/uri. In the URL, **uri** indicates the resource path, that is, the path for API access. URI --- POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/add .. table:: **Table 1** Path Parameters +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +============+===========+========+==========================================================================================================================+ | project_id | Yes | String | Project ID. For details about how to obtain the value, see :ref:`How to Obtain Parameters in the API URI `. | +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------+ | cluster_id | Yes | String | Cluster ID. For details about how to obtain the value, see :ref:`How to Obtain Parameters in the API URI `. | +------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------+ Request Parameters ------------------ .. table:: **Table 2** Request header parameters +--------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +==============+===========+========+=================================================================================================================================================================================================================================================+ | Content-Type | Yes | String | Message body type (format). | +--------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | X-Auth-Token | Yes | String | Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see :ref:`API Usage Guidelines `. | +--------------+-----------+--------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. table:: **Table 3** Request body parameters +-----------------+-----------------+-----------------------------------------------------------------------------------------+-----------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=========================================================================================+=================================================================+ | apiVersion | Yes | String | API version. The value is fixed at **v3**. | +-----------------+-----------------+-----------------------------------------------------------------------------------------+-----------------------------------------------------------------+ | kind | Yes | String | API type. The value is fixed at **List**. | +-----------------+-----------------+-----------------------------------------------------------------------------------------+-----------------------------------------------------------------+ | nodeList | Yes | Array of :ref:`AddNode ` objects | List of the nodes to be accepted. | | | | | | | | | | .. note:: | | | | | | | | | | Nodes must have 2-core or higher CPU, 4 GB or larger memory. | +-----------------+-----------------+-----------------------------------------------------------------------------------------+-----------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_addnode: .. table:: **Table 4** AddNode +-----------+-----------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===========+===========+===================================================================================================+==========================================================================================================+ | serverID | Yes | String | Server ID. For details about how to obtain the server ID, see the ECS or BMS documentation. | +-----------+-----------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+ | spec | Yes | :ref:`ReinstallNodeSpec ` object | Node reinstallation configuration parameters. Currently, accepted nodes cannot be added into node pools. | +-----------+-----------+---------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallnodespec: .. table:: **Table 5** ReinstallNodeSpec +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=======================+=================+===================================================================================================================+=====================================================================================================================================================================================================================================================================================================================================+ | os | Yes | String | Operating system. If you specify a custom image, the actual OS version in the IMS image is used. Select an OS version supported by the current cluster, for example, EulerOS 2.5, CentOS 7.7, or EulerOS 2.9. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | login | Yes | :ref:`Login ` object | Node login mode. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | name | No | String | Node name. | | | | | | | | | | .. note:: | | | | | | | | | | Specifying this field during reinstallation will change the node name, and the server name will change accordingly. By default, the current server name is used as the node name. Enter 1 to 56 characters starting with a letter and not ending with a hyphen (-). Only lowercase letters, digits, and hyphens (-) are allowed. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | serverConfig | No | :ref:`ReinstallServerConfig ` object | Server configuration. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | volumeConfig | No | :ref:`ReinstallVolumeConfig ` object | Volume management configuration. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | runtimeConfig | No | :ref:`ReinstallRuntimeConfig ` object | Container runtime configuration. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | k8sOptions | No | :ref:`ReinstallK8sOptionsConfig ` object | Kubernetes node configuration. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | lifecycle | No | :ref:`NodeLifecycleConfig ` object | Customized lifecycle configuration of a node. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | initializedConditions | No | Array of strings | Custom initialization flag. | | | | | | | | | | Before CCE nodes are initialized, they are tainted with **node.cloudprovider.kubernetes.io/uninitialized** to prevent pods from being scheduled to them. | | | | | | | | | | CCE supports custom initialization flags. After receiving the **initializedConditions** parameter, CCE converts the parameter value into a node label and provisions the label with the node, for example, **cloudprovider.openvessel.io/inject-initialized-conditions=CCEInitial_CustomedInitial**. | | | | | | | | | | After the node is labeled, its **status.Conditions** is polled to check whether the **type** of **conditions** has a flag name, such as **CCEInitial** and **CustomedInitial**. If all input flags exist and their status is **True**, the node initialization is complete and the initialization taint is removed. | | | | | | | | | | - Use only letters and digits. Max. characters: 20. | | | | | - Max. flags: 2. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | extendParam | No | :ref:`ReinstallExtendParam ` object | Extended reinstallation parameter, which is discarded. | +-----------------------+-----------------+-------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_login: .. table:: **Table 6** Login +-----------------+-----------------+-----------------+---------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=================+=========================================================+ | sshKey | No | String | Name of the key pair used for login. | +-----------------+-----------------+-----------------+---------------------------------------------------------+ | userPassword | No | String | Password used for node login. | | | | | | | | | | .. note:: | | | | | | | | | | This field is not supported for the current version. | +-----------------+-----------------+-----------------+---------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallserverconfig: .. table:: **Table 7** ReinstallServerConfig +------------+-----------+-------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +============+===========+=======================================================================================================+===========================================================================================================================================================================================================================================================+ | userTags | No | Array of :ref:`UserTag ` objects | Cloud server labels. The key of a label must be unique. The maximum number of user-defined labels supported by CCE depends on the region. In the region that supports the least number of labels, you can still create up to 5 labels for a cloud server. | +------------+-----------+-------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | rootVolume | No | :ref:`ReinstallVolumeSpec ` object | System disk configurations used in reinstallation. | +------------+-----------+-------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_usertag: .. table:: **Table 8** UserTag +-----------+-----------+--------+-----------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===========+===========+========+===============================================================================================+ | key | No | String | Key of the cloud server label. The value cannot start with **CCE-** or **\__type_baremetal**. | +-----------+-----------+--------+-----------------------------------------------------------------------------------------------+ | value | No | String | Value of the cloud server label. | +-----------+-----------+--------+-----------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallvolumespec: .. table:: **Table 9** ReinstallVolumeSpec +-----------+-----------+--------+------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===========+===========+========+================================================================================================+ | imageID | No | String | Custom image ID. | +-----------+-----------+--------+------------------------------------------------------------------------------------------------+ | cmkID | No | String | User master key ID. If this parameter is left blank by default, the EVS disk is not encrypted. | +-----------+-----------+--------+------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallvolumeconfig: .. table:: **Table 10** ReinstallVolumeConfig +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+===============================================================================+===========================================================================================================================================================================================================+ | lvmConfig | No | String | Docker data disk configurations. | | | | | | | | | | The following is an example default configuration: | | | | | | | | | | .. code-block:: | | | | | | | | | | "lvmConfig":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear" | | | | | | | | | | The following fields are included: | | | | | | | | | | - **userLV**: size of the user space, for example, **vgpaas/20%VG**. | | | | | - **userPath**: mount path of the user space, for example, **/home/wqt-test**. | | | | | - **diskType**: disk type. Currently, only **evs**, **hdd**, and **ssd** are supported. | | | | | - **lvType**: type of a logic volume. The value can be **linear** or **striped**. | | | | | - **dockerThinpool**: Docker space size, for example, **vgpaas/60%VG**. | | | | | - **kubernetesLV**: kubelet space size, for example, **vgpaas/20%VG**. | +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | storage | No | :ref:`Storage ` object | Disk initialization management parameter. | | | | | | | | | | This parameter is complex to configure. For details, see :ref:`Attaching Disks to a Node `. | | | | | | | | | | If this parameter retains its default, disks are managed based on the DockerLVMConfigOverride (discarded) parameter in extendParam. This parameter is supported by clusters of version 1.15.11 and later. | | | | | | | | | | .. note:: | | | | | | | | | | If a node specification involves local disks and EVS disks at the same time, do not retain the default value of this parameter to prevent unexpected disk partitions. | +-----------------+-----------------+-------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_storage: .. table:: **Table 11** Storage +------------------+-----------+-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +==================+===========+===========================================================================================================+=============================================================================================+ | storageSelectors | Yes | Array of :ref:`StorageSelectors ` objects | Disk selection. Matched disks are managed according to **matchLabels** and **storageType**. | +------------------+-----------+-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------+ | storageGroups | Yes | Array of :ref:`StorageGroups ` objects | A storage group consists of multiple storage devices. It is used to divide storage space. | +------------------+-----------+-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_storageselectors: .. table:: **Table 12** StorageSelectors +-------------+-----------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=============+===========+=======================================================================================+=====================================================================================================================================================================================================================================================================+ | name | Yes | String | Selector name, used as the index of **selectorNames** in **storageGroup**. Therefore, the name of each selector must be unique. | +-------------+-----------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | storageType | Yes | String | Specifies the storage type. Currently, only **evs** (EVS volumes) and **local** (local volumes) are supported. The local storage does not support disk selection. All local disks will form a VG. Therefore, only one storageSelector of the local type is allowed. | +-------------+-----------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | matchLabels | No | :ref:`matchLabels ` object | Matching field of an EVS volume. The **size**, **volumeType**, **metadataEncrypted**, **metadataCmkid** and **count** fields are supported. | +-------------+-----------+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_matchlabels: .. table:: **Table 13** matchLabels +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===================+===========+========+=============================================================================================================================+ | size | No | String | Matched disk size. If this parameter is left unspecified, the disk size is not limited. Example: 100 | +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ | volumeType | No | String | EVS disk type. | +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ | metadataEncrypted | No | String | Disk encryption identifier. **0** indicates that the disk is not encrypted, and **1** indicates that the disk is encrypted. | +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ | metadataCmkid | No | String | Customer master key ID of an encrypted disk. The value is a 36-byte string. | +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ | count | No | String | Number of disks to be selected. If this parameter is left blank, all disks of this type are selected. | +-------------------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_storagegroups: .. table:: **Table 14** StorageGroups +---------------+-----------+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===============+===========+===================================================================================================+===================================================================================================================================================================+ | name | Yes | String | Name of a virtual storage group, which must be unique. | +---------------+-----------+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | cceManaged | No | Boolean | Storage space for Kubernetes and runtime components. Only one group can be set to **true**. If this parameter is left blank, the default value **false** is used. | +---------------+-----------+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | selectorNames | Yes | Array of strings | This parameter corresponds to **name** in **storageSelectors**. A group can match multiple selectors, but a selector can match only one group. | +---------------+-----------+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | virtualSpaces | Yes | Array of :ref:`VirtualSpace ` objects | Detailed management of space configuration in a group. | +---------------+-----------+---------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_virtualspace: .. table:: **Table 15** VirtualSpace +-----------------+-----------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+===========================================================================================+=============================================================================================================================+ | name | Yes | String | Name of a virtualSpace. | | | | | | | | | | - **Kubernetes**: Kubernetes space configuration. **lvmConfig** needs to be configured. | | | | | - **runtime**: runtime space configuration. **runtimeConfig** needs to be configured. | | | | | - **user**: user space configuration. **lvmConfig** needs to be configured. | +-----------------+-----------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ | size | Yes | String | Size of a virtualSpace. The value must be an integer in percentage. Example: 90%. | | | | | | | | | | .. note:: | | | | | | | | | | The sum of the percentages of all virtualSpaces in a group cannot exceed 100%. | +-----------------+-----------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ | lvmConfig | No | :ref:`LVMConfig ` object | LVM configurations, applicable to **kubernetes** and **user** spaces. Note that one virtual space supports only one config. | +-----------------+-----------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ | runtimeConfig | No | :ref:`RuntimeConfig ` object | runtime configurations, applicable to the **runtime** space. Note that one virtual space supports only one config. | +-----------------+-----------------+-------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_lvmconfig: .. table:: **Table 16** LVMConfig +-----------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===========+===========+========+========================================================================================================================================================================================================+ | lvType | Yes | String | LVM write mode. **linear** indicates the linear mode. **striped** indicates the striped mode, in which multiple disks are used to form a strip to improve disk performance. | +-----------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | path | No | String | Path to which the disk is attached. This parameter takes effect only in user configuration. The value is an absolute path. Digits, letters, periods (.), hyphens (-), and underscores (_) are allowed. | +-----------+-----------+--------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_runtimeconfig: .. table:: **Table 17** RuntimeConfig +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +===========+===========+========+=============================================================================================================================================================================+ | lvType | Yes | String | LVM write mode. **linear** indicates the linear mode. **striped** indicates the striped mode, in which multiple disks are used to form a strip to improve disk performance. | +-----------+-----------+--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallruntimeconfig: .. table:: **Table 18** ReinstallRuntimeConfig +-----------------+-----------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+===============================================================================+======================================================================================================================================================================================================================================================================================================================================+ | dockerBaseSize | No | Integer | Available disk space of a single container on a node, in GB. | | | | | | | | | | If this parameter is left blank or is set to **0**, the default value is used. In Device Mapper mode, the default value is **10**. In OverlayFS mode, the available space of a single container is not limited by default, and the **dockerBaseSize** setting takes effect only on EulerOS nodes in the cluster of the new version. | | | | | | | | | | When Device Mapper is used, you are advised to set **dockerBaseSize** to a value less than or equal to 80 GB. If the value is too large, the container runtime may fail to be started due to long initialization. If there are special requirements for the container disk space, you can mount an external or local storage device. | +-----------------+-----------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | runtime | No | :ref:`Runtime ` object | Container runtime. Defaults to **docker**. | +-----------------+-----------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_runtime: .. table:: **Table 19** Runtime +-----------------+-----------------+-----------------+--------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=================+============================================+ | name | No | String | Container runtime. Defaults to **docker**. | | | | | | | | | | Enumeration values: | | | | | | | | | | - docker | | | | | - containerd | +-----------------+-----------------+-----------------+--------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallk8soptionsconfig: .. table:: **Table 20** ReinstallK8sOptionsConfig +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=====================================================================================+=====================================================================================================================================================================================================================================================================================+ | labels | No | Map | Defined in key-value pairs. A maximum of 20 key-value pairs are allowed. | | | | | | | | | | - **Key**: Enter 1 to 63 characters, starting with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain can be prefixed to a key and contain a maximum of 253 characters. Example DNS subdomain: example.com/my-key | | | | | - **Value**: The value can be left blank or contain 1 to 63 characters that start with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed in the character string. | | | | | | | | | | Example: | | | | | | | | | | .. code-block:: | | | | | | | | | | "k8sTags": { | | | | | "key": "value" | | | | | } | +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | taints | No | Array of :ref:`Taint ` objects | Taints can be added for anti-affinity when creating nodes. A maximum of 20 taints can be added. Each taint contains the following parameters: | | | | | | | | | | - **Key**: A key must contain 1 to 63 characters starting with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain name can be used as the prefix of a key. | | | | | - **Value**: A value must start with a letter or digit and can contain a maximum of 63 characters, including letters, digits, hyphens (-), underscores (_), and periods (.). | | | | | - **Effect**: Available options are **NoSchedule**, **PreferNoSchedule**, and **NoExecute**. | | | | | | | | | | Example: | | | | | | | | | | .. code-block:: | | | | | | | | | | "taints": [{ | | | | | "key": "status", | | | | | "value": "unavailable", | | | | | "effect": "NoSchedule" | | | | | }, { | | | | | "key": "looks", | | | | | "value": "bad", | | | | | "effect": "NoSchedule" | | | | | }] | +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | maxPods | No | Integer | Maximum number of pods that can be created on a node, including the default system pods. Value range: 16 to 256. This limit prevents the node from being overloaded of pods. | +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | nicMultiqueue | No | String | - Number of ENI queues. Example setting: | | | | | | | | | | .. code-block:: | | | | | | | | | | "[{\"queue\":4}]" | | | | | | | | | | The following fields are included: | | | | | | | | | | - **queue**: number of ENI queues. | | | | | - This field can be configured only for BMS nodes in a CCE Turbo cluster. | | | | | - Supported proportions are {"1":128, "2":92, "4":92, "8":32, "16":16, "28":9}. That is, if there is one queue, a maximum of 128 ENIs can be bound. If there are two queues, a maximum of 92 ENIs can be bound for two queues. | | | | | - A larger number of ENI queues indicates higher performance but fewer ENIs can be bound. The queue settings cannot be changed after the node pool is created. | +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | nicThreshold | No | String | - ENI pre-binding thresholds. Example setting: | | | | | | | | | | .. code-block:: | | | | | | | | | | "0.3:0.6" | | | | | | | | | | - Low threshold (L): determines the minimum number of pre-bound ENIs (Min). Formula: Min = Total number of ENIs of the node x L | | | | | - High threshold (H): determines the maximum number of pre-bound ENIs (Max). Formula: Max = Total number of ENIs of the node x H | | | | | - Number of ENIs bound to a BMS node (B) and number of ENIs being used by pods (U): U + Min < B < U + Max | | | | | - If the number of pre-bound ENIs on a BMS node is smaller than the minimum allowed, the system will bind more ENIs to make the numbers equal. | | | | | - If the number of pre-bound ENIs on a BMS node is larger than the maximum allowed, the system periodically unbinds ENIs (about every 2 minutes) to make the numbers equal. | | | | | - Both the thresholds are one-decimal-place values ranging from 0.0 to 1.0. The low threshold must be smaller than or equal to the high one. | | | | | - This field can be configured only for BMS nodes in a CCE Turbo cluster. | | | | | - Pre-binding ENIs can speed up workload creation but occupies IP addresses. | +-----------------+-----------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_taint: .. table:: **Table 21** Taint ========= ========= ====== =========== Parameter Mandatory Type Description ========= ========= ====== =========== key Yes String Key. value No String Value. effect Yes String Effect. ========= ========= ====== =========== .. _addnode__en-us_topic_0000001417516392_request_nodelifecycleconfig: .. table:: **Table 22** NodeLifecycleConfig +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=================+=================+=================+=================================================================================================+ | preInstall | No | String | Pre-installation script. | | | | | | | | | | .. note:: | | | | | | | | | | The input value must be Base64-encoded. (Command: echo -n "Content to be encoded" \| base64) | +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------+ | postInstall | No | String | Post-installation script. | | | | | | | | | | .. note:: | | | | | | | | | | The input value must be Base64-encoded. (Command: echo -n "Content to be encoded" \| base64) | +-----------------+-----------------+-----------------+-------------------------------------------------------------------------------------------------+ .. _addnode__en-us_topic_0000001417516392_request_reinstallextendparam: .. table:: **Table 23** ReinstallExtendParam +-----------------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Parameter | Mandatory | Type | Description | +=======================+===========+========+==============================================================================================================================================================================================+ | alpha.cce/NodeImageID | No | String | (Discarded) ID of the user image to run the target OS. Specifying this parameter is equivalent to specifying **imageID** in **ReinstallVolumeSpec**. The original value will be overwritten. | +-----------------------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Response Parameters ------------------- **Status code: 200** .. table:: **Table 24** Response body parameters +-----------+--------+-------------------------------------------------------------------------------------------------------+ | Parameter | Type | Description | +===========+========+=======================================================================================================+ | jobid | String | Job ID returned after the job is delivered. The job ID can be used to query the job execution status. | +-----------+--------+-------------------------------------------------------------------------------------------------------+ Example Requests ---------------- Accepting a Node .. code-block:: text POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/add { "kind" : "List", "apiVersion" : "v3", "nodeList" : [ { "serverID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "spec" : { "name" : "my-ecs-0001", "os" : "EulerOS 2.5", "login" : { "sshKey" : "KeyPair-001" } } } ] } Example Responses ----------------- **Status code: 200** The job for accepting a node into a specified cluster is successfully delivered. .. code-block:: { "jobid" : "2ec9b78d-9368-46f3-8f29-d1a95622a568" } Status Codes ------------ +-------------+----------------------------------------------------------------------------------+ | Status Code | Description | +=============+==================================================================================+ | 200 | The job for accepting a node into a specified cluster is successfully delivered. | +-------------+----------------------------------------------------------------------------------+ Error Codes ----------- See :ref:`Error Codes `.