alicloud-network-dns-cli

Category: ツール

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

よくある問題

• ゾーン頂点の 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/alicloud-network-dns-cli
echo "validation_placeholder" > output/alicloud-network-dns-cli/validate.txt

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

出力と証拠

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

前提条件

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

ワークフロー

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