1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/hcp-aws-hc-ext-dns.adoc

70 lines
2.7 KiB
Plaintext

// Module included in the following assemblies:
//
// * hosted_control_planes/hcp-deploy/hcp-deploy-aws.adoc
:_mod-docs-content-type: PROCEDURE
[id="hcp-aws-hc-ext-dns_{context}"]
= Creating a hosted cluster by using the external DNS on {aws-short}
To create a hosted cluster by using the `PublicAndPrivate` or `Public` publishing strategy on {aws-first}, you must have the following artifacts configured in your management cluster:
* The public DNS hosted zone
* The External DNS Operator
* The HyperShift Operator
You can deploy a hosted cluster, by using the `hcp` command-line interface (CLI).
.Procedure
. To access your management cluster, enter the following command:
+
[source,terminal]
----
$ export KUBECONFIG=<path_to_management_cluster_kubeconfig>
----
. Verify that the External DNS Operator is running by entering the following command:
+
[source,terminal]
----
$ oc get pod -n hypershift -lapp=external-dns
----
+
.Example output
[source,terminal]
----
NAME READY STATUS RESTARTS AGE
external-dns-7c89788c69-rn8gp 1/1 Running 0 40s
----
. To create a hosted cluster by using external DNS, enter the following command:
+
[source,terminal]
----
$ hcp create cluster aws \
--role-arn <arn_role> \ <1>
--instance-type <instance_type> \ <2>
--region <region> \ <3>
--auto-repair \
--generate-ssh \
--name <hosted_cluster_name> \ <4>
--namespace clusters \
--base-domain <service_consumer_domain> \ <5>
--node-pool-replicas <node_replica_count> \ <6>
--pull-secret <path_to_your_pull_secret> \ <7>
--release-image quay.io/openshift-release-dev/ocp-release:<ocp_release_image> \ <8>
--external-dns-domain=<service_provider_domain> \ <9>
--endpoint-access=PublicAndPrivate <10>
--sts-creds <path_to_sts_credential_file> <11>
----
<1> Specify the Amazon Resource Name (ARN), for example, `arn:aws:iam::820196288204:role/myrole`.
<2> Specify the instance type, for example, `m6i.xlarge`.
<3> Specify the {aws-short} region, for example, `us-east-1`.
<4> Specify your hosted cluster name, for example, `my-external-aws`.
<5> Specify the public hosted zone that the service consumer owns, for example, `service-consumer-domain.com`.
<6> Specify the node replica count, for example, `2`.
<7> Specify the path to your pull secret file.
<8> Specify the supported {product-title} version that you want to use, for example, `4.21.0-multi`.
<9> Specify the public hosted zone that the service provider owns, for example, `service-provider-domain.com`.
<10> Set as `PublicAndPrivate`. You can use external DNS with `Public` or `PublicAndPrivate` configurations only.
<11> Specify the path to your {aws-short} STS credentials file, for example, `/home/user/sts-creds/sts-creds.json`.