bug 1743483 adding DNS record data #17190
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| // Module included in the following assemblies: | ||
| // | ||
| // * installing/installing_aws_user_infra/installing-aws-user-infra.adoc | ||
| // * installing/installing_restricted_networks/installing-restricted-networks-aws.adoc | ||
|
|
||
| [id="installation-aws-user-infra-delete-bootstrap_{context}"] | ||
| = Deleting the bootstrap resources | ||
|
|
||
| After you complete the initial Operator configuration for the cluster, remove the bootstrap resources from Amazon Web Services (AWS). | ||
|
|
||
| .Prerequisites | ||
|
|
||
| * You completed the initial Operator configuration for your cluster. | ||
|
|
||
| .Procedure | ||
|
|
||
| . Delete the bootstrap resources. If you used the CloudFormation template, | ||
| link:https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html[delete its stack]: | ||
| + | ||
| ---- | ||
| $ aws cloudformation delete-stack --stack-name <name> <1> | ||
| ---- | ||
| <1> `<name>` is the name of your bootstrap stack. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,117 @@ | ||
| // Module included in the following assemblies: | ||
| // | ||
| // * installing/installing_aws_user_infra/installing-aws-user-infra.adoc | ||
| // * installing/installing_restricted_networks/installing-restricted-networks-aws.adoc | ||
|
|
||
| [id="installation-create-ingress-dns-records_{context}"] | ||
| = Creating the Ingress DNS Records | ||
|
|
||
| If you removed the DNS Zone configuration, manually create DNS records that point to the Ingress load balancer. | ||
| You can create either a wildcard record or specific records. While the following procedure uses A records, you can use other record types that you require, such as CNAME or alias. | ||
|
|
||
| .Prerequisites | ||
|
|
||
| * You deployed an {product-title} cluster on Amazon Web Services (AWS) by using infrastructure that you provisioned. | ||
| * Install the OpenShift Command-line Interface (CLI), commonly known as `oc`. | ||
| * Install the `jq` package. | ||
| * Download the AWS CLI and install it on your computer. See | ||
| link:https://docs.aws.amazon.com/cli/latest/userguide/install-bundle.html[Install the AWS CLI Using the Bundled Installer (Linux, macOS, or Unix)]. | ||
|
|
||
| .Procedure | ||
|
|
||
| . Determine the routes to create. | ||
| ** To create a wildcard record, use `*.apps.<cluster_name>.<domain_name>`, where `<cluster_name>` is your cluster name, and `<domain_name>` is the Route53 base domain for your {product-title} cluster. | ||
| ** To create specific records, you must create a record for each route that your cluster uses, as shown in the output of the following command: | ||
| + | ||
| ---- | ||
| $ 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> | ||
| ---- | ||
|
|
||
| . Retrieve the Ingress Operator load balancer status and note the value of the external IP address that it uses, which is shown in the `EXTERNAL-IP` column: | ||
| + | ||
| ---- | ||
| $ 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 | ||
| ---- | ||
|
|
||
| . Locate the hosted zone ID for the load balancer: | ||
| + | ||
| ---- | ||
| $ aws elb describe-load-balancers | jq -r '.LoadBalancerDescriptions[] | select(.DNSName == "<external_ip>").CanonicalHostedZoneNameID' <1> | ||
|
|
||
| Z3AADJGX6KTTL2 | ||
| ---- | ||
| <1> For `<external_ip>`, specify the value of the external IP address of the Ingress Operator load balancer that you obtained. | ||
|
||
| + | ||
| The output of this command is the load balancer hosted zone ID. | ||
|
|
||
| . Obtain the public hosted zone ID for your cluster's domain: | ||
| + | ||
| ---- | ||
| $ aws route53 list-hosted-zones-by-name \ | ||
| --dns-name "<domain_name>" \ <1> | ||
| --query 'HostedZones[? Config.PrivateZone != `true` && Name == `<domain_name>.`].Id' <1> | ||
| --output text | ||
|
|
||
| /hostedzone/Z3URY6TWQ91KVV | ||
| ---- | ||
| <1> For `<domain_name>`, specify the Route53 base domain for your {product-title} cluster. | ||
| + | ||
| The public hosted zone ID for your domain is shown in the command output. In this example, it is `Z3URY6TWQ91KVV`. | ||
|
|
||
| . Add the alias records to your private zone: | ||
| + | ||
| ---- | ||
| $ 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> For `<private_hosted_zone_id>`, specify the value from the output of the CloudFormation template for DNS and load balancing. | ||
|
||
| <2> For `<cluster_domain>`, specify the domain or subdomain that you use with your {product-title} cluster. | ||
| <3> For `<hosted_zone_id>`, specify the public hosted zone ID for the load balancer that you obtained. | ||
| <4> For `<external_ip>`, specify the value of the external IP address of the Ingress Operator load balancer. Ensure that you include the trailing period (`.`) in this parameter value. | ||
|
|
||
| . Add the records to your public zone: | ||
| + | ||
| ---- | ||
| $ 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> For `<public_hosted_zone_id>`, specify the public hosted zone for your domain. | ||
| <2> For `<cluster_domain>`, specify the domain or subdomain that you use with your {product-title} cluster. | ||
| <3> For `<hosted_zone_id>`, specify the public hosted zone ID for the load balancer that you obtained. | ||
| <4> For `<external_ip>`, specify the value of the external IP address of the Ingress Operator load balancer. Ensure that you include the trailing period (`.`) in this parameter value. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.