mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
80 lines
3.9 KiB
Plaintext
80 lines
3.9 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
[id="rosa-hcp-quickstart-guide"]
|
|
= {product-title} quick start guide
|
|
include::_attributes/attributes-openshift-dedicated.adoc[]
|
|
:context: rosa-hcp-quickstart-guide
|
|
|
|
toc::[]
|
|
|
|
Follow this guide to quickly create a {product-title} cluster using the {rosa-cli-first}, grant user access, deploy your first application, and learn how to revoke user access and delete your cluster.
|
|
|
|
include::modules/rosa-sts-overview-of-the-default-cluster-specifications.adoc[leveloffset=+1]
|
|
|
|
include::modules/rosa-getting-started-environment-setup.adoc[leveloffset=+1]
|
|
|
|
include::modules/rosa-getting-started-enable-rosa.adoc[leveloffset=+2]
|
|
|
|
include::modules/rosa-getting-started-install-configure-cli-tools.adoc[leveloffset=+2]
|
|
|
|
.Next steps
|
|
|
|
Before you can use the {hybrid-console} to deploy {product-title} clusters, you must associate your AWS account with your Red{nbsp}Hat organization and create the required account-wide AWS IAM STS roles and policies for {product-title}.
|
|
|
|
include::modules/rosa-sts-creating-account-wide-sts-roles-and-policies.adoc[leveloffset=+1]
|
|
|
|
[id="rosa-hcp-quickstart-creating-vpc"]
|
|
== Creating a Virtual Private Cloud for your {product-title} clusters
|
|
|
|
You must have an AWS Virtual Private Cloud (VPC) to create a {product-title} cluster. You can use the following methods to create a VPC:
|
|
|
|
* Create a VPC using the {rosa-cli}
|
|
* Create a VPC by using a Terraform template
|
|
* Manually create the VPC resources in the AWS console
|
|
|
|
[NOTE]
|
|
====
|
|
The Terraform instructions are for testing and demonstration purposes. Your own installation requires some modifications to the VPC for your own use. You should also ensure that when you use this linked Terraform configuration, it is in the same region that you intend to install your cluster. In these examples, `us-east-2` is used.
|
|
====
|
|
|
|
include::modules/rosa-hcp-create-network.adoc[leveloffset=+2]
|
|
|
|
[role="_additional-resources"]
|
|
[id="additional-resources_rosa-hcp-create-network-quickstart"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/quickref-ec2-vpc.html[AWS CloudFormation documentation]
|
|
* link:https://github.com/openshift/rosa/blob/master/cmd/create/network/templates/rosa-quickstart-default-vpc/cloudformation.yaml[Default VPC AWS CloudFormation template]
|
|
|
|
include::modules/rosa-hcp-vpc-terraform.adoc[leveloffset=+3]
|
|
|
|
[role="_additional-resources"]
|
|
[id="additional-resources_rosa-hcp-vpc-terraform-quickstart"]
|
|
.Additional resources
|
|
|
|
* link:https://github.com/openshift-cs/terraform-vpc-example[Terraform VPC repository]
|
|
|
|
include::modules/rosa-hcp-vpc-manual.adoc[leveloffset=+2]
|
|
|
|
include::snippets/vpc-troubleshooting.adoc[leveloffset=+2]
|
|
|
|
include::modules/rosa-hcp-vpc-subnet-tagging.adoc[leveloffset=+3]
|
|
|
|
[role="_additional-resources"]
|
|
[id="additional-resources_rosa-hcp-vpc-aws-quickstart"]
|
|
.Additional resources
|
|
|
|
* link:https://docs.aws.amazon.com/vpc/latest/userguide/vpc-getting-started.html[Get Started with Amazon VPC]
|
|
* link:https://developer.hashicorp.com/terraform[HashiCorp Terraform documentation]
|
|
* link:https://kubernetes-sigs.github.io/aws-load-balancer-controller/v2.2/deploy/subnet_discovery/[Subnet Auto Discovery]
|
|
|
|
include::modules/rosa-sts-byo-oidc.adoc[leveloffset=+1]
|
|
include::modules/rosa-operator-config.adoc[leveloffset=+1]
|
|
include::modules/rosa-hcp-sts-creating-a-cluster-cli.adoc[leveloffset=+1]
|
|
include::modules/rosa-getting-started-grant-user-access.adoc[leveloffset=+1]
|
|
include::modules/rosa-getting-started-grant-admin-privileges.adoc[leveloffset=+1]
|
|
include::modules/rosa-getting-started-access-cluster-web-console.adoc[leveloffset=+1]
|
|
include::modules/deploy-app.adoc[leveloffset=+1]
|
|
include::modules/rosa-getting-started-revoking-admin-privileges-and-user-access.adoc[leveloffset=+1]
|
|
include::modules/rosa-getting-started-revoke-admin-privileges.adoc[leveloffset=+2]
|
|
include::modules/rosa-getting-started-revoke-user-access.adoc[leveloffset=+2]
|
|
include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1] |