Skip to content

Commit 7420f22

Browse files
committed
OSDOCS-1960 - Adding to the AWS UPI installation path
1 parent 6f3c807 commit 7420f22

File tree

46 files changed

+459
-202
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+459
-202
lines changed

architecture/architecture-installation.adoc

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,15 @@ toc::[]
66

77
include::modules/installation-overview.adoc[leveloffset=+1]
88

9+
.Additional resources
10+
11+
* See xref:../installing/install_config/customizations.adoc#customizations[Available cluster customizations] for details about {product-title} configuration resources.
12+
913
include::modules/update-service-overview.adoc[leveloffset=+1]
1014

1115
include::modules/unmanaged-operators.adoc[leveloffset=+1]
16+
17+
[id="architecture-installation-next-steps"]
18+
== Next steps
19+
20+
* xref:../installing/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users]

installing/installing_aws/installing-aws-account.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ include::modules/installation-aws-permissions.adoc[leveloffset=+1]
1818

1919
include::modules/installation-aws-iam-user.adoc[leveloffset=+1]
2020

21+
.Additional resources
22+
23+
* See xref:../../installing/installing_aws/manually-creating-iam.adoc#manually-creating-iam-aws[Manually creating IAM for AWS] for steps to set the Cloud Credential Operator (CCO) to manual mode prior to installation. Use this mode in environments where the cloud identity and access management (IAM) APIs are not reachable, or if you prefer not to store an administrator-level credential secret in the cluster `kube-system` project.
24+
2125
include::modules/installation-aws-regions.adoc[leveloffset=+1]
2226

2327
== Next steps

installing/installing_aws/installing-aws-customizations.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,10 @@ environments where the cloud IAM APIs are not reachable.
3939

4040
include::modules/cluster-entitlements.adoc[leveloffset=+1]
4141

42+
.Additional resources
43+
44+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
45+
4246
include::modules/ssh-agent-using.adoc[leveloffset=+1]
4347

4448
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]

installing/installing_aws/installing-aws-default.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,12 +37,20 @@ environments where the cloud IAM APIs are not reachable.
3737

3838
include::modules/cluster-entitlements.adoc[leveloffset=+1]
3939

40+
.Additional resources
41+
42+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service
43+
4044
include::modules/ssh-agent-using.adoc[leveloffset=+1]
4145

4246
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
4347

4448
include::modules/installation-launching-installer.adoc[leveloffset=+1]
4549

50+
.Additional resources
51+
52+
* See link:https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html[Configuration and credential file settings] in the AWS documentation for more information about AWS profile and credential configuration.
53+
4654
include::modules/cli-installing-cli.adoc[leveloffset=+1]
4755

4856
include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]

installing/installing_aws/installing-aws-government-region.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,10 @@ include::modules/installation-custom-aws-vpc.adoc[leveloffset=+1]
4646

4747
include::modules/cluster-entitlements.adoc[leveloffset=+1]
4848

49+
.Additional resources
50+
51+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
52+
4953
include::modules/ssh-agent-using.adoc[leveloffset=+1]
5054

5155
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]

installing/installing_aws/installing-aws-network-customizations.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,10 @@ environments where the cloud IAM APIs are not reachable.
4646

4747
include::modules/cluster-entitlements.adoc[leveloffset=+1]
4848

49+
.Additional resources
50+
51+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
52+
4953
include::modules/ssh-agent-using.adoc[leveloffset=+1]
5054

5155
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]

installing/installing_aws/installing-aws-private.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,10 @@ include::modules/installation-custom-aws-vpc.adoc[leveloffset=+1]
4343

4444
include::modules/cluster-entitlements.adoc[leveloffset=+1]
4545

46+
.Additional resources
47+
48+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
49+
4650
include::modules/ssh-agent-using.adoc[leveloffset=+1]
4751

4852
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]

installing/installing_aws/installing-aws-user-infra.adoc

Lines changed: 57 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ according to your company's policies.
1515

1616
== Prerequisites
1717

