Coding

Huawei Cloud Cce Cluster Management

Try it

Manage Huawei Cloud CCE cluster lifecycle, node pools, nodes, and addons with built-in safety confirmations.

What it does

Covers CCE cluster creation, hibernation, wake-up, and deletion, plus node pool scaling, node scheduling controls (cordon, uncordon, drain), and addon install, update, and removal. Dangerous actions such as cluster deletion or node drain require a two-step confirmation: a preview when called without confirm=true, then the actual execution only when confirm=true is passed. Credentials are read from environment variables and never written to disk or logs.

When to use it

  • Creating a CCE Turbo cluster with the eni container network and provisioning its first node pool
  • Resizing or replacing a node pool during a maintenance window
  • Cordon, drain, and remove a node before decommissioning it
  • Installing or updating core addons such as coredns, metrics-server, or everest

The skill document

Huawei Cloud CCE Cluster Management

Overview

Manage CCE (Cloud Container Engine) cluster lifecycle, including cluster creation/deletion/hibernation/awakening, node pool management, node scheduling control, and addon management.

⛔ Security Constraints

Dangerous Operation Confirmation Mechanism

This skill strictly enforces a two-step confirmation mechanism for all dangerous operations to prevent accidental service disruption or data loss.

All dangerous operations require confirm=true parameter to execute. Otherwise, they return a preview and confirmation prompt.

Operations Requiring Confirmation

ToolOperation TypeRisk LevelDescription
huawei_delete_cce_clusterDelete🔴 CriticalDeletes entire CCE cluster, irreversible
huawei_hibernate_cce_clusterHibernate🟠 HighStops all workloads, pauses control plane billing
huawei_awake_cce_clusterAwake🟠 HighResumes cluster from hibernation
huawei_resize_cce_nodepoolScale🟡 MediumAdjusts node pool size, affects capacity
huawei_delete_cce_nodepoolDelete🟠 HighDeletes node pool, affects business capacity
huawei_delete_cce_nodeDelete🟠 HighRemoves node from cluster, affects scheduling
huawei_uninstall_cce_addonUninstall🟠 HighRemoves addon, may affect cluster functionality
huawei_cce_node_cordonCordon🟡 MediumMarks node unschedulable, new pods won't be assigned
huawei_cce_node_uncordonUncordon🟡 MediumMarks node schedulable, new pods may be assigned immediately
huawei_cce_node_drainDrain🟠 HighEvicts all pods from node, affects running workloads

Workflow

Step 1: Preview Operation - Call without confirm parameter

# Example: Preview cluster deletion
python3 scripts/huawei-cloud.py huawei_delete_cce_cluster \
  region=cn-north-4 \
  cluster_id=xxx

Returns: operation preview, risk warning, confirmation example

Step 2: Confirm Execution - Call with confirm=true

# Example: Confirm and execute deletion
python3 scripts/huawei-cloud.py huawei_delete_cce_cluster \
  region=cn-north-4 \
  cluster_id=xxx \
  confirm=true

Credential Security

This skill strictly follows these security rules:

  1. No persistent credential storage - Never saves AK/SK, tokens, or certificates to disk
  2. No long-term memory cache - AK/SK exists only during API call, released afterward
  3. Only project ID memory cache - Non-sensitive project ID cached in process memory
  4. No credential leakage - Never includes AK/SK in logs, responses, or errors
  5. Temporary file cleanup - If temporary cert files are created, they are deleted immediately after use

AK/SK usage methods:

  • Environment variables HW_ACCESS_KEY / HW_SECRET_KEY / HW_REGION_NAME (process-level, not saved)
  • Per-call parameter (valid only for that call)

Prerequisites

Python Environment

  • Python 3.8+
  • Install SDKs: pip install huaweicloudsdkcce huaweicloudsdkcore
  • Optional for node operations: pip install kubernetes
export HW_ACCESS_KEY="your-access-key-id"
export HW_SECRET_KEY="your-secret-access-key"
export HW_REGION_NAME="cn-north-4"

IAM Permission Policies

Ensure the IAM user has the minimum required permissions:

