Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,13 @@ include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,13 @@ include::modules/installation-azure-tested-machine-types.adoc[leveloffset=+2]
include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For installation in government region, platform.azure.cloudName must be customized and set to AzureUSGovernmentCloud, because default value is AzurePublicCloud if it is not configured in install-config.yaml file.


[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,13 @@ include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,13 @@ include::modules/installation-azure-arm-tested-machine-types.adoc[leveloffset=+2
include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to https://github.com/openshift/openshift-docs/pull/92943/files#r2131397209, if we can have a dedicated section to guide users to set publish: Internal in install-config.yaml for a private cluster install. That would be helpful.


[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
8 changes: 7 additions & 1 deletion installing/installing_azure/ipi/installing-azure-vnet.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,13 @@ include::modules/installation-azure-arm-tested-machine-types.adoc[leveloffset=+2
include::modules/installation-azure-trusted-launch.adoc[leveloffset=+2]
include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Compared with 4.18 official doc, there is a dedicated section - Define the network and subnets for the VNet to install the cluster under the platform.azure field to guide user to modify the install-config.yaml properly, but from the new version of preview doc, there are no such section, personally I think it is not very friendly to ready for users.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think that the sample install-config.yaml should contain the following parameters?

networkResourceGroupName: <vnet_resource_group> 
virtualNetwork: <vnet> 
controlPlaneSubnet: <control_plane_subnet> 
computeSubnet: <compute_subnet> 

I can add them if you think they're important, but I will not be adding descriptions to the parameters. This file is changing away from being a full description of all the parameters, towards being a simple example of what the install-config.yaml syntax looks like.

Copy link

@jianlinliu jianlinliu Jun 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not think we need to include the parameters in the sample install-config.yaml. But it is important for Existing vnet , currently users can not find out how to customized install-config.yaml in the doc of installing clusters in an existing vnet.


[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,13 @@ include::modules/installation-azure-confidential-vms.adoc[leveloffset=+2]

include::modules/installation-azure-dedicated-disks.adoc[leveloffset=+2]

include::modules/installation-azure-config-yaml.adoc[leveloffset=+2]
include::modules/installation-azure-config-yaml-simple.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_azure/installation-config-parameters-azure.adoc#installation-config-parameters-aws[Installation configuration parameters for Azure]


include::modules/installation-configure-proxy.adoc[leveloffset=+2]

Expand Down
58 changes: 58 additions & 0 deletions modules/installation-azure-config-yaml-simple.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
// Module included in the following assemblies:
//
// * installing/installing_azure/installing-azure-customizations.adoc
// * installing/installing_azure/installing-azure-government-region.adoc
// * installing/installing_azure/installing-azure-network-customizations.adoc
// * installing/installing_azure/installing-azure-private.adoc
// * installing/installing_azure/installing-azure-vnet.adoc
// * installing/installing-restricted-networks-azure-installer-provisioned.adoc

:_mod-docs-content-type: REFERENCE
[id="installation-azure-config-yaml-simple_{context}"]
= Sample customized install-config.yaml file for Azure

You can customize the `install-config.yaml` file to specify more details about your {product-title} cluster's platform or modify the values of the required parameters.

[IMPORTANT]
====
This sample YAML file is provided for reference only. You must obtain your `install-config.yaml` file by using the installation program and modify it.
For a full list and description of all installation configuration parameters, see _Installation configuration parameters for Azure_.
====

.Sample `install-config.yaml` file for {azure-short}
[source,yaml]
----
apiVersion: v1 <1>
baseDomain: example.com
pullSecret: '{"auths": ...}'
sshKey: ssh-ed25519 AAAA...
metadata:
name: example-cluster
controlPlane: <2>
hyperthreading: Enabled
name: master
platform:
azure:
type: Standard_D8s_v3
replicas: 3
compute: <3>
- hyperthreading: Enabled
name: worker
platform:
azure:
type: Standard_D2s_v3
replicas: 3
networking: <4>
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
platform: <5>
azure:
baseDomainResourceGroupName: example-basedomain-resource-group
region: centralus
----
<1> Parameters at the first level of indentation apply to the cluster globally.
<2> The `controlPlane` stanza applies to control plane machines.
<3> The `compute` stanza applies to compute machines.
<4> The `networking` stanza applies to the cluster networking configuration. If you do not provide networking values, the installation program provides default values.
<5> The `platform` stanza applies to the infrastructure platform that hosts the cluster.
Loading