aliyun-dns-cli

Category: tool

Alibaba Cloud DNS（Alidns）CLI

目標

• aliyun-cli を使って Alibaba Cloud DNS のレコードを照会、管理します。
• Function Compute のカスタムドメイン向けに CNAME をすばやく設定します。

使用する場面

• Alibaba Cloud DNS の DNS レコードを追加、更新する必要がある場合。
• FC のカスタムドメインに CNAME を設定する必要がある場合。

aliyun-cli のインストール（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

認証情報の設定

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

リージョンをデフォルトとして設定します。最適なリージョンが不明な場合は、ユーザーに確認してください。

DNS レコードの照会

サブドメインのレコードを照会します。

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

CNAME レコードの追加

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

FC カスタムドメインの CNAME 参照先

カスタムドメインは、FC のパブリック CNAME を参照する必要があります。

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

例（杭州）：

1629965279769872.cn-hangzhou.fc.aliyuncs.com

よくある問題

• apex CNAME がサポートされていない場合は、www などのサブドメイン、または ALIAS/ANAME レコードを使用してください。
• DNS の伝播が完了してから FC のカスタムドメインを作成してください。完了前に作成すると、DomainNameNotResolved が発生する場合があります。

参考資料

• aliyun-cli のインストール

  • 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 カスタムドメインの設定と CNAME に関するガイダンス

  • https://www.alibabacloud.com/help/en/functioncompute/fc/user-guide/configure-custom-domain-names

• 公式ソース一覧：references/sources.md

検証

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

合格基準：コマンドが 0 で終了し、output/aliyun-dns-cli/validate.txt が生成されること。

出力と証跡

• 成果物、コマンド出力、API レスポンスの要約を output/aliyun-dns-cli/ に保存します。
• 再現性を確保するため、証跡ファイルに主要なパラメーター（リージョン／リソース ID／期間）を含めます。

前提条件

• 実行前に、最小権限の Alibaba Cloud 認証情報を設定してください。
• 環境変数の使用を推奨します：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、任意で ALIBABACLOUD_REGION_ID。
• リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認してください。

ワークフロー

1. ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うものかを確認します。
2. 接続と権限を確認するため、最初に最小限の読み取り専用クエリを 1 つ実行します。
3. 明示的なパラメーターと限定された範囲で、対象の操作を実行します。
4. 結果を確認し、出力／証跡ファイルを保存します。