Generate and customize the installation configuration file that the installation program needs to deploy your cluster.
-
Obtain the {product-title} installation program and the pull secret for your cluster.
-
Obtain the
install-config.yaml
file.-
Run the following command:
$ ./openshift-install create install-config --dir=<installation_directory> (1)
-
For
<installation_directory>
, specify the directory name to store the files that the installation program creates.ImportantSpecify 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 {product-title} version.
-
-
At the prompts, provide the configuration details for your cloud:
-
Optional: Select an SSH key to use to access your cluster machines.
NoteFor production {product-title} clusters on which you want to perform installation debugging or disaster recovery on, specify an SSH key that your
ssh-agent
process uses. -
Select aws as the platform to target.
-
If you do not have an AWS profile stored on your computer, enter the AWS access key ID and secret access key for the user that you configured to run the installation program.
-
Select the AWS region to deploy the cluster to.
-
Select the base domain for the Route53 service that you configured for your cluster.
-
Enter a descriptive name for your cluster.
-
Paste the pull secret that you obtained from the Pull Secret page on the {cloud-redhat-com} site.
-
-
-
Edit the
install-config.yaml
file to set the number of compute, or worker, replicas to0
, as shown in the followingcompute
stanza:compute: - hyperthreading: Enabled name: worker platform: {} replicas: 0
-
Optional: Back up the
install-config.yaml
file.ImportantThe
install-config.yaml
file is consumed during the installation process. If you want to reuse the file, you must back it up now.