1.8.19. Ingress DNS レコードの作成

手順

1. 作成するルートを決定します。

   • ワイルドカードレコードを作成するには、*.apps.<cluster_name>.<domain_name> を使用します。ここで、<cluster_name> はクラスター名で、<domain_name> は OpenShift Container Platform クラスターの Route 53 ベースドメインです。

   • 特定のレコードを作成するには、以下のコマンドの出力にあるように、クラスターが使用する各ルートにレコードを作成する必要があります。

     $ oc get --all-namespaces -o jsonpath='{range .items[*]}{range .status.ingress[*]}{.host}{"\n"}{end}{end}' routes
     oauth-openshift.apps.<cluster_name>.<domain_name>
     console-openshift-console.apps.<cluster_name>.<domain_name>
     downloads-openshift-console.apps.<cluster_name>.<domain_name>
     alertmanager-main-openshift-monitoring.apps.<cluster_name>.<domain_name>
     grafana-openshift-monitoring.apps.<cluster_name>.<domain_name>
     prometheus-k8s-openshift-monitoring.apps.<cluster_name>.<domain_name>

2. Ingress Operator ロードバランサーのステータスを取得し、使用する外部 IP アドレスの値をメモします。これは EXTERNAL-IP 列に表示されます。

   $ oc -n openshift-ingress get service router-default
   NAME             TYPE           CLUSTER-IP      EXTERNAL-IP                            PORT(S)                      AGE
   router-default   LoadBalancer   172.30.62.215   ab3...28.us-east-2.elb.amazonaws.com   80:31499/TCP,443:30693/TCP   5m

3. ロードバランサーのホストゾーン ID を見つけます。

   $ aws elb describe-load-balancers | jq -r '.LoadBalancerDescriptions[] | select(.DNSName == "<external_ip>").CanonicalHostedZoneNameID' 1
   
   Z3AADJGX6KTTL2

   1

   <external_ip> については、取得した Ingress Operator ロードバランサーの外部 IP アドレスの値を指定します。

   このコマンドの出力は、ロードバランサーのホストゾーン ID です。

4. クラスターのドメインのパブリックホストゾーン ID を取得します。

   $ aws route53 list-hosted-zones-by-name \
               --dns-name "<domain_name>" \ 1
               --query 'HostedZones[? Config.PrivateZone != `true` && Name == `<domain_name>.`].Id' 2
               --output text
   
   /hostedzone/Z3URY6TWQ91KVV

   1 2

   <domain_name> については、OpenShift Container Platform クラスターの Route53 ベースドメインを指定します。

   ドメインのパブリックホストゾーン ID がコマンド出力に表示されます。この例では、これは Z3URY6TWQ91KVV になります。

5. プライベートゾーンにエイリアスレコードを追加します。

   $ aws route53 change-resource-record-sets --hosted-zone-id "<private_hosted_zone_id>" --change-batch '{ 1
   >   "Changes": [
   >     {
   >       "Action": "CREATE",
   >       "ResourceRecordSet": {
   >         "Name": "\\052.apps.<cluster_domain>", 2
   >         "Type": "A",
   >         "AliasTarget":{
   >           "HostedZoneId": "<hosted_zone_id>", 3
   >           "DNSName": "<external_ip>.", 4
   >           "EvaluateTargetHealth": false
   >         }
   >       }
   >     }
   >   ]
   > }'

   1

   <private_hosted_zone_id> については、DNS および負荷分散の CloudFormation テンプレートの出力から値を指定します。

   2

   <cluster_domain> については、OpenShift Container Platform クラスターで使用するドメインまたはサブドメインを指定します。

   3

   <hosted_zone_id> については、取得したロードバランサーのパブリックホストゾーン ID を指定します。

   4

   <external_ip> については、Ingress Operator ロードバランサーの外部 IP アドレスの値を指定します。このパラメーターの値に末尾のピリオド (.) が含まれていることを確認します。

6. パブリックゾーンにレコードを追加します。

   $ aws route53 change-resource-record-sets --hosted-zone-id "<public_hosted_zone_id>"" --change-batch '{ 1
   >   "Changes": [
   >     {
   >       "Action": "CREATE",
   >       "ResourceRecordSet": {
   >         "Name": "\\052.apps.<cluster_domain>", 2
   >         "Type": "A",
   >         "AliasTarget":{
   >           "HostedZoneId": "<hosted_zone_id>", 3
   >           "DNSName": "<external_ip>.", 4
   >           "EvaluateTargetHealth": false
   >         }
   >       }
   >     }
   >   ]
   > }'

   1

   <public_hosted_zone_id> については、ドメインのパブリックホストゾーンを指定します。

   2

   <cluster_domain> については、OpenShift Container Platform クラスターで使用するドメインまたはサブドメインを指定します。

   3

   <hosted_zone_id> については、取得したロードバランサーのパブリックホストゾーン ID を指定します。

   4

   <external_ip> については、Ingress Operator ロードバランサーの外部 IP アドレスの値を指定します。このパラメーターの値に末尾のピリオド (.) が含まれていることを確認します。