huaweicloud-devkit 1.0.3-dev.0 → 1.0.3-next.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +18 -18
- package/README.md +99 -41
- package/README.zh-CN.md +99 -41
- package/bin/setup.cjs +5 -3
- package/integrations/opencode/opencode.json +1 -4
- package/package.json +61 -42
- package/plugins/huaweicloud-core/.claude-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.codex-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.cursor-plugin/plugin.json +4 -17
- package/plugins/huaweicloud-core/.hermes-plugin/plugin.json +30 -0
- package/plugins/huaweicloud-core/.mcp.json +2 -5
- package/plugins/huaweicloud-core/.workbuddy-plugin/plugin.json +4 -18
- package/plugins/huaweicloud-core/hooks/huaweicloud-safety.py +32 -9
- package/plugins/huaweicloud-core/openclaw.plugin.json +20 -0
- package/plugins/huaweicloud-core/safety/policy.json +75 -99
- package/plugins/huaweicloud-core/safety/rules/cloud-risk-rules.json +41 -13
- package/plugins/huaweicloud-core/skills/huawei-apig/SKILL.md +34 -34
- package/plugins/huaweicloud-core/skills/huawei-billing/SKILL.md +18 -18
- package/plugins/huaweicloud-core/skills/huawei-cbr/SKILL.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-cce/SKILL.md +34 -32
- package/plugins/huaweicloud-core/skills/huawei-cloud-eye/SKILL.md +30 -30
- package/plugins/huaweicloud-core/skills/huawei-cts/SKILL.md +20 -20
- package/plugins/huaweicloud-core/skills/huawei-dds-dcs/SKILL.md +31 -31
- package/plugins/huaweicloud-core/skills/huawei-deployment/SKILL.md +21 -20
- package/plugins/huaweicloud-core/skills/huawei-dew/SKILL.md +39 -30
- package/plugins/huaweicloud-core/skills/huawei-dew/references/csms-usage.md +8 -1
- package/plugins/huaweicloud-core/skills/huawei-dew/references/kms-usage.md +6 -0
- package/plugins/huaweicloud-core/skills/huawei-ecs/SKILL.md +39 -36
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/create-instance.md +15 -4
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/flavors.md +11 -9
- package/plugins/huaweicloud-core/skills/huawei-ecs/references/troubleshooting.md +13 -13
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/SKILL.md +40 -39
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/apig-event-format.md +12 -10
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/create-function.md +21 -20
- package/plugins/huaweicloud-core/skills/huawei-functiongraph/references/triggers.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-gaussdb/SKILL.md +20 -20
- package/plugins/huaweicloud-core/skills/huawei-getting-started/SKILL.md +27 -23
- package/plugins/huaweicloud-core/skills/huawei-iam/SKILL.md +27 -27
- package/plugins/huaweicloud-core/skills/huawei-iam/references/policy-examples.md +65 -39
- package/plugins/huaweicloud-core/skills/huawei-iam/references/quick-ref.md +9 -9
- package/plugins/huaweicloud-core/skills/huawei-modelarts/SKILL.md +33 -25
- package/plugins/huaweicloud-core/skills/huawei-obs/SKILL.md +51 -44
- package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-create.md +19 -19
- package/plugins/huaweicloud-core/skills/huawei-obs/references/bucket-lifecycle.md +12 -7
- package/plugins/huaweicloud-core/skills/huawei-obs/references/common-pitfalls.md +13 -12
- package/plugins/huaweicloud-core/skills/huawei-obs/references/single-file-share.md +4 -4
- package/plugins/huaweicloud-core/skills/huawei-rds/SKILL.md +63 -58
- package/plugins/huaweicloud-core/skills/huawei-sandbox/SKILL.md +128 -42
- package/plugins/huaweicloud-core/skills/huawei-smn-dms/SKILL.md +26 -26
- package/plugins/huaweicloud-core/skills/huawei-vpc/SKILL.md +39 -39
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/network.md +13 -12
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/security-group.md +20 -19
- package/plugins/huaweicloud-core/skills/huawei-vpc/references/subnet.md +15 -15
- package/plugins/huaweicloud-core/skills/huawei-waf-aad/SKILL.md +18 -18
- package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/SKILL.md +13 -13
- package/plugins/huaweicloud-core/skills/huaweicloud-api-and-sdk/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/SKILL.md +25 -2
- package/plugins/huaweicloud-core/skills/huaweicloud-capability-discovery/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md +27 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-core/SKILL.md +65 -47
- package/plugins/huaweicloud-core/skills/huaweicloud-core/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-core/references/report-issue.md +6 -6
- package/plugins/huaweicloud-core/skills/huaweicloud-core/references/select.md +15 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-safety/SKILL.md +0 -1
- package/plugins/huaweicloud-core/skills/huaweicloud-safety/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/SKILL.md +33 -33
- package/plugins/huaweicloud-core/skills/huaweicloud-troubleshooting/agents/openai.yaml +3 -3
- package/plugins/huaweicloud-core/src/auth/agent-registration.mjs +123 -2
- package/plugins/huaweicloud-core/src/auth/credentials.mjs +77 -4
- package/plugins/huaweicloud-core/src/auth/service.mjs +1 -1
- package/plugins/huaweicloud-core/src/data/icons-manifest.v1.json +3517 -0
- package/plugins/huaweicloud-core/src/hcloud-cli.mjs +25 -7
- package/plugins/huaweicloud-core/src/icon-library.mjs +171 -0
- package/plugins/huaweicloud-core/src/mcp-server.mjs +30 -3
- package/plugins/huaweicloud-core/src/proxy/proxy-agent.mjs +73 -0
- package/plugins/huaweicloud-core/src/proxy/proxy-config.mjs +94 -0
- package/plugins/huaweicloud-core/src/risk-rule-engine.mjs +4 -1
- package/plugins/huaweicloud-core/src/safety-policy.mjs +122 -68
- package/plugins/huaweicloud-core/src/sandbox/hdkitservice-api.mjs +14 -10
- package/plugins/huaweicloud-core/src/sandbox/hwlink-api.mjs +34 -27
- package/plugins/huaweicloud-core/src/sandbox/sandbox-file-server.py +45 -0
- package/plugins/huaweicloud-core/src/sandbox/session-manager.mjs +521 -8
- package/plugins/huaweicloud-core/src/search-market.mjs +53 -14
- package/plugins/huaweicloud-core/src/setup-cli.mjs +1741 -215
- package/plugins/huaweicloud-core/src/tools.mjs +667 -123
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-exec-client.js +72 -38
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-fair-queue.js +10 -5
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-multiplexer.js +12 -15
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-packet.js +12 -16
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-terminal-channel.js +46 -31
- package/plugins/huaweicloud-core/src/ws-exec/hwlink-tunnel-channel.mjs +267 -0
- package/plugins/huaweicloud-core/src/ws-exec/index.js +3 -0
- package/plugins/huaweicloud-core/src/ws-exec/ws-exec-client.js +9 -5
- package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/SKILL.md +0 -190
- package/plugins/huaweicloud-core/skills/huawei-cloud-find-skills/scripts/search-skills.mjs +0 -124
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-apig
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when creating or managing API Gateway (APIG). Covers API creation, throttling, auth (IAM/APP/basic), CORS, publishing, instance management. Triggers: APIG, API gateway, throttling, publish API. NOT for: FunctionGraph triggers (use huawei-functiongraph).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,16 +16,16 @@ Always discover parameters with `hcloud APIG <Operation> --help` before executin
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| API group region-locked
|
|
22
|
-
| Throttling per-API default
|
|
23
|
-
| CORS must be explicit
|
|
24
|
-
| `BASIC` spec has no public IP
|
|
25
|
-
| Instance creation takes 5-15min
|
|
26
|
-
| `sl_domain` is from API **Group** | NOT from Instance. Get it from `CreateApiGroupV2` or `ListApiGroupsV2` response
|
|
27
|
-
| API name must NOT have hyphens
|
|
28
|
-
| VPC params need prefix
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
|
21
|
+
| API group region-locked | Cannot move across regions |
|
|
22
|
+
| Throttling per-API default | Use app-level quotas for per-user limits |
|
|
23
|
+
| CORS must be explicit | OPTIONS preflight fails until configured |
|
|
24
|
+
| `BASIC` spec has no public IP | Use `PROFESSIONAL` + `elb` provider for public access |
|
|
25
|
+
| Instance creation takes 5-15min | Long-running async operation. State is **Running** (NOT "SUCCESS"). Poll with `ListInstancesV2`, wait for `status == "Running"` |
|
|
26
|
+
| `sl_domain` is from API **Group** | NOT from Instance. Get it from `CreateApiGroupV2` or `ListApiGroupsV2` response |
|
|
27
|
+
| API name must NOT have hyphens | `[a-zA-Z0-9_]+` only. Hyphens cause regex validation failure |
|
|
28
|
+
| VPC params need prefix | `--vpc.name=<n>` / `--subnet.vpc_id=<id>` / `--security_group.name=<n>` with KooCLI 7.x |
|
|
29
29
|
|
|
30
30
|
## Instance Management
|
|
31
31
|
|
|
@@ -43,14 +43,14 @@ hcloud APIG CreateInstanceV2 --help
|
|
|
43
43
|
|
|
44
44
|
Key gotchas when creating:
|
|
45
45
|
|
|
46
|
-
| Param
|
|
47
|
-
|
|
48
|
-
| `--spec_id`
|
|
49
|
-
| `--loadbalancer_provider` | `elb` for public access (supports `AddIngressEipV2`), `lvs` for internal only (supports `AddEipV2`)
|
|
50
|
-
| `--enterprise_project_id` | **Required** for enterprise accounts. Use `"0"` for default project
|
|
51
|
-
| `--available_zone_ids`
|
|
52
|
-
| `--vpc_id`, `--subnet_id` | Must exist in the target region
|
|
53
|
-
| `--security_group_id`
|
|
46
|
+
| Param | Note |
|
|
47
|
+
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
|
|
48
|
+
| `--spec_id` | `BASIC` (no public access), `PROFESSIONAL` (requires `--loadbalancer_provider`) |
|
|
49
|
+
| `--loadbalancer_provider` | `elb` for public access (supports `AddIngressEipV2`), `lvs` for internal only (supports `AddEipV2`) |
|
|
50
|
+
| `--enterprise_project_id` | **Required** for enterprise accounts. Use `"0"` for default project |
|
|
51
|
+
| `--available_zone_ids` | Use AZ code like `ap-southeast-3a`, NOT UUID from `ListAvailableZonesV2` |
|
|
52
|
+
| `--vpc_id`, `--subnet_id` | Must exist in the target region |
|
|
53
|
+
| `--security_group_id` | **Required**. Create a security group first via `VPC CreateSecurityGroup` (VPC v3 API — no `vpc_id` param needed) |
|
|
54
54
|
|
|
55
55
|
### Add Public Access (ELB Provider Only)
|
|
56
56
|
|
|
@@ -89,9 +89,9 @@ Wait for `eip_address` to show a valid IP (may take up to 2 minutes). If `eip_ad
|
|
|
89
89
|
hcloud APIG CreateApiGroupV2 --instance_id=<id> --name=<n>
|
|
90
90
|
```
|
|
91
91
|
|
|
92
|
-
| Param
|
|
93
|
-
|
|
94
|
-
| `--name`
|
|
92
|
+
| Param | Note |
|
|
93
|
+
| ---------- | ---------------------- |
|
|
94
|
+
| `--name` | Group name (required) |
|
|
95
95
|
| `--remark` | Description (optional) |
|
|
96
96
|
|
|
97
97
|
## API Management
|
|
@@ -120,18 +120,18 @@ hcloud APIG CreateThrottlingPolicyV2 --name=<n> --api_call_limits=1000
|
|
|
120
120
|
|
|
121
121
|
## Common Workflows
|
|
122
122
|
|
|
123
|
-
| Task
|
|
124
|
-
|
|
125
|
-
| List instances
|
|
126
|
-
| Create instance
|
|
127
|
-
| Delete instance
|
|
128
|
-
| Add public EIP
|
|
129
|
-
| Create API group | `CreateApiGroupV2`
|
|
130
|
-
| Create API
|
|
131
|
-
| Update API
|
|
132
|
-
| List APIs
|
|
133
|
-
| Publish
|
|
134
|
-
| List APIs
|
|
123
|
+
| Task | Operation |
|
|
124
|
+
| ---------------- | -------------------------------------------- |
|
|
125
|
+
| List instances | `ListInstancesV2` |
|
|
126
|
+
| Create instance | `CreateInstanceV2` |
|
|
127
|
+
| Delete instance | `DeleteInstancesV2` |
|
|
128
|
+
| Add public EIP | `AddIngressEipV2` |
|
|
129
|
+
| Create API group | `CreateApiGroupV2` |
|
|
130
|
+
| Create API | `CreateApiV2` |
|
|
131
|
+
| Update API | `UpdateApiV2` — change auth mode, path, etc. |
|
|
132
|
+
| List APIs | `ListApisV2` |
|
|
133
|
+
| Publish | `BatchPublishOrOfflineApiV2` |
|
|
134
|
+
| List APIs | `ListApisV2` |
|
|
135
135
|
|
|
136
136
|
## FunctionGraph Integration
|
|
137
137
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-billing
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when querying bills, costs, resource usage, or billing details on Huawei Cloud (BSS). Triggers: billing, BSS, cost, bill, expense, usage report, resource usage, budget. NOT for: resource management (use huawei-ecs etc.), creating resources.'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,32 +16,32 @@ Domain expertise for billing queries (BSS). Covers cost tracking, bill details,
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| Bills delayed ~24h
|
|
22
|
-
| BSS Admin role needed
|
|
23
|
-
| Currency conversion varies | Cross-region costs use daily exchange rates
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| -------------------------- | ---------------------------------------------------- |
|
|
21
|
+
| Bills delayed ~24h | Yesterday's costs may not appear until the next day |
|
|
22
|
+
| BSS Admin role needed | IAM user must have BSS Administrator or Finance role |
|
|
23
|
+
| Currency conversion varies | Cross-region costs use daily exchange rates |
|
|
24
24
|
|
|
25
25
|
## Common Workflows
|
|
26
26
|
|
|
27
|
-
| Task
|
|
28
|
-
|
|
29
|
-
| List costs
|
|
30
|
-
| List customer bills
|
|
31
|
-
| List resource usage
|
|
32
|
-
| List sub-customers
|
|
27
|
+
| Task | Operation |
|
|
28
|
+
| -------------------- | --------------------------------------------------------------- |
|
|
29
|
+
| List costs | `ListCosts --cli-region=<r> --project_id=<p>` |
|
|
30
|
+
| List customer bills | `ListCustomerBills --cli-region=<r> --project_id=<p>` |
|
|
31
|
+
| List resource usage | `ListResourceUsage --cli-region=<r> --project_id=<p>` |
|
|
32
|
+
| List sub-customers | `ListConsumeSubCustomers --cli-region=<r> --project_id=<p>` |
|
|
33
33
|
| Show account balance | `ShowCustomerAccountBalances --cli-region=<r> --project_id=<p>` |
|
|
34
|
-
| List conversions
|
|
34
|
+
| List conversions | `ListConversions --cli-region=<r> --project_id=<p>` |
|
|
35
35
|
|
|
36
36
|
Discover exact parameters with `--help` before executing any command. All BSS operations are read-only.
|
|
37
37
|
|
|
38
38
|
## Troubleshooting
|
|
39
39
|
|
|
40
|
-
| Error
|
|
41
|
-
|
|
42
|
-
| Access denied
|
|
43
|
-
| No data returned
|
|
44
|
-
| Enterprise account restrictions | Some APIs require enterprise real-name authentication
|
|
40
|
+
| Error | Fix |
|
|
41
|
+
| ------------------------------- | ----------------------------------------------------------- |
|
|
42
|
+
| Access denied | User needs BSS Administrator or Finance role |
|
|
43
|
+
| No data returned | Check time range (bills have ~24h delay). Verify project_id |
|
|
44
|
+
| Enterprise account restrictions | Some APIs require enterprise real-name authentication |
|
|
45
45
|
|
|
46
46
|
## Cross-Skill References
|
|
47
47
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-cbr
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when creating or managing Cloud Backup and Recovery (CBR) vaults, backups, and restore operations on Huawei Cloud. Triggers: CBR, backup, restore, vault, snapshot, disaster recovery. NOT for: OBS object versioning (use huawei-obs), RDS automated backups (use huawei-rds).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,33 +16,33 @@ Domain expertise for Cloud Backup and Recovery. Covers vaults, backups, restore
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| Vault binds single resource type | Server vault != disk vault != file system vault
|
|
22
|
-
| Restore needs instance stop
|
|
23
|
-
| Backup storage incurs charges
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| -------------------------------- | ---------------------------------------------------------------- |
|
|
21
|
+
| Vault binds single resource type | Server vault != disk vault != file system vault |
|
|
22
|
+
| Restore needs instance stop | Most VM restore requires the target instance to be stopped first |
|
|
23
|
+
| Backup storage incurs charges | Retention policies affect storage costs |
|
|
24
24
|
|
|
25
25
|
## Common Workflows
|
|
26
26
|
|
|
27
|
-
| Task
|
|
28
|
-
|
|
29
|
-
| List vaults
|
|
30
|
-
| Create vault
|
|
31
|
-
| Create backup policy
|
|
32
|
-
| Create checkpoint
|
|
33
|
-
| Add resource to vault
|
|
34
|
-
| Batch update vault
|
|
27
|
+
| Task | Operation |
|
|
28
|
+
| -------------------------- | ------------------------------------------------------------ |
|
|
29
|
+
| List vaults | `ListVaults --cli-region=<r> --project_id=<p>` |
|
|
30
|
+
| Create vault | `CreateVault --cli-region=<r> --project_id=<p>` |
|
|
31
|
+
| Create backup policy | `CreatePolicy --cli-region=<r> --project_id=<p>` |
|
|
32
|
+
| Create checkpoint | `CreateCheckpoint --cli-region=<r> --project_id=<p>` |
|
|
33
|
+
| Add resource to vault | `AddVaultResource --cli-region=<r> --project_id=<p>` |
|
|
34
|
+
| Batch update vault | `BatchUpdateVault --cli-region=<r> --project_id=<p>` |
|
|
35
35
|
| Create organization policy | `CreateOrganizationPolicy --cli-region=<r> --project_id=<p>` |
|
|
36
36
|
|
|
37
37
|
Discover exact parameters with `--help` before executing any command.
|
|
38
38
|
|
|
39
39
|
## Troubleshooting
|
|
40
40
|
|
|
41
|
-
| Error
|
|
42
|
-
|
|
43
|
-
| Backup creation fails | Check instance is running and agent is online
|
|
44
|
-
| Restore fails
|
|
45
|
-
| Vault full
|
|
41
|
+
| Error | Fix |
|
|
42
|
+
| --------------------- | -------------------------------------------------- |
|
|
43
|
+
| Backup creation fails | Check instance is running and agent is online |
|
|
44
|
+
| Restore fails | Ensure target instance is stopped before restore |
|
|
45
|
+
| Vault full | Increase vault capacity or adjust retention policy |
|
|
46
46
|
|
|
47
47
|
## Cross-Skill References
|
|
48
48
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-cce
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when creating or managing CCE Kubernetes clusters. Covers cluster creation, node pools, SWR registry, autoscaling. Triggers: CCE, Kubernetes, K8s, cluster, node pool, container, SWR. NOT for: serverless functions (use huawei-functiongraph), serverless containers (use huawei-cce for CCI redirect).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,32 +16,33 @@ Domain expertise for CCE (Cloud Container Engine) and SWR (Software Repository f
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| **
|
|
22
|
-
|
|
|
23
|
-
|
|
|
24
|
-
|
|
|
25
|
-
|
|
|
26
|
-
|
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
21
|
+
| **Huawei Cloud API returns errors one field at a time** | When creating clusters/services with multiple invalid fields, the API reports only the first error, not all errors at once. After fixing one field and resubmitting, the next call reveals the next error — iterating N times for N bad fields. This compounds with long cluster creation times (~10 min). To avoid this loop, run `hcloud CCE <Operation> --help` and validate every parameter with its constraints before the first call. Use `--cli-jsonInput` with a validated JSON file to reduce reformatting overhead between retries. |
|
|
22
|
+
| **KooCLI 7.x: CreateCluster/CreateNodePool broken** | OPENAPI_ERROR in KooCLI 7.2.12. Use `CreateAutopilotCluster` for serverless, or Python SDK for VM clusters |
|
|
23
|
+
| Cluster type immutable | Cannot change hybrid/traditional after creation |
|
|
24
|
+
| Master managed by Huawei | No SSH to master. Use kubectl or kubectl-cce |
|
|
25
|
+
| Network model affects pod IP | VPC network gives pods VPC IPs |
|
|
26
|
+
| Addon ops use UID not name | `ShowAddonInstance` returns `metadata.uid` for install/uninstall/update |
|
|
27
|
+
| SWR enterprise instance costs | `postPaid` billing. One-time activation at console required |
|
|
27
28
|
|
|
28
29
|
## Common Workflows
|
|
29
30
|
|
|
30
|
-
| Task
|
|
31
|
-
|
|
32
|
-
| List clusters
|
|
33
|
-
| Create cluster
|
|
34
|
-
| Delete cluster
|
|
35
|
-
| Hibernate cluster
|
|
36
|
-
| List node pools
|
|
37
|
-
| Create node pool
|
|
38
|
-
| List nodes
|
|
39
|
-
| Get kubeconfig
|
|
40
|
-
| List addons
|
|
41
|
-
| Docker login (SWR) | `CreateAuthorizationToken`
|
|
42
|
-
| Create SWR org
|
|
43
|
-
| Create SWR repo
|
|
44
|
-
| List repos
|
|
31
|
+
| Task | Operation | Service |
|
|
32
|
+
| ------------------ | ----------------------------- | ------- |
|
|
33
|
+
| List clusters | `ListClusters` | CCE |
|
|
34
|
+
| Create cluster | `CreateCluster` | CCE |
|
|
35
|
+
| Delete cluster | `DeleteCluster` | CCE |
|
|
36
|
+
| Hibernate cluster | `HibernateCluster` | CCE |
|
|
37
|
+
| List node pools | `ListNodePools` | CCE |
|
|
38
|
+
| Create node pool | `CreateNodePool` | CCE |
|
|
39
|
+
| List nodes | `ListNodes` | CCE |
|
|
40
|
+
| Get kubeconfig | `CreateKubernetesClusterCert` | CCE |
|
|
41
|
+
| List addons | `ListAddonInstances` | CCE |
|
|
42
|
+
| Docker login (SWR) | `CreateAuthorizationToken` | SWR |
|
|
43
|
+
| Create SWR org | `CreateNamespace` | SWR |
|
|
44
|
+
| Create SWR repo | `CreateRepo` | SWR |
|
|
45
|
+
| List repos | `ListReposDetails` | SWR |
|
|
45
46
|
|
|
46
47
|
## SWR Image Push Workflow
|
|
47
48
|
|
|
@@ -75,14 +76,15 @@ See `hcloud CCI --help` for full operation list.
|
|
|
75
76
|
|
|
76
77
|
## Troubleshooting
|
|
77
78
|
|
|
78
|
-
| Error
|
|
79
|
-
|
|
80
|
-
| kubectl connection refused
|
|
81
|
-
| Node pool creation failed
|
|
82
|
-
| Docker push 401
|
|
83
|
-
| SVCSTG.SWR.4030170
|
|
84
|
-
| Addon install fails
|
|
85
|
-
| `kubectl cce` not found
|
|
79
|
+
| Error | Fix |
|
|
80
|
+
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
81
|
+
| kubectl connection refused | Verify cluster Running; use `kubectl cce` (no EIP needed) |
|
|
82
|
+
| Node pool creation failed | Check VPC/subnet availability and flavor capacity |
|
|
83
|
+
| Docker push 401 | Re-run `CreateAuthorizationToken` (token expired) |
|
|
84
|
+
| SVCSTG.SWR.4030170 | Missing `sts::createServiceBearerToken` IAM permission. Grant SWR Admin role or add policy |
|
|
85
|
+
| Addon install fails | Use `metadata.uid` from `ShowAddonInstance`, not name |
|
|
86
|
+
| `kubectl cce` not found | Install plugin: `kubectl cce` uses AK/SK, no kubeconfig required |
|
|
87
|
+
| Serial field-by-field API errors | The API reports errors one field at a time. Fix a field, retry, get the next error — each cycle ~10 min for cluster operations. Mitigation: validate all parameters against `--help` constraints before the first call; use `--cli-jsonInput` for faster retries. |
|
|
86
88
|
|
|
87
89
|
## Security Considerations
|
|
88
90
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-cloud-eye
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when setting up monitoring, alarms, dashboards, or event rules on Huawei Cloud Eye (CES). Triggers: Cloud Eye, CES, monitoring, alarm, metrics, dashboard, event monitoring. NOT for: CTS audit logs (use huawei-cts), AAD anti-DDoS (use huawei-waf-aad).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,13 +16,13 @@ Domain expertise for Cloud Eye (CES). Covers metric queries, alarm rules, dashbo
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| Telescope agent required for detailed metrics | Without agent: only basic CPU/network metrics. Memory, disk require agent installation on ECS
|
|
22
|
-
| Alarm needs SMN topic first
|
|
23
|
-
| Cost metrics incur charges
|
|
24
|
-
| CES endpoint may vary by region
|
|
25
|
-
| Metric granularity minimum 300s
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
|
21
|
+
| Telescope agent required for detailed metrics | Without agent: only basic CPU/network metrics. Memory, disk require agent installation on ECS |
|
|
22
|
+
| Alarm needs SMN topic first | Alarm notifications fail silently without a configured SMN topic |
|
|
23
|
+
| Cost metrics incur charges | Custom metrics and high-frequency alarms have billing implications |
|
|
24
|
+
| CES endpoint may vary by region | Some older regions use different endpoint URLs. Check `https://developer.huaweicloud.com/endpoint?CES` |
|
|
25
|
+
| Metric granularity minimum 300s | Free tier has 5-minute minimum. Higher resolution requires paid tier |
|
|
26
26
|
|
|
27
27
|
## Prerequisites
|
|
28
28
|
|
|
@@ -32,15 +32,15 @@ Domain expertise for Cloud Eye (CES). Covers metric queries, alarm rules, dashbo
|
|
|
32
32
|
|
|
33
33
|
## Common Workflows
|
|
34
34
|
|
|
35
|
-
| Task
|
|
36
|
-
|
|
37
|
-
| List metrics
|
|
38
|
-
| Get metric data
|
|
39
|
-
| List alarms
|
|
40
|
-
| Create alarm
|
|
41
|
-
| Delete alarm
|
|
42
|
-
| List dashboards
|
|
43
|
-
| Create dashboard | `CreateDashboard --cli-region=<r> --project_id=<p>`
|
|
35
|
+
| Task | Operation |
|
|
36
|
+
| ---------------- | --------------------------------------------------------- |
|
|
37
|
+
| List metrics | `ListMetrics --cli-region=<r> --project_id=<p>` |
|
|
38
|
+
| Get metric data | `BatchListMetricData --cli-region=<r> --project_id=<p>` |
|
|
39
|
+
| List alarms | `ListAlarms --cli-region=<r> --project_id=<p>` |
|
|
40
|
+
| Create alarm | `CreateAlarm` (see below) |
|
|
41
|
+
| Delete alarm | `BatchDeleteAlarmRules --cli-region=<r> --project_id=<p>` |
|
|
42
|
+
| List dashboards | `ListDashboardWidgets --cli-region=<r> --project_id=<p>` |
|
|
43
|
+
| Create dashboard | `CreateDashboard --cli-region=<r> --project_id=<p>` |
|
|
44
44
|
|
|
45
45
|
## Create Alarm Rule — Param Structure
|
|
46
46
|
|
|
@@ -57,14 +57,14 @@ hcloud CES CreateAlarm --help
|
|
|
57
57
|
|
|
58
58
|
For metric alarms use **symbols** (NOT words like `gt`/`lt`):
|
|
59
59
|
|
|
60
|
-
| Value | Meaning
|
|
61
|
-
|
|
62
|
-
| `>`
|
|
63
|
-
| `>=`
|
|
64
|
-
| `<`
|
|
65
|
-
| `<=`
|
|
66
|
-
| `=`
|
|
67
|
-
| `!=`
|
|
60
|
+
| Value | Meaning |
|
|
61
|
+
| ----- | --------------------- |
|
|
62
|
+
| `>` | Greater than |
|
|
63
|
+
| `>=` | Greater than or equal |
|
|
64
|
+
| `<` | Less than |
|
|
65
|
+
| `<=` | Less than or equal |
|
|
66
|
+
| `=` | Equal |
|
|
67
|
+
| `!=` | Not equal |
|
|
68
68
|
|
|
69
69
|
For event alarms: `cycle_decrease`, `cycle_increase`, `cycle_wave`.
|
|
70
70
|
|
|
@@ -72,11 +72,11 @@ For event alarms: `cycle_decrease`, `cycle_increase`, `cycle_wave`.
|
|
|
72
72
|
|
|
73
73
|
## Troubleshooting
|
|
74
74
|
|
|
75
|
-
| Error
|
|
76
|
-
|
|
77
|
-
| No metric data
|
|
78
|
-
| Alarm not triggering
|
|
79
|
-
| CES network timeout in region | Some regions may have CES endpoint issues. Try a different region
|
|
75
|
+
| Error | Fix |
|
|
76
|
+
| ----------------------------- | -------------------------------------------------------------------------------- |
|
|
77
|
+
| No metric data | Telescope agent not installed or ECS stopped. Install agent for detailed metrics |
|
|
78
|
+
| Alarm not triggering | Check metric period (minimum 300s), verify condition threshold |
|
|
79
|
+
| CES network timeout in region | Some regions may have CES endpoint issues. Try a different region |
|
|
80
80
|
|
|
81
81
|
## Security
|
|
82
82
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-cts
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when managing Cloud Trace Service (CTS) audit logs, trackers, and traces on Huawei Cloud. Triggers: CTS, Cloud Trace, audit log, tracker, trace, operation record. NOT for: CES monitoring alarms (use huawei-cloud-eye), log analysis (use LTS).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -16,34 +16,34 @@ Domain expertise for Cloud Trace Service. Covers trackers, traces, notifications
|
|
|
16
16
|
|
|
17
17
|
## Critical Warnings
|
|
18
18
|
|
|
19
|
-
| Trap
|
|
20
|
-
|
|
21
|
-
| Tracker required for traces | Must create a tracker before traces are recorded
|
|
22
|
-
| OBS bucket prerequisite
|
|
23
|
-
| 7-day retention default
|
|
24
|
-
| Organization tracker
|
|
19
|
+
| Trap | Why |
|
|
20
|
+
| --------------------------- | ------------------------------------------------------------------------------ |
|
|
21
|
+
| Tracker required for traces | Must create a tracker before traces are recorded |
|
|
22
|
+
| OBS bucket prerequisite | Tracker needs an OBS bucket for log delivery |
|
|
23
|
+
| 7-day retention default | Trace data retained 7 days by default. Create LTS tracker for longer retention |
|
|
24
|
+
| Organization tracker | Cross-account auditing requires organization tracker |
|
|
25
25
|
|
|
26
26
|
## Common Workflows
|
|
27
27
|
|
|
28
|
-
| Task
|
|
29
|
-
|
|
30
|
-
| List operations
|
|
31
|
-
| List traces
|
|
32
|
-
| Create tracker
|
|
33
|
-
| List trackers
|
|
34
|
-
| Delete tracker
|
|
35
|
-
| Create notification
|
|
36
|
-
| List notifications
|
|
28
|
+
| Task | Operation |
|
|
29
|
+
| -------------------- | ------------------------------------------------------ |
|
|
30
|
+
| List operations | `ListOperations --cli-region=<r> --project_id=<p>` |
|
|
31
|
+
| List traces | `ListTraces --cli-region=<r> --project_id=<p>` |
|
|
32
|
+
| Create tracker | `CreateTracker --cli-region=<r> --project_id=<p>` |
|
|
33
|
+
| List trackers | `ListTrackers --cli-region=<r> --project_id=<p>` |
|
|
34
|
+
| Delete tracker | `DeleteTracker --cli-region=<r> --project_id=<p>` |
|
|
35
|
+
| Create notification | `CreateNotification --cli-region=<r> --project_id=<p>` |
|
|
36
|
+
| List notifications | `ListNotifications --cli-region=<r> --project_id=<p>` |
|
|
37
37
|
| List trace resources | `ListTraceResources --cli-region=<r> --project_id=<p>` |
|
|
38
38
|
|
|
39
39
|
Discover exact parameters with `--help` before executing any command.
|
|
40
40
|
|
|
41
41
|
## Troubleshooting
|
|
42
42
|
|
|
43
|
-
| Error
|
|
44
|
-
|
|
45
|
-
| No traces found
|
|
46
|
-
| Tracker creation fails | Ensure OBS bucket exists and has correct permissions
|
|
43
|
+
| Error | Fix |
|
|
44
|
+
| ---------------------- | ---------------------------------------------------------- |
|
|
45
|
+
| No traces found | Check tracker is created and enabled. Filter by time range |
|
|
46
|
+
| Tracker creation fails | Ensure OBS bucket exists and has correct permissions |
|
|
47
47
|
|
|
48
48
|
## Security
|
|
49
49
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: huawei-dds-dcs
|
|
3
|
-
description:
|
|
3
|
+
description: 'Use when creating or managing Document Database Service (DDS/MongoDB-compatible) or Distributed Cache Service (DCS/Redis/Memcached) on Huawei Cloud. Triggers: DDS, DCS, MongoDB, Redis, Memcached, document DB, cache, replica set, sharding. NOT for: RDS (use huawei-rds), GaussDB (use huawei-gaussdb).'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -14,22 +14,22 @@ Always run `hcloud DDS <Operation> --help` or `hcloud DCS <Operation> --help` be
|
|
|
14
14
|
|
|
15
15
|
## DDS Critical Warnings
|
|
16
16
|
|
|
17
|
-
| Trap
|
|
18
|
-
|
|
19
|
-
| Requires 3-node replica
|
|
20
|
-
| Shard key permanent
|
|
21
|
-
| Storage auto-scaling off | Enable before storage fills
|
|
17
|
+
| Trap | Why |
|
|
18
|
+
| ------------------------ | ------------------------------------------- |
|
|
19
|
+
| Requires 3-node replica | Minimum production deployment needs 3 nodes |
|
|
20
|
+
| Shard key permanent | Once selected, shard key cannot be changed |
|
|
21
|
+
| Storage auto-scaling off | Enable before storage fills |
|
|
22
22
|
|
|
23
23
|
### Common Workflows
|
|
24
24
|
|
|
25
|
-
| Task
|
|
26
|
-
|
|
27
|
-
| List instances
|
|
28
|
-
| Create instance
|
|
29
|
-
| Delete instance
|
|
25
|
+
| Task | Operation |
|
|
26
|
+
| ----------------- | --------------------------------------------------- |
|
|
27
|
+
| List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
|
|
28
|
+
| Create instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
|
|
29
|
+
| Delete instance | `DeleteInstance --cli-region=<r> --project_id=<p>` |
|
|
30
30
|
| Add readonly node | `AddReadonlyNode --cli-region=<r> --project_id=<p>` |
|
|
31
|
-
| Add shard
|
|
32
|
-
| Create backup
|
|
31
|
+
| Add shard | `AddShardingNode --cli-region=<r> --project_id=<p>` |
|
|
32
|
+
| Create backup | `CreateBackup --cli-region=<r> --project_id=<p>` |
|
|
33
33
|
|
|
34
34
|
Discover exact parameters with `--help` before executing any command.
|
|
35
35
|
|
|
@@ -37,32 +37,32 @@ Discover exact parameters with `--help` before executing any command.
|
|
|
37
37
|
|
|
38
38
|
## DCS Critical Warnings
|
|
39
39
|
|
|
40
|
-
| Trap
|
|
41
|
-
|
|
42
|
-
| Redis password required | Cannot create Redis instance without password
|
|
43
|
-
| Memcached no password
|
|
44
|
-
| Cache persistence costs | AOF/RDB persistence uses additional storage
|
|
40
|
+
| Trap | Why |
|
|
41
|
+
| ----------------------- | -------------------------------------------------- |
|
|
42
|
+
| Redis password required | Cannot create Redis instance without password |
|
|
43
|
+
| Memcached no password | Memcached has no auth — only accessible within VPC |
|
|
44
|
+
| Cache persistence costs | AOF/RDB persistence uses additional storage |
|
|
45
45
|
|
|
46
46
|
### Common Workflows
|
|
47
47
|
|
|
48
|
-
| Task
|
|
49
|
-
|
|
50
|
-
| List instances
|
|
51
|
-
| Create Redis instance
|
|
52
|
-
| Delete instance
|
|
53
|
-
| Restart instance
|
|
54
|
-
| Show node information
|
|
55
|
-
| Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>`
|
|
48
|
+
| Task | Operation |
|
|
49
|
+
| ---------------------- | ------------------------------------------------------------- |
|
|
50
|
+
| List instances | `ListInstances --cli-region=<r> --project_id=<p>` |
|
|
51
|
+
| Create Redis instance | `CreateInstance --cli-region=<r> --project_id=<p>` |
|
|
52
|
+
| Delete instance | `DeleteInstances --cli-region=<r> --project_id=<p>` |
|
|
53
|
+
| Restart instance | `RestartInstance --cli-region=<r> --project_id=<p>` |
|
|
54
|
+
| Show node information | `BatchShowNodesInformation --cli-region=<r> --project_id=<p>` |
|
|
55
|
+
| Create custom template | `CreateCustomTemplate --cli-region=<r> --project_id=<p>` |
|
|
56
56
|
|
|
57
57
|
Discover exact parameters with `--help` before executing any command.
|
|
58
58
|
|
|
59
59
|
## Troubleshooting
|
|
60
60
|
|
|
61
|
-
| Error
|
|
62
|
-
|
|
63
|
-
| DDS instance creation fails | Check 3-node minimum, VPC/subnet availability
|
|
64
|
-
| DCS connection refused
|
|
65
|
-
| DCS auto-expire not working | Enable auto-expire scan task for Redis
|
|
61
|
+
| Error | Fix |
|
|
62
|
+
| --------------------------- | ------------------------------------------------------------------- |
|
|
63
|
+
| DDS instance creation fails | Check 3-node minimum, VPC/subnet availability |
|
|
64
|
+
| DCS connection refused | Redis instances need password. Memcached only accessible within VPC |
|
|
65
|
+
| DCS auto-expire not working | Enable auto-expire scan task for Redis |
|
|
66
66
|
|
|
67
67
|
## Cross-Skill References
|
|
68
68
|
|