PermissionDescription
cce:cluster:listList clusters
cce:cluster:getGet cluster details
cce:cluster:createCreate clusters
cce:cluster:deleteDelete clusters
cce:cluster:updateUpdate clusters (hibernate/awake/bind EIP)
cce:node:listList nodes
cce:node:getGet node details
cce:node:createCreate nodes
cce:node:deleteDelete nodes
cce:node:updateUpdate nodes (cordon/uncordon/drain)
cce:nodepool:listList node pools
cce:nodepool:createCreate node pools
cce:nodepool:deleteDelete node pools
cce:nodepool:updateUpdate node pools (resize)
cce:addon:listList addons
cce:addon:getGet addon details
cce:addon:createInstall addons
cce:addon:updateUpdate addons
cce:addon:deleteUninstall addons

Core Commands

Cluster Query

ToolFunctionParameters
huawei_list_cce_clustersList all CCE clusters in regionregion
huawei_get_cce_nodesGet detailed node informationregion, cluster_id, node_id
huawei_get_cce_kubeconfigGet cluster kubeconfigregion, cluster_id, duration

Cluster Management

ToolFunctionRisk LevelRequires Confirmation
huawei_create_cce_clusterCreate CCE cluster🟢 LowNo
huawei_delete_cce_clusterDelete CCE cluster🔴 CriticalYes
huawei_hibernate_cce_clusterHibernate cluster🟠 HighYes
huawei_awake_cce_clusterAwake cluster🟠 HighYes
huawei_bind_cce_cluster_eipBind cluster EIP🟢 LowNo
huawei_unbind_cce_cluster_eipUnbind cluster EIP🟡 MediumNo

Recommended defaults:

  • Cluster type: Turbo (best performance with ENI network)
  • Container network: eni for Turbo clusters
  • Naming format: --cluster (e.g., prod-web-cluster)

Node Pool Management

ToolFunctionRisk LevelRequires Confirmation
huawei_list_cce_nodepoolsList node pools🟢 LowNo
huawei_create_cce_nodepoolCreate node pool🟢 LowNo
huawei_delete_cce_nodepoolDelete node pool🟠 HighYes
huawei_resize_cce_nodepoolResize node pool🟡 MediumYes

Recommended defaults:

  • Naming format: --pool (e.g., prod-worker-pool)
  • Initial node count: 2 for HA, or 0 with autoscaling
  • Enable autoscaling for dynamic scaling

Node Management

ToolFunctionRisk LevelRequires Confirmation
huawei_list_cce_nodesList cluster nodes🟢 LowNo
huawei_create_cce_nodeCreate nodes directly🟢 LowNo
huawei_delete_cce_nodeDelete node🟠 HighYes
huawei_cce_node_cordonMark node unschedulable🟡 MediumYes
huawei_cce_node_uncordonMark node schedulable🟡 MediumYes
huawei_cce_node_drainEvict all pods from node🟠 HighYes
huawei_cce_node_statusQuery node scheduling status🟢 LowNo

Note: Prefer node pools for managed scaling. Direct node creation is for special cases.

Addon Management

ToolFunctionRisk LevelRequires Confirmation
huawei_list_cce_addonsList cluster addons🟢 LowNo
huawei_get_cce_addon_detailGet addon details🟢 LowNo
huawei_install_cce_addonInstall addon🟢 LowNo
huawei_uninstall_cce_addonUninstall addon🟠 HighYes
huawei_update_cce_addonUpdate addon🟡 MediumNo

Common addons:

  • coredns - DNS service
  • metrics-server - Monitoring metrics
  • everest - Storage driver

Network Prerequisites

ToolFunctionParameters
huawei_list_vpcList VPCs with CIDR inforegion
huawei_list_vpc_subnetsList subnets with AZ inforegion, vpc_id

Use these tools to find VPC/subnet IDs before cluster creation.


Supported Regions

Region CodeRegion Name
cn-north-4North China-Beijing 4
cn-north-1North China-Beijing 1
cn-north-2North China-Beijing 2
cn-east-3East China-Shanghai 1
cn-south-1South China-Guangzhou
cn-south-2South China-Guangzhou Friendly
cn-east-4East China II
cn-southwest-2Guiyang 1
ap-southeast-1Asia-Pacific-Hong Kong
ap-southeast-2Asia-Pacific-Bangkok
ap-southeast-3Asia-Pacific-Singapore

Output Format

All tools return JSON-formatted results containing:

  • status: operation result (success / error)
  • data: operation-specific response (cluster info, node list, addon details, etc.)
  • message: human-readable description of the result
  • warning: risk warning for dangerous operations (preview mode only)

Verification

See verification-method.md for detailed verification steps. Quick checklist:

  1. Verify AK/SK credentials are configured via environment variables
  2. Run huawei_list_cce_clusters to confirm API connectivity
  3. Test dangerous operation preview (call without confirm=true)
  4. Verify Turbo cluster ENI network configuration

