mcpField
A
aliyun-dns-cli

aliyun-dns-cli

github.com/cinienceCloud & DevOps39662 installsUpdated 11w ago
Repository

About aliyun-dns-cli

A skill for querying and managing Alibaba Cloud DNS records with aliyun-cli, including CNAME setup for Function Compute custom domains. It describes credential setup, record commands, and a verify-after-change workflow.

Key features

  1. 01Query DNS records
  2. 02Add CNAME records
  3. 03Configure FC custom-domain targets
  4. 04Set up aliyun-cli credentials
  5. 05Verify changes and save evidence

Use cases

  1. 01Inspect records for a subdomain
  2. 02Add a DNS CNAME record
  3. 03Point an FC custom domain to its target
  4. 04Check connectivity before DNS changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-dns-cli

After installing, type/aliyun-dns-cliin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/sources.md

Details

From the project README

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)

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

~/.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:

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

Add CNAME Record

~/.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

Validation

mkdir -p output/aliyun-dns-cli
echo "validation_placeholder" > output/aliyun-dns-cli/validate.txt

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

Output And Evidence

  • Save artifacts, command outputs, and API response summaries under output/aliyun-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: ALIBABACLOUD_ACCESS_KEY_ID, ALIBABACLOUD_ACCESS_KEY_SECRET, optional ALIBABACLOUD_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.

Comments

Markdown supported