alicloud-network-dns-cli

Original source / Raw SKILL.md

---
name: alicloud-network-dns-cli
description: Alibaba Cloud DNS (Alidns) CLI skill. Use to query, add, and update DNS records via aliyun-cli, including CNAME setup for Function Compute custom domains.
version: 1.0.0
---

Category: tool

# Alibaba Cloud DNS (Alidns) CLI

## Goals

- Query and manage Alibaba Cloud DNS records via `aliyun-cli`.
- Quickly configure CNAME for Function Compute custom domains.

## When to Use

- When you need to add/update DNS records in Alibaba Cloud DNS.
- When you need CNAME setup for FC custom domains.

## Install aliyun-cli (without sudo)

```bash
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o /tmp/aliyun-cli.tgz
mkdir -p ~/.local/bin
 tar -xzf /tmp/aliyun-cli.tgz -C /tmp
mv /tmp/aliyun ~/.local/bin/aliyun
chmod +x ~/.local/bin/aliyun
```

## Configure Credentials

```bash
~/.local/bin/aliyun configure set \
  --profile default \
  --access-key-id <AK> \
  --access-key-secret <SK> \
  --region cn-hangzhou
```

Configure region as default; if best region is unclear, ask the user.

## Query DNS Records

Query subdomain records:

```bash
~/.local/bin/aliyun alidns DescribeSubDomainRecords \
  --SubDomain news.example.com
```

## Add CNAME Record

```bash
~/.local/bin/aliyun alidns AddDomainRecord \
  --DomainName example.com \
  --RR news \
  --Type CNAME \
  --Value <TARGET>
```

## FC Custom Domain CNAME Target

Custom domain should point to FC public CNAME:

```
<account_id>.<region_id>.fc.aliyuncs.com
```

Example (Hangzhou):

```
1629965279769872.cn-hangzhou.fc.aliyuncs.com
```

## Common Issues

- If apex CNAME is not supported, use subdomain like `www` or ALIAS/ANAME records.
- Create FC custom domain only after DNS propagation, otherwise `DomainNameNotResolved` may occur.

## References

- aliyun-cli installation
  - https://help.aliyun.com/zh/cli/install-cli-on-linux
- Alidns API（AddDomainRecord / DescribeSubDomainRecords）
  - https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-adddomainrecord
  - https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-describesubdomainrecords
- FC custom domain configuration and CNAME guidance
  - https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/configure-custom-domain-names

- Official source list:`references/sources.md`

## Validation

```bash
mkdir -p output/alicloud-network-dns-cli
echo "validation_placeholder" > output/alicloud-network-dns-cli/validate.txt
```

Pass criteria: command exits 0 and `output/alicloud-network-dns-cli/validate.txt` is generated.

## Output And Evidence

- Save artifacts, command outputs, and API response summaries under `output/alicloud-network-dns-cli/`.
- Include key parameters (region/resource id/time range) in evidence files for reproducibility.

## Prerequisites

- Configure least-privilege Alibaba Cloud credentials before execution.
- Prefer environment variables: `ALICLOUD_ACCESS_KEY_ID`, `ALICLOUD_ACCESS_KEY_SECRET`, optional `ALICLOUD_REGION_ID`.
- If region is unclear, ask the user before running mutating operations.

## Workflow

1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
2) Run one minimal read-only query first to verify connectivity and permissions.
3) Execute the target operation with explicit parameters and bounded scope.
4) Verify results and save output/evidence files.



---

## Referenced Files

> The following files are referenced in this skill and included for context.

### references/sources.md

```markdown
官方文档来源（用于后续更新）
============================

- https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz
- https://help.aliyun.com/zh/cli/install-cli-on-linux
- https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-adddomainrecord
- https://help.aliyun.com/zh/dns/api-alidns-2015-01-09-describesubdomainrecords
- https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/configure-custom-domain-names

```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "cinience",
  "slug": "alicloud-network-dns-cli",
  "displayName": "Alicloud Network Dns Cli",
  "latest": {
    "version": "1.0.2",
    "publishedAt": 1773221981085,
    "commit": "https://github.com/openclaw/skills/commit/c2ed991a32f9ee39787970e4c9c5a77cd7329d6c"
  },
  "history": [
    {
      "version": "1.0.1",
      "publishedAt": 1770768560045,
      "commit": "https://github.com/openclaw/skills/commit/620e1d1124fbfbff1e14c384b4d54b44a0b8b8bf"
    }
  ]
}

```