Best Practices

  • Use environment variables (HW_ACCESS_KEY / HW_SECRET_KEY) for credentials — avoid hardcoding
  • Always preview dangerous operations before confirming with confirm=true
  • Use Turbo clusters (container_network_type=eni) for high-performance workloads
  • Resize node pools during low-traffic periods to minimize business impact
  • Keep node pools at ≥2 nodes for production workloads to ensure redundancy
  • Regularly check cluster health via huawei_list_cce_clusters and huawei_show_cce_cluster

References

DocumentDescription
task-cluster-management.mdCluster lifecycle operations
task-nodepool-management.mdNode pool operations
task-node-management.mdNode scheduling operations
iam-policies.mdIAM permission policies
verification-method.mdVerification steps
troubleshooting.mdTroubleshooting guide
cce-api-guide.mdCCE Python SDK API reference
cce-cluster-parameters.mdCluster/nodepool creation parameters

Notes

  • Ensure AK/SK has correct IAM permissions
  • Different regions may have different resource availability
  • All dangerous operations require confirmation
  • Deletion operations are irreversible
  • Hibernate cluster stops all workloads - use during non-business hours
  • Node drain evicts all pods - ensure sufficient replicas
  • Turbo clusters recommended for best performance with ENI network

Questions people ask

How are destructive operations guarded against accidental execution?
Calls without confirm=true return a preview that describes the action and its risk. The operation only runs when the caller explicitly passes confirm=true, so you can review the impact before anything changes.
Where are my Huawei Cloud credentials stored?
AK/SK are read from the HW_ACCESS_KEY and HW_SECRET_KEY environment variables and exist only for the duration of the API call. The skill does not save them, tokens, or certificates to disk, and never includes them in logs or error messages.
What does the IAM user need before I can run the skill?
Python 3.8+ with huaweicloudsdkcce and huaweicloudsdkcore installed, plus an IAM user that holds the cce:cluster, cce:node, cce:nodepool, and cce:addon list, get, create, update, and delete permissions listed in the skill documentation.

Related skills

Huawei Cloud CCE/UCS workload lifecycle management skill using hcloud CLI for kubeconfig acquisition and kubectl for Kubernetes resource operations. Use this...

3 installs1 stars

Query Huawei Cloud CCE (Cloud Container Engine) clusters and report their names, IDs, statuses, versions, and node information across a project. Use when listing CCE clusters, looking up a cluster name, showing cluster detail, or inspecting cluster status and nodes. Provides read-only inspection for daily operations, inventory reporting, and troubleshooting. Triggers include: CCE query, list CCE clusters, query CCE cluster names, CCE cluster inventory, show CCE cluster, list CCE nodes, check cluster status, CCE集群查询, 查询CCE集群, CCE集群名称, CCE集群列表, 查看CCE集群.

Manage Huawei Cloud CCI containers end-to-end via hcloud CLI: namespaces, networks, workloads, logs, with built-in safety checks.

by shijingcheng3 installs1 stars

Huawei Cloud CCE Node failure diagnosis skill using Python SDK dispatcher. Use this skill when the user wants to: (1) diagnose CCE node NotReady, node resour...

4 installs1 stars

Huawei Cloud CCE auto-remediation runner skill that converts remediation intent into preview-first, confirm-required, post-verify execution plans. Use this s...

5 installs1 stars

Query Huawei Cloud CCE Pod/Node metrics and ECS, ELB, EIP, NAT resource metrics with threshold-based anomaly detection.

by shijingcheng4 installs1 stars

More from shijingcheng

Browse all skills

Query Huawei Cloud CCE Pod/Node metrics and ECS, ELB, EIP, NAT resource metrics with threshold-based anomaly detection.

by shijingcheng4 installs1 stars

Automate cross-region image replication and trigger-based CCE/CCI deployments on Huawei Cloud SWR using hcloud CLI.

by shijingcheng3 installs1 stars

Manage Huawei Cloud SWR namespaces, image repositories, tags, docker login credentials, and quotas via the hcloud CLI.

by shijingcheng3 installs1 stars

Govern Huawei Cloud SWR image permissions, retention rules, shared domains, and agency delegation via hcloud CLI.

by shijingcheng3 installs1 stars

Manage Huawei Cloud CCI containers end-to-end via hcloud CLI: namespaces, networks, workloads, logs, with built-in safety checks.

by shijingcheng3 installs1 stars