4. Route53ゾーンの作成 (example.jp)¶
作業の目的 [why]¶
Route53ゾーン"example.jp"を作成します。
注釈
作業者によって作業対象のドメイン名が異なるため、本手順においてはドメイン名"example.jp"の部分を"<事前に用意した独自ドメイン>"に読み替えてください。
("コマンド"、"変数の設定"、"変数の確認"については読み替えの必要はありません。)
完了条件/事前条件 [設計者用情報]
完了条件 [after]
主処理は、以下を満たしたときに成功したものとします。
- 完了条件1
作成したRoute53ゾーン"example.jp"が存在する。
事前条件 [before]
主処理の実施は、以下の状態であることを前提とします。
- 事前条件1
Route53ゾーン"example.jp"が存在していない。
- 事前条件2
Route53デリゲーションセット"handson-cli-dgset"が存在する。
作業対象 [what]¶
Route53サービス
標準時間(合計)¶
8分
パラメータ設定¶
- パラメータ設定の標準時間
2分
作業に必要なモノ・情報 [resource]¶
作業開始には、以下が全て揃っていることが必要です。
リソース1: Route53ゾーン名
作成するRoute53ゾーンの名称です。
今回は、事前に用意した独自ドメインを利用します。
リソース2: Route53ゾーン識別子
作成するRoute53ゾーンの識別子です。
今回は"example.jp-<UNIX秒>"とします。
リソース3: Route53ゾーン詳細
作成するRoute53ゾーンの説明です。
今回は"example.jp zone"とします。
リソース4: Route53デリゲーションセット識別子
作成するRoute53デリゲーションセットの識別子です。
今回は"handson-cli-dgset"とします。
パラメータの指定¶
作業に必要なパラメータを変数に格納をします。
0.1. Route53ゾーン名の指定¶
Route53ゾーン名を指定します。
変数の設定:
DIR_TMP="${HOME}/environment/tmp-handson-cli-lightsail"
変数の設定:
FILE_TMP="${DIR_TMP}/sub_domain.tmp" \ && echo ${FILE_TMP}
結果(例):
${HOME}/environment/tmp-handson-cli-lightsail/sub_domain.tmp
コマンド:
source ${FILE_TMP}
変数の設定:
ROUTE53_ZONE_NAME="${DOMAIN_NAME}" \ && echo ${ROUTE53_ZONE_NAME}
結果(例):
example.jp
0.2. Route53ゾーン識別子の指定¶
Route53ゾーン表示名を指定します。
変数の設定:
ROUTE53_ZONE_CALLER="${ROUTE53_ZONE_NAME}-$(date +%s)" \ && echo ${ROUTE53_ZONE_CALLER}
結果(例):
example.jp-XXXXXXXXXX
0.3. Route53ゾーンに対するコメントの指定¶
Route53ゾーンに対するコメントを指定します。
変数の設定:
ROUTE53_ZONE_COMMENT="${ROUTE53_ZONE_NAME} zone" \ && echo ${ROUTE53_ZONE_COMMENT}example.jp zone
0.4. Route53デリゲーションセット識別子の指定¶
Route53デリゲーションセット識別子を指定します。
変数の設定:
ROUTE53_DELEGATION_SET_CALLER='handson-cli-dgset'
パラメータの保存¶
設定されている変数の保存先となるファイル名を指定します。
変数の設定:
DIR_PARAMETER="${HOME}/tmp/parameter-handson-cli-lightsail" FILE_PARAMETER="${DIR_PARAMETER}/$(date +%Y-%m-%d)-route53-hosted_zone-create-expand-reusabledelegationset.env" \ && echo ${FILE_PARAMETER}
結果(例):
${HOME}/tmp/parameter-handson-cli-lightsail/2020-02-10-route53-hosted_zone-create-expand-reusabledelegationset.env
各変数に正しいパラメータ値が格納されていることを確認しながら保存します。
変数の確認:
cat << EOF > ${FILE_PARAMETER} # 0.1. ROUTE53_ZONE_NAME:"example.jp" ROUTE53_ZONE_NAME="${ROUTE53_ZONE_NAME}" # 0.2. ROUTE53_ZONE_CALLER:"example.jp-XXXXXXXXXX" ROUTE53_ZONE_CALLER="${ROUTE53_ZONE_CALLER}" # 0.3. ROUTE53_ZONE_COMMENT:"example.jp zone" ROUTE53_ZONE_COMMENT="${ROUTE53_ZONE_COMMENT}" # 0.4. ROUTE53_DELEGATION_SET_CALLER:"handson-cli-dgset" ROUTE53_DELEGATION_SET_CALLER="${ROUTE53_DELEGATION_SET_CALLER}" EOF cat ${FILE_PARAMETER}
下段の変数が入っていない、もしくは上段と同等の値が入っていない場合は、それぞれの手順番号に戻って変数の設定を行います。
タスクの実施¶
- タスク標準時間
6分
1. 前処理¶
1.1. 処理対象の状態確認¶
主処理の実施は、以下の状態であることを前提とします。
前提と異なることが判明した場合、直ちに処理を中止します。
事前条件1: Route53ゾーン"example.jp"が存在していない。
「Route53ゾーン"example.jp"が存在していない。」ことを確認します。
コマンド:
aws route53 list-hosted-zones \ --query "HostedZones[?Name == \`${ROUTE53_ZONE_NAME}.\` \ && Config.PrivateZone == \`false\`].Name" \ --output text
結果(例):
(出力なし)
事前条件2: Route53デリゲーションセット"handson-cli-dgset"が存在する。
「Route53デリゲーションセット"handson-cli-dgset"が存在する。」ことを確認します。
コマンド:
aws route53 list-reusable-delegation-sets \ --query "DelegationSets[?CallerReference == \`${ROUTE53_DELEGATION_SET_CALLER}\`].CallerReference" \ --output text
結果(例):
handson-cli-dgset
1.2. 主処理に必要な情報の取得¶
デリゲーションセットIDの取得
コマンド:
ROUTE53_DELEGATION_SET_ID=$( \ aws route53 list-reusable-delegation-sets \ --query "DelegationSets[?CallerReference == \`${ROUTE53_DELEGATION_SET_CALLER}\`].Id" \ --output text \ | sed 's|/delegationset/||' \ ) \ && echo ${ROUTE53_DELEGATION_SET_ID}
結果(例):
XXXXXXXXXXXXXX
2. 主処理¶
ROUTE53ゾーンの作成¶
変数の確認:
cat << ETX # ROUTE53_ZONE_NAME:"example.jp" ROUTE53_ZONE_NAME="${ROUTE53_ZONE_NAME}" # ROUTE53_ZONE_CALLER:"example.jp-XXXXXXXXXX" ROUTE53_ZONE_CALLER="${ROUTE53_ZONE_CALLER}" # ROUTE53_ZONE_COMMENT:"example.jp zone" ROUTE53_ZONE_COMMENT="${ROUTE53_ZONE_COMMENT}" # ROUTE53_DELEGATION_SET_ID:"XXXXXXXXXXXXXX" ROUTE53_DELEGATION_SET_ID="${ROUTE53_DELEGATION_SET_ID}" ETX
コマンド:
aws route53 create-hosted-zone \ --name ${ROUTE53_ZONE_NAME} \ --caller-reference ${ROUTE53_ZONE_CALLER} \ --hosted-zone-config Comment="${ROUTE53_ZONE_COMMENT}" \ --delegation-set-id ${ROUTE53_DELEGATION_SET_ID}
結果(例):
{ "HostedZone": { "ResourceRecordSetCount": 2, "CallerReference": "example.jp-XXXXXXXXXX", "Config": { "Comment": "example.jp zone", "PrivateZone": false }, "Id": "/hostedzone/xxxxxxxxxxxxx", "Name": "example.jp." }, "DelegationSet": { "NameServers": [ "ns-xxx.awsdns-xx.co.uk", "ns-xxx.awsdns-xx.net", "ns-xxx.awsdns-xx.com", "ns-xxx.awsdns-xx.org" ] }, "Location": "https://route53.amazonaws.com/2013-04-01/hostedzone/xxxxxxxxxxxxx", "ChangeInfo": { "Status": "PENDING", "SubmittedAt": "2020-02-10T01:23:45.678Z", "Id": "/change/xxxxxxxxxxxxx" } }
3. 後処理¶
完了条件の確認¶
主処理は、以下を満たしたときに成功したものとします。
完了条件1: 作成したRoute53ゾーン"example.jp"が存在する。
「作成したRoute53ゾーン"example.jp"が存在する。」ことを確認します。
コマンド:
aws route53 list-hosted-zones \ --query "HostedZones[?Name == \`${ROUTE53_ZONE_NAME}.\` \ && Config.PrivateZone == \`false\`].Name" \ --output text
結果(例):
example.jp.