18-
* Review details about the
18+
* You reviewed details about the
1919
xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
2020
processes.
21-
* xref:../../installing/installing_aws/installing-aws-account.adoc#installing-aws-account[Configure an AWS account]
21+
* You xref:../../installing/installing_aws/installing-aws-account.adoc#installing-aws-account[configured an AWS account]
2222
to host the cluster.
2323
+
2424
[IMPORTANT]
@@ -32,11 +32,10 @@ link:https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys
3232
in the AWS documentation. You can supply the keys when you run the installation
3333
program.
3434
====
35-
* Download the AWS CLI and install it on your computer. See
35+
* You downloaded the AWS CLI and installed it on your computer. See
3636
link:https://docs.aws.amazon.com/cli/latest/userguide/install-bundle.html[Install the AWS CLI Using the Bundled Installer (Linux, macOS, or Unix)]
3737
in the AWS documentation.
38-
* If you use a firewall, you must
39-
xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure it to allow the sites] that your cluster requires access to.
38+
* If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured it to allow the sites] that your cluster requires access to.
4039
+
4140
[NOTE]
4241
====
@@ -50,6 +49,10 @@ environments where the cloud IAM APIs are not reachable.
5049

5150
include::modules/cluster-entitlements.adoc[leveloffset=+1]
5251

52+
.Additional resources
53+
54+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
55+
5356
include::modules/installation-aws-user-infra-requirements.adoc[leveloffset=+1]
5457

5558
include::modules/installation-aws-permissions.adoc[leveloffset=+2]
@@ -62,6 +65,10 @@ include::modules/installation-user-infra-generate.adoc[leveloffset=+1]
6265

6366
include::modules/installation-generate-aws-user-infra-install-config.adoc[leveloffset=+2]
6467

68+
.Additional resources
69+
70+
* See link:https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html[Configuration and credential file settings] in the AWS documentation for more information about AWS profile and credential configuration.
71+
6572
include::modules/installation-configure-proxy.adoc[leveloffset=+2]
6673

6774
//include::modules/installation-three-node-cluster.adoc[leveloffset=+2]
@@ -74,14 +81,30 @@ include::modules/installation-creating-aws-vpc.adoc[leveloffset=+1]
7481

7582
include::modules/installation-cloudformation-vpc.adoc[leveloffset=+2]
7683

84+
.Additional resources
85+
86+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
87+
7788
include::modules/installation-creating-aws-dns.adoc[leveloffset=+1]
7889

7990
include::modules/installation-cloudformation-dns.adoc[leveloffset=+2]
8091

92+
.Additional resources
93+
94+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
95+
96+
* You can view details about your hosted zones by navigating to the link:https://console.aws.amazon.com/route53/[AWS Route 53 console].
97+
98+
* See link:https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ListInfoOnHostedZone.html[Listing public hosted zones] in the AWS documentation for more information about listing public hosted zones.
99+
81100
include::modules/installation-creating-aws-security.adoc[leveloffset=+1]
82101

83102
include::modules/installation-cloudformation-security.adoc[leveloffset=+2]
84103

104+
.Additional resources
105+
106+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
107+
85108
include::modules/installation-aws-user-infra-rhcos-ami.adoc[leveloffset=+1]
86109

87110
include::modules/installation-aws-regions-with-no-ami.adoc[leveloffset=+2]
@@ -92,11 +115,21 @@ include::modules/installation-creating-aws-bootstrap.adoc[leveloffset=+1]
92115

93116
include::modules/installation-cloudformation-bootstrap.adoc[leveloffset=+2]
94117

118+
.Additional resources
119+
120+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
121+
122+
* See xref:../../installing/installing_aws/installing-aws-user-infra.adoc#installation-aws-user-infra-rhcos-ami_installing-aws-user-infra[{op-system} AMIs for the AWS infrastructure] for details about the {op-system-first} AMIs for the AWS zones.
123+
95124
include::modules/installation-creating-aws-control-plane.adoc[leveloffset=+1]
96125

97126
include::modules/installation-cloudformation-control-plane.adoc[leveloffset=+2]
98127

99-
include::modules/installation-aws-user-infra-bootstrap.adoc[leveloffset=+1]
128+
.Additional resources
129+
130+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
131+
132+
include::modules/installation-creating-aws-worker.adoc[leveloffset=+1]
100133

101134
////
102135
[id="installing-workers-aws-user-infra"]
@@ -108,10 +141,21 @@ the workers, you can allow the cluster to manage them. This allows you to easily
108141
scale, manage, and upgrade your workers.
109142
////
110143

144+
include::modules/installation-cloudformation-worker.adoc[leveloffset=+2]
111145

112-
include::modules/installation-creating-aws-worker.adoc[leveloffset=+2]
146+
.Additional resources
113147

