Skip to content

Commit 601dbe7

Browse files
authored
Merge pull request #64970 from mjpytlak/osdocs-6501
OSDOCS#6501: Azure - move install config parameters out of assemblies
2 parents e16e9a3 + c661af3 commit 601dbe7

8 files changed

+46
-50
lines changed

_topic_maps/_topic_map.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -219,6 +219,8 @@ Topics:
219219
File: installing-azure-three-node
220220
- Name: Uninstalling a cluster on Azure
221221
File: uninstalling-cluster-azure
222+
- Name: Installation configuration parameters for Azure
223+
File: installation-config-parameters-azure
222224
- Name: Installing on Azure Stack Hub
223225
Dir: installing_azure_stack_hub
224226
Distros: openshift-origin,openshift-enterprise
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
:_content-type: ASSEMBLY
2+
[id="installation-config-parameters-azure"]
3+
= Installation configuration parameters for Azure
4+
include::_attributes/common-attributes.adoc[]
5+
:context: installation-config-parameters-azure
6+
:platform: Azure
7+
8+
toc::[]
9+
10+
Before you deploy an {product-title} cluster on Microsoft Azure, you provide parameters to customize your cluster and the platform that hosts it. When you create the `install-config.yaml` file, you provide values for the required parameters through the command line. You can then modify the `install-config.yaml` file to customize your cluster further.
11+
12+
include::modules/installation-configuration-parameters.adoc[leveloffset=+1]

installing/installing_azure/installing-azure-customizations.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,9 @@ include::modules/querying-user-defined-tags-azure.adoc[leveloffset=+1]
3535

3636
include::modules/installation-initializing.adoc[leveloffset=+1]
3737

38-
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
38+
[role="_additional-resources"]
39+
.Additional resources
40+
* xref:../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-azure[Installation configuration parameters for Azure]
3941

4042
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
4143

installing/installing_azure/installing-azure-government-region.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,9 @@ include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
3838

3939
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
4040

41-
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
41+
[role="_additional-resources"]
42+
.Additional resources
43+
* xref:../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-azure[Installation configuration parameters for Azure]
4244

4345
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
4446

installing/installing_azure/installing-azure-network-customizations.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
3333

3434
include::modules/installation-initializing.adoc[leveloffset=+1]
3535

36-
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
36+
[role="_additional-resources"]
37+
.Additional resources
38+
* xref:../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-azure[Installation configuration parameters for Azure]
3739

3840
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
3941

installing/installing_azure/installing-azure-private.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,9 @@ include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
3333

3434
include::modules/installation-initializing-manual.adoc[leveloffset=+1]
3535

36-
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
36+
[role="_additional-resources"]
37+
.Additional resources
38+
* xref:../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-azure[Installation configuration parameters for Azure]
3739

3840
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
3941

installing/installing_azure/installing-azure-vnet.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,9 @@ include::modules/installation-obtaining-installer.adoc[leveloffset=+1]
2727

2828
include::modules/installation-initializing.adoc[leveloffset=+1]
2929

30-
include::modules/installation-configuration-parameters.adoc[leveloffset=+2]
30+
[role="_additional-resources"]
31+
.Additional resources
32+
* xref:../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-azure[Installation configuration parameters for Azure]
3133

3234
include::modules/installation-minimum-resource-requirements.adoc[leveloffset=+2]
3335

modules/installation-configuration-parameters.adoc

Lines changed: 17 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,6 @@
99
// * installing/installing_aws/installing-aws-vpc.adoc
1010
// * installing/installing_aws/installing-restricted-networks-aws-installer-provisioned.adoc
1111
// * installing/installing_aws/installing-aws-outposts-remote-workers.adoc
12-
// * installing/installing_azure/installing-azure-customizations.adoc
13-
// * installing/installing_azure/installing-azure-government-region.adoc
14-
// * installing/installing_azure/installing-azure-network-customizations.adoc
15-
// * installing/installing_azure/installing-azure-private.adoc
16-
// * installing/installing_azure/installing-azure-vnet.adoc
1712
// * installing/installing_vsphere/installation-config-parameters-vsphere.adoc
1813
// * installing/installing_gcp/installation-config-parameters-gcp.adoc
1914
// * installing/installing_ibm_z/installation-config-parameters-ibm-z.adoc
@@ -25,6 +20,7 @@
2520
// * installing/installing_ibm_powervs/installation-config-parameters-ibm-power-vs.adoc
2621
// * installing/installing_nutanix/installation-config-parameters-nutanix.adoc
2722
// * installing/installing_openstack/installation-config-parameters-openstack.adoc
23+
// * installing/installing_azure/installation-config-parameters-azure.adoc
2824

