mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-06 06:46:26 +01:00
132 lines
4.6 KiB
Plaintext
132 lines
4.6 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * installing/installing_aws/installing-aws-government-region.adoc
|
|
// * installing/installing_aws/installing-aws-private.adoc
|
|
// * installing/installing_azure/installing-azure-government-region.adoc
|
|
// * installing/installing_azure/installing-azure-private.adoc
|
|
// * installing/installing_bare_metal/installing-bare-metal.adoc
|
|
// * installing/installing_gcp/installing-gcp-private.adoc
|
|
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
|
|
// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
|
|
// * installing/installing_vsphere/installing-vsphere.adoc
|
|
// * installing/installing_ibm_z/installing-ibm-z.adoc
|
|
|
|
ifeval::["{context}" == "installing-azure-government-region"]
|
|
:azure-gov:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
|
|
:restricted:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
|
|
:restricted:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-aws-government-region"]
|
|
:aws-gov:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-aws-private"]
|
|
:aws-private:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-azure-private"]
|
|
:azure-private:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-gcp-private"]
|
|
:gcp-private:
|
|
endif::[]
|
|
|
|
[id="installation-initializing-manual_{context}"]
|
|
= Manually creating the installation configuration file
|
|
|
|
ifndef::aws-gov,azure-gov,aws-private,azure-private,gcp-private[]
|
|
For installations of {product-title} that use user-provisioned
|
|
infrastructure, you manually generate your installation configuration file.
|
|
endif::aws-gov,azure-gov,aws-private,azure-private,gcp-private[]
|
|
ifdef::aws-gov[]
|
|
When installing {product-title} on Amazon Web Services (AWS) into a region
|
|
requiring a custom {op-system-first} AMI, you must manually generate your
|
|
installation configuration file.
|
|
endif::aws-gov[]
|
|
ifdef::azure-gov[]
|
|
When installing {product-title} on Microsoft Azure into a government region, you
|
|
must manually generate your installation configuration file.
|
|
endif::azure-gov[]
|
|
ifdef::aws-private,azure-private,gcp-private[]
|
|
For installations of a private {product-title} cluster that are only accessible from an internal network and are not visible to the Internet, you must manually generate your installation configuration file.
|
|
endif::aws-private,azure-private,gcp-private[]
|
|
|
|
.Prerequisites
|
|
|
|
* Obtain the {product-title} installation program and the access token for your
|
|
cluster.
|
|
ifdef::restricted[]
|
|
* Obtain the `imageContentSources` section from the output of the command to
|
|
mirror the repository.
|
|
* Obtain the contents of the certificate for your mirror registry.
|
|
endif::restricted[]
|
|
|
|
.Procedure
|
|
|
|
. Create an installation directory to store your required installation assets
|
|
in:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ mkdir <installation_directory>
|
|
----
|
|
+
|
|
[IMPORTANT]
|
|
====
|
|
You must create a 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.
|
|
====
|
|
|
|
. Customize the following `install-config.yaml` file template and save
|
|
it in the `<installation_directory>`.
|
|
+
|
|
[NOTE]
|
|
====
|
|
You must name this configuration file `install-config.yaml`.
|
|
====
|
|
ifdef::restricted[]
|
|
** Unless you use a registry that {op-system} trusts by default, such as
|
|
`docker.io`, you must provide the contents of the certificate for your mirror
|
|
repository in the `additionalTrustBundle` section. In most cases, you must
|
|
provide the certificate for your mirror.
|
|
** You must include the `imageContentSources` section from the output of the command to
|
|
mirror the repository.
|
|
endif::restricted[]
|
|
|
|
. Back up the `install-config.yaml` file so that you can use it to install
|
|
multiple clusters.
|
|
+
|
|
[IMPORTANT]
|
|
====
|
|
The `install-config.yaml` file is consumed during the next step of the
|
|
installation process. You must back it up now.
|
|
====
|
|
|
|
ifeval::["{context}" == "installing-azure-government-region"]
|
|
:!azure-gov:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-restricted-networks-vsphere"]
|
|
:!restricted:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
|
|
:!restricted:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-aws-government-region"]
|
|
:!aws-gov:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-aws-private"]
|
|
:!aws-private:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-azure-private"]
|
|
:!azure-private:
|
|
endif::[]
|
|
ifeval::["{context}" == "installing-gcp-private"]
|
|
:!gcp-private:
|
|
endif::[]
|