3.8.6. Creating the installation files for Azure
To install OpenShift Container Platform on Microsoft Azure using user-provisioned infrastructure, you must generate the files that the installation program needs to deploy your cluster and modify them so that the cluster creates only the machines that it will use. You generate and customize the
install-config.yaml file, Kubernetes manifests, and Ignition config files.
126.96.36.199. Creating the installation configuration file
You can customize the OpenShift Container Platform cluster you install on Microsoft Azure.
- Obtain the OpenShift Container Platform installation program and the pull secret for your cluster.
Run the following command:
$ ./openshift-install create install-config --dir=<installation_directory> 1
<installation_directory>, specify the directory name to store the files that the installation program creates.
Specify an empty directory. Some installation assets, like bootstrap X.509 certificates have short expiration intervals, so you must not reuse an installation directory. If you want to reuse individual files from another cluster installation, you can copy them into your directory. However, the file names for the installation assets might change between releases. Use caution when copying installation files from an earlier OpenShift Container Platform version.
At the prompts, provide the configuration details for your cloud:
Optional: Select an SSH key to use to access your cluster machines.注記
For production OpenShift Container Platform clusters on which you want to perform installation debugging or disaster recovery, specify an SSH key that your
- Select azure as the platform to target.
If you do not have a Microsoft Azure profile stored on your computer, specify the following Azure parameter values for your subscription and service principal:
azure subscription id: The subscription ID to use for the cluster. Specify the
idvalue in your account output.
azure tenant id: The tenant ID. Specify the
tenantIdvalue in your account output.
azure service principal client id: The value of the
appIdparameter for the service principal.
azure service principal client secret: The value of the
passwordparameter for the service principal.
- azure subscription id: The subscription ID to use for the cluster. Specify the
- Select the region to deploy the cluster to.
- Select the base domain to deploy the cluster to. The base domain corresponds to the Azure DNS Zone that you created for your cluster.
Enter a descriptive name for your cluster.重要
All Azure resources that are available through public endpoints are subject to resource name restrictions, and you cannot create resources that use certain terms. For a list of terms that Azure restricts, see Resolve reserved resource name errors in the Azure documentation.
- Paste the pull secret that you obtained from the Pull Secret page on the Red Hat OpenShift Cluster Manager site.
install-config.yamlfile. You can find more information about the available parameters in the Installation configuration parameters section.
Back up the
install-config.yamlfile so that you can use it to install multiple clusters.重要
install-config.yamlfile is consumed during the installation process. If you want to reuse the file, you must back it up now.