114-
include::modules/installation-cloudformation-worker.adoc[leveloffset=+3]
148+
* You can view details about the CloudFormation stacks that you create by navigating to the link:https://console.aws.amazon.com/cloudformation/[AWS CloudFormation console].
149+
150+
include::modules/installation-aws-user-infra-bootstrap.adoc[leveloffset=+1]
151+
152+
.Additional resources
153+
154+
* See xref:../../support/troubleshooting/troubleshooting-installations.html#monitoring-installation-progress_troubleshooting-installations[Monitoring installation progress] for details about monitoring the installation, bootstrap, and control plane logs as an {product-title} installation progresses.
155+
156+
* See xref:../../support/troubleshooting/troubleshooting-installations.adoc#gathering-bootstrap-diagnostic-data_troubleshooting-installations[Gathering bootstrap node diagnostic data] for information about troubleshooting issues related to the bootstrap process.
157+
158+
* You can view details about the running instances that are created by using the link:https://console.aws.amazon.com/ec2[AWS EC2 console].
115159

116160
include::modules/cli-installing-cli.adoc[leveloffset=+1]
117161

@@ -137,10 +181,14 @@ include::modules/installation-aws-user-infra-installation.adoc[leveloffset=+1]
137181

138182
include::modules/logging-in-by-using-the-web-console.adoc[leveloffset=+1]
139183

140-
.Additional resources
184+
[id="installing-aws-user-infra-additional-resources"]
185+
== Additional resources
141186

142187
* See xref:../../web_console/web-console.adoc#web-console[Accessing the web console] for more details about accessing and understanding the {product-title} web console.
143188

189+
* See link:https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html[Working with stacks] in the AWS documentation for more information about AWS CloudFormation stacks.
190+
191+
[id="installing-aws-user-infra-next-steps"]
144192
== Next steps
145193

146194
* xref:../../installing/validating-an-installation.adoc#validating-an-installation[Validating an installation].

installing/installing_aws/installing-aws-vpc.adoc

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,10 @@ include::modules/installation-custom-aws-vpc.adoc[leveloffset=+1]
3939

4040
include::modules/cluster-entitlements.adoc[leveloffset=+1]
4141

42+
.Additional resources
43+
44+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service.
45+
4246
include::modules/ssh-agent-using.adoc[leveloffset=+1]
4347

4448
include::modules/installation-obtaining-installer.adoc[leveloffset=+1]

installing/installing_aws/installing-restricted-networks-aws.adoc

Lines changed: 36 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -22,18 +22,18 @@ according to your company's policies.
2222

2323
== Prerequisites
2424

25-
* xref:../../installing/install_config/installing-restricted-networks-preparations.adoc#installing-restricted-networks-preparations[Create a mirror registry on your mirror host]
26-
and obtain the `imageContentSources` data for your version of {product-title}.
25+
* You xref:../../installing/install_config/installing-restricted-networks-preparations.adoc#installing-restricted-networks-preparations[created a mirror registry on your mirror host]
26+
and obtained the `imageContentSources` data for your version of {product-title}.
2727
+
2828
[IMPORTANT]
2929
====
3030
Because the installation media is on the mirror host, you can use that computer
3131
to complete all installation steps.
3232
====
33-
* Review details about the
33+
* You reviewed details about the
3434
xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
3535
processes.
36-
* xref:../../installing/installing_aws/installing-aws-account.adoc#installing-aws-account[Configure an AWS account]
36+
* You xref:../../installing/installing_aws/installing-aws-account.adoc#installing-aws-account[configured an AWS account]
3737
to host the cluster.
3838
+
3939
[IMPORTANT]
@@ -47,11 +47,10 @@ link:https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys
4747
in the AWS documentation. You can supply the keys when you run the installation
4848
program.
4949
====
50-
* Download the AWS CLI and install it on your computer. See
50+
* You downloaded the AWS CLI and installed it on your computer. See
5151
link:https://docs.aws.amazon.com/cli/latest/userguide/install-bundle.html[Install the AWS CLI Using the Bundled Installer (Linux, macOS, or Unix)]
5252
in the AWS documentation.
53-
* If you use a firewall and plan to use telemetry, you must
54-
xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configure the firewall to allow the sites] that your cluster requires access to.
53+
* If you use a firewall and plan to use the Telemetry service, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured the firewall to allow the sites] that your cluster requires access to.
5554
+
5655
[NOTE]
5756
====
@@ -67,6 +66,10 @@ include::modules/installation-about-restricted-network.adoc[leveloffset=+1]
6766

6867
include::modules/cluster-entitlements.adoc[leveloffset=+1]
6968

69+
.Additional resources
70+
71+
* See xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] for more information about the Telemetry service
72+
7073
include::modules/installation-aws-user-infra-requirements.adoc[leveloffset=+1]
7174

