mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
87 lines
4.2 KiB
Plaintext
87 lines
4.2 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} (ROSA) cluster using the command-line interface (CLI), grant user access, deploy your first application, and learn how to revoke user access and delete your cluster.
|
|
|
|
[discrete]
|
|
include::modules/rosa-sts-overview-of-the-default-cluster-specifications.adoc[leveloffset=+2]
|
|
|
|
include::modules/rosa-getting-started-environment-setup.adoc[leveloffset=+1]
|
|
[discrete]
|
|
include::modules/rosa-getting-started-enable-rosa.adoc[leveloffset=+2]
|
|
[discrete]
|
|
include::modules/rosa-getting-started-install-configure-cli-tools.adoc[leveloffset=+2]
|
|
|
|
.Next steps
|
|
|
|
Before you can use the {cluster-manager} {hybrid-console-second} to deploy ROSA clusters, you must associate your AWS account with your Red{nbsp}Hat organization and create the required account-wide STS roles and policies.
|
|
|
|
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 {hcp-title} clusters
|
|
|
|
You must have a Virtual Private Cloud (VPC) to create {hcp-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 Terraform script it is in the same region that you intend to install your cluster. In these examples, use `us-east-2`.
|
|
====
|
|
|
|
[discrete]
|
|
include::modules/rosa-hcp-create-network.adoc[leveloffset=+3]
|
|
|
|
[role="_additional-resources"]
|
|
[id="additional-resources_rosa-hcp-create-network-quickstart"]
|
|
.Additional resources
|
|
|
|
* See the link:https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/quickref-ec2-vpc.html[AWS CloudFormation documentation] for more information about structuring CloudFormation files to create VPCs.
|
|
* See the link:https://github.com/openshift/rosa/blob/master/cmd/create/network/templates/rosa-quickstart-default-vpc/cloudformation.yaml[default VPC AWS CloudFormation template] for more information.
|
|
|
|
[discrete]
|
|
include::modules/rosa-hcp-vpc-terraform.adoc[leveloffset=+3]
|
|
|
|
[role="_additional-resources"]
|
|
[id="additional-resources_rosa-hcp-vpc-terraform-quickstart"]
|
|
.Additional resources
|
|
|
|
* See the link:https://github.com/openshift-cs/terraform-vpc-example[Terraform VPC] repository for a detailed list of all options available when customizing the VPC for your needs.
|
|
|
|
[discrete]
|
|
include::modules/rosa-hcp-vpc-manual.adoc[leveloffset=+2]
|
|
|
|
include::snippets/vpc-troubleshooting.adoc[leveloffset=+2]
|
|
|
|
[discrete]
|
|
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]
|
|
[discrete]
|
|
include::modules/rosa-getting-started-revoke-admin-privileges.adoc[leveloffset=+2]
|
|
[discrete]
|
|
include::modules/rosa-getting-started-revoke-user-access.adoc[leveloffset=+2]
|
|
include::modules/rosa-getting-started-deleting-a-cluster.adoc[leveloffset=+1] |