-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #42293 from mjpytlak/ibm-cloud
OSDOCS-2855 Installing on IBM Cloud IPI
- Loading branch information
Showing
37 changed files
with
1,121 additions
and
20 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
25 changes: 25 additions & 0 deletions
25
installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| :_content-type: ASSEMBLY | ||
| [id="configuring-iam-ibm-cloud"] | ||
| = Configuring IAM for IBM Cloud | ||
| include::modules/common-attributes.adoc[] | ||
| :context: configuring-iam-ibm-cloud | ||
|
|
||
| toc::[] | ||
|
|
||
| In environments where the cloud identity and access management (IAM) APIs are not reachable, you must put the Cloud Credential Operator (CCO) into manual mode before you install the cluster. | ||
|
|
||
| include::modules/alternatives-to-storing-admin-secrets-in-kube-system.adoc[leveloffset=+1] | ||
|
|
||
| [role="_additional-resources"] | ||
| [id="additional-resources_configuring-iam-ibm-cloud"] | ||
| .Additional resources | ||
| * xref:../../authentication/managing_cloud_provider_credentials/about-cloud-credential-operator.adoc[About the Cloud Credential Operator] | ||
| include::modules/cco-ccoctl-configuring.adoc[leveloffset=+1] | ||
| include::modules/refreshing-service-ids-ibm-cloud.adoc[leveloffset=+1] | ||
| //include::modules/manually-maintained-credentials-upgrade.adoc[leveloffset=+1] | ||
| // Will need to revisit upgrade scenario for IBM Cloud; not needed until OCP 4.11. Tentative instructions have been added for reference later. | ||
|
|
||
| [id="next-steps_configuring-iam-ibm-cloud"] | ||
| == Next steps | ||
| * xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc#installing-ibm-cloud-customizations[Installing a cluster on IBM Cloud with customizations] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| ../../images |
27 changes: 27 additions & 0 deletions
27
installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,27 @@ | ||
| :_content-type: ASSEMBLY | ||
| [id="installing-ibm-cloud-account"] | ||
| = Configuring an IBM Cloud account | ||
| include::modules/common-attributes.adoc[] | ||
| :context: installing-ibm-cloud-account | ||
|
|
||
| toc::[] | ||
|
|
||
| Before you can install {product-title}, you must configure an IBM Cloud account. | ||
|
|
||
| [id="prerequisites_installing-ibm-cloud-account"] | ||
| == Prerequisites | ||
|
|
||
| * You have an IBM Cloud account with a subscription. You cannot install {product-title} on a free or trial IBM Cloud account. | ||
|
|
||
| include::modules/quotas-and-limits-ibm-cloud.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-cis-ibm-cloud.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-ibm-cloud-iam-policies-api-key.adoc[leveloffset=+1] | ||
| include::modules/installation-ibm-cloud-creating-api-key.adoc[leveloffset=+2] | ||
|
|
||
| include::modules/installation-ibm-cloud-regions.adoc[leveloffset=+1] | ||
|
|
||
| [id="next-steps_installing-ibm-cloud-account"] | ||
| == Next steps | ||
| * xref:../../installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud] |
64 changes: 64 additions & 0 deletions
64
installing/installing_ibm_cloud_public/installing-ibm-cloud-customizations.adoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,64 @@ | ||
| :_content-type: ASSEMBLY | ||
| [id="installing-ibm-cloud-customizations"] | ||
| = Installing a cluster on IBM Cloud with customizations | ||
| include::modules/common-attributes.adoc[] | ||
| :context: installing-ibm-cloud-customizations | ||
|
|
||
| toc::[] | ||
|
|
||
| In {product-title} version {product-version}, you can install a customized cluster on infrastructure that the installation program provisions on IBM Cloud. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. | ||
|
|
||
| [id="prerequisites_installing-ibm-cloud-customizations"] | ||
| == Prerequisites | ||
|
|
||
| * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. | ||
| * You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. | ||
| * You xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an IBM Cloud account] to host the cluster. | ||
| * If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured it to allow the sites] that your cluster requires access to. | ||
| * You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud]. | ||
|
|
||
| include::modules/cluster-entitlements.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/ssh-agent-using.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-obtaining-installer.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-ibm-cloud-export-variables.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-initializing.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-configuration-parameters.adoc[leveloffset=+2] | ||
|
|
||
| include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2] | ||
|
|
||
| //.Additional resources | ||
|
|
||
| //* ../../machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc#machineset-enabling-customer-managed-encryption_creating-machineset-ibm-cloud[Enabling customer-managed encryption keys for a machine set] | ||
|
|
||
| include::modules/installation-configure-proxy.adoc[leveloffset=+2] | ||
|
|
||
| include::modules/manually-create-iam-ibm-cloud.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-launching-installer.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/cli-installing-cli.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] | ||
|
|
||
| [role="_additional-resources"] | ||
| [id="additional-resources_installing-ibm-cloud-customizations-console"] | ||
| .Additional resources | ||
| * xref:../../web_console/web-console.adoc#web-console[Accessing the web console] | ||
|
|
||
| include::modules/cluster-telemetry.adoc[leveloffset=+1] | ||
|
|
||
| [role="_additional-resources"] | ||
| [id="additional-resources_installing-ibm-cloud-customizations-telemetry"] | ||
| .Additional resources | ||
| * xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] | ||
|
|
||
| [id="next-steps_installing-ibm-cloud-customizations"] | ||
| == Next steps | ||
| * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]. | ||
| * If necessary, you can | ||
| xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting]. |
73 changes: 73 additions & 0 deletions
73
...ng/installing_ibm_cloud_public/installing-ibm-cloud-network-customizations.adoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,73 @@ | ||
| :_content-type: ASSEMBLY | ||
| [id="installing-ibm-cloud-network-customizations"] | ||
| = Installing a cluster on IBM Cloud with network customizations | ||
| include::modules/common-attributes.adoc[] | ||
| :context: installing-ibm-cloud-network-customizations | ||
|
|
||
| toc::[] | ||
|
|
||
| In {product-title} version {product-version}, you can install a cluster with a | ||
| customized network configuration on infrastructure that the installation program provisions on IBM Cloud. By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing MTU and VXLAN configurations. To customize the installation, you modify parameters in the `install-config.yaml` file before you install the cluster. | ||
|
|
||
| You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster. | ||
|
|
||
| [id="prerequisites_installing-ibm-cloud-network-customizations"] | ||
| == Prerequisites | ||
|
|
||
| * You reviewed details about the xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update] processes. | ||
| * You read the documentation on xref:../../installing/installing-preparing.adoc#installing-preparing[selecting a cluster installation method and preparing it for users]. | ||
| * You xref:../../installing/installing_ibm_cloud_public/installing-ibm-cloud-account.adoc#installing-ibm-cloud-account[configured an IBM Cloud account] to host the cluster. | ||
| * If you use a firewall, you xref:../../installing/install_config/configuring-firewall.adoc#configuring-firewall[configured it to allow the sites] that your cluster requires access to. | ||
| * You configured the `ccoctl` utility before you installed the cluster. For more information, see xref:../../installing/installing_ibm_cloud_public/configuring-iam-ibm-cloud.adoc#configuring-iam-ibm-cloud[Configuring IAM for IBM Cloud]. | ||
|
|
||
| include::modules/cluster-entitlements.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/ssh-agent-using.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-obtaining-installer.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-ibm-cloud-export-variables.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-initializing.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-configuration-parameters.adoc[leveloffset=+2] | ||
|
|
||
| include::modules/installation-ibm-cloud-config-yaml.adoc[leveloffset=+2] | ||
|
|
||
| //.Additional resources | ||
|
|
||
| //* ../../machine_management/creating_machinesets/creating-machineset-ibm-cloud.adoc#machineset-enabling-customer-managed-encryption_creating-machineset-ibm-cloud[Enabling customer-managed encryption keys for a machine set] | ||
|
|
||
| include::modules/installation-configure-proxy.adoc[leveloffset=+2] | ||
|
|
||
| include::modules/manually-create-iam-ibm-cloud.adoc[leveloffset=+1] | ||
|
|
||
| // Network Operator specific configuration | ||
| include::modules/nw-network-config.adoc[leveloffset=+1] | ||
| include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1] | ||
| include::modules/nw-operator-cr.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/installation-launching-installer.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/cli-installing-cli.adoc[leveloffset=+1] | ||
|
|
||
| include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1] | ||
|
|
||
| [role="_additional-resources"] | ||
| [id="additional-resources_installing-ibm-cloud-network-customizations-console"] | ||
| .Additional resources | ||
| * xref:../../web_console/web-console.adoc#web-console[Accessing the web console] | ||
|
|
||
| include::modules/cluster-telemetry.adoc[leveloffset=+1] | ||
|
|
||
| [role="_additional-resources"] | ||
| [id="additional-resources_installing-ibm-cloud-network-customizations-telemetry"] | ||
| .Additional resources | ||
| * xref:../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring] | ||
|
|
||
| [id="next-steps_installing-ibm-cloud-network-customizations"] | ||
| == Next steps | ||
|
|
||
| * xref:../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]. | ||
| * If necessary, you can | ||
| xref:../../support/remote_health_monitoring/opting-out-of-remote-health-reporting.adoc#opting-out-remote-health-reporting_opting-out-remote-health-reporting[opt out of remote health reporting]. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| ../../modules |
Oops, something went wrong.