7275
include::modules/installation-aws-permissions.adoc[leveloffset=+2]
@@ -79,6 +82,10 @@ include::modules/installation-user-infra-generate.adoc[leveloffset=+1]
7982

8083
include::modules/installation-generate-aws-user-infra-install-config.adoc[leveloffset=+2]
8184

85+
.Additional resources
86+
87+
* See link:https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html[Configuration and credential file settings] in the AWS documentation for more information about AWS profile and credential configuration.
88+
8289
include::modules/installation-configure-proxy.adoc[leveloffset=+2]
8390

8491
//include::modules/installation-three-node-cluster.adoc[leveloffset=+2]
@@ -95,6 +102,10 @@ include::modules/installation-creating-aws-dns.adoc[leveloffset=+1]
95102

96103
include::modules/installation-cloudformation-dns.adoc[leveloffset=+2]
97104

105+
.Additional resources
106+
107+
* See link:https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/ListInfoOnHostedZone.html[Listing public hosted zones] in the AWS documentation for more information about listing public hosted zones.
108+
98109
include::modules/installation-creating-aws-security.adoc[leveloffset=+1]
99110

100111
include::modules/installation-cloudformation-security.adoc[leveloffset=+2]
@@ -105,11 +116,15 @@ include::modules/installation-creating-aws-bootstrap.adoc[leveloffset=+1]
105116

106117
include::modules/installation-cloudformation-bootstrap.adoc[leveloffset=+2]
107118

119+
.Additional resources
120+
121+
* See xref:../../installing/installing_aws/installing-aws-user-infra.adoc#installation-aws-user-infra-rhcos-ami_installing-aws-user-infra[{op-system} AMIs for the AWS infrastructure] for details about the {op-system-first} AMIs for the AWS zones.
122+
108123
include::modules/installation-creating-aws-control-plane.adoc[leveloffset=+1]
109124

110125
include::modules/installation-cloudformation-control-plane.adoc[leveloffset=+2]
111126

112-
include::modules/installation-aws-user-infra-bootstrap.adoc[leveloffset=+1]
127+
include::modules/installation-creating-aws-worker.adoc[leveloffset=+1]
113128

114129
////
115130
[id="installing-workers-aws-user-infra"]
@@ -121,10 +136,15 @@ the workers, you can allow the cluster to manage them. This allows you to easily
121136
scale, manage, and upgrade your workers.
122137
////
123138

139+
include::modules/installation-cloudformation-worker.adoc[leveloffset=+2]
124140

125-
include::modules/installation-creating-aws-worker.adoc[leveloffset=+2]
141+
include::modules/installation-aws-user-infra-bootstrap.adoc[leveloffset=+1]
126142

127-
include::modules/installation-cloudformation-worker.adoc[leveloffset=+3]
143+
.Additional resources
144+
145+
* See xref:../../support/troubleshooting/troubleshooting-installations.html#monitoring-installation-progress_troubleshooting-installations[Monitoring installation progress] for details about monitoring the installation, bootstrap, and control plane logs as an {product-title} installation progresses.
146+
147+
* See xref:../../support/troubleshooting/troubleshooting-installations.adoc#gathering-bootstrap-diagnostic-data_troubleshooting-installations[Gathering bootstrap node diagnostic data] for information about troubleshooting issues related to the bootstrap process.
128148

129149
//You can install the CLI on the mirror host.
130150

@@ -148,13 +168,17 @@ include::modules/installation-aws-user-infra-installation.adoc[leveloffset=+1]
148168

149169
include::modules/logging-in-by-using-the-web-console.adoc[leveloffset=+1]
150170

151-
.Additional resources
171+
[id="installing-restricted-networks-aws-additional-resources"]
172+
== Additional resources
152173

153174
* See xref:../../web_console/web-console.adoc#web-console[Accessing the web console] for more details about accessing and understanding the {product-title} web console.
154175

176+
* See link:https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html[Working with stacks] in the AWS documentation for more information about AWS CloudFormation stacks.
177+
178+
[id="installing-restricted-networks-aws-next-steps"]
155179
== Next steps
156180

157-
* xref:../../installing/validating-an-installation.adoc#validating-an-installation[Validating an installation].
181+
* xref:../../installing/validating-an-installation.adoc#validating-an-installation[Validate an installation].
158182
* xref:../../installing/install_config/customizations.adoc#customizations[Customize your cluster].
159183
* If the mirror registry that you used to install your cluster has a trusted CA, add it to the cluster by xref:../../openshift_images/image-configuration.adoc#images-configuration-cas_image-configuration[configuring additional trust stores].
160184
* If necessary, you can

0 commit comments

Comments
 (0)