2925
ifeval::["{context}" == "installing-aws-customizations"]
3026
:aws:
@@ -52,21 +48,6 @@ endif::[]
5248
ifeval::["{context}" == "installing-aws-outposts-remote-workers"]
5349
:aws:
5450
endif::[]
55-
ifeval::["{context}" == "installing-azure-customizations"]
56-
:azure:
57-
endif::[]
58-
ifeval::["{context}" == "installing-azure-government-region"]
59-
:azure:
60-
endif::[]
61-
ifeval::["{context}" == "installing-azure-network-customizations"]
62-
:azure:
63-
endif::[]
64-
ifeval::["{context}" == "installing-azure-private"]
65-
:azure:
66-
endif::[]
67-
ifeval::["{context}" == "installing-azure-vnet"]
68-
:azure:
69-
endif::[]
7051
ifeval::["{context}" == "installing-aws-customizations"]
7152
:aws:
7253
endif::[]
@@ -103,49 +84,52 @@ endif::[]
10384
ifeval::["{context}" == "installation-config-parameters-openstack"]
10485
:osp:
10586
endif::[]
87+
ifeval::["{context}" == "installation-config-parameters-azure"]
88+
:azure:
89+
endif::[]
10690

10791
:_content-type: CONCEPT
10892
[id="installation-configuration-parameters_{context}"]
109-
ifndef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
93+
ifndef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
11094
= Installation configuration parameters
111-
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
95+
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
11296

11397
// Managing headings is required as part of the effort for https://issues.redhat.com/browse/OSDOCS-6493.
11498
// This accommodates the existing IA of the installation assemblies, while the improvement is implemented.
11599
// As part of the updates for the last provider, the conditions can be removed and the following heading can be used.
116-
ifdef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
100+
ifdef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
117101
= Available installation configuration parameters for {platform}
118-
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
102+
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
119103

120104
// If install-config.yaml is generated by openshift-install
121105
// The addition of providers beyond bare,ibm-power,ibm-z,ash is necessary as part of the effort for https://issues.redhat.com/browse/OSDOCS-6493
122106
// This accommodates the existing IA of the installation assemblies, while the improvement is implemented.
123107
// As part of the updates for the last provider, content between lines 277-292 can be completely removed.
124-
ifndef::bare,ibm-power,ibm-z,ash,vsphere,gcp,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
108+
ifndef::bare,ibm-power,ibm-z,ash,vsphere,gcp,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
125109
Before you deploy an {product-title} cluster, you provide parameter values to describe your account on the cloud platform that hosts your cluster and optionally customize your cluster's platform. When you create the `install-config.yaml` installation configuration file, you provide values for the required parameters through the command line. If you customize your cluster, you can modify the `install-config.yaml` file to provide more details about the platform.
126-
endif::bare,ibm-power,ibm-z,ash,vsphere,gcp,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
110+
endif::bare,ibm-power,ibm-z,ash,vsphere,gcp,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
127111

128112
// A condition for this note is required as part of the effort for https://issues.redhat.com/browse/OSDOCS-6493.
129113
// This accommodates the existing content for installation assemblies, while the improvement is implemented.
130114
// As part of the updates for the last provider, this note can be removed from the module.
131-
ifndef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
115+
ifndef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
132116
[NOTE]
133117
====
134118
After installation, you cannot modify these parameters in the `install-config.yaml` file.
135119
====
136-
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
120+
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
137121

138122
// This condition is required as part of the effort for https://issues.redhat.com/browse/OSDOCS-6493.
139123
// As part of the update for each provider, this content applies to the net new provider-specific installation configuration parameter assembly.
140124
// As part of the updates for the last provider, the conditions can be completely removed.
141-
ifdef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
125+
ifdef::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
142126
The following tables specify the required, optional, and {platform}-specific installation configuration parameters that you can set as part of the installation process.
143127

144128
[NOTE]
145129
====
146130
After installation, you cannot modify these parameters in the `install-config.yaml` file.
147131
====
148-
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp[]
132+
endif::vsphere,gcp,ibm-z,ibm-power,ash,bare,ibm-cloud,alibaba-cloud,ibm-power-vs,nutanix,osp,azure[]
149133

150134
[id="installation-configuration-parameters-required_{context}"]
151135
== Required configuration parameters
@@ -2063,21 +2047,6 @@ endif::[]
20632047
ifeval::["{context}" == "installing-aws-outposts-remote-workers"]
20642048
:!aws:
20652049
endif::[]
2066-
ifeval::["{context}" == "installing-azure-customizations"]
2067-
:!azure:
2068-
endif::[]
2069-
ifeval::["{context}" == "installing-azure-government-region"]
2070-
:!azure:
2071-
endif::[]
2072-
ifeval::["{context}" == "installing-azure-network-customizations"]
2073-
:!azure:
2074-
endif::[]
2075-
ifeval::["{context}" == "installing-azure-private"]
2076-
:!azure:
2077-
endif::[]
2078-
ifeval::["{context}" == "installing-azure-vnet"]
2079-
:!azure:
2080-
endif::[]
20812050
ifeval::["{context}" == "installing-aws-customizations"]
20822051
:!aws:
20832052
endif::[]
@@ -2114,4 +2083,7 @@ endif::[]
21142083
ifeval::["{context}" == "installation-config-parameters-openstack"]
21152084
:!osp:
21162085
endif::[]
2086+
ifeval::["{context}" == "installation-config-parameters-azure"]
2087+
:!azure:
2088+
endif::[]
21172089
:!platform:

0 commit comments

Comments
 (0)