Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 13. Optional: Installing on Nutanix
If you install OpenShift Container Platform on Nutanix, the Assisted Installer can integrate the OpenShift Container Platform cluster with the Nutanix platform, which exposes the Machine API to Nutanix and enables autoscaling and dynamically provisioning storage containers with the Nutanix Container Storage Interface (CSI).
13.1. Adding hosts on Nutanix with the UI Link kopierenLink in die Zwischenablage kopiert!
To add hosts on Nutanix with the user interface (UI), generate the discovery image ISO from the Assisted Installer. Use the minimal discovery image ISO. This is the default setting. The image includes only what is required to boot a host with networking. The majority of the content is downloaded upon boot. The ISO image is about 100MB in size.
After this is complete, you must create an image for the Nutanix platform and create the Nutanix virtual machines.
Prerequisites
- You have created a cluster profile in the Assisted Installer UI.
- You have a Nutanix cluster environment set up, and made a note of the cluster name and subnet name.
Procedure
- In Cluster details, select Nutanix from the Integrate with external partner platforms dropdown list. The Include custom manifest checkbox is optional.
- In Host discovery, click the Add hosts button.
Optional: Add an SSH public key so that you can connect to the Nutanix VMs as the
core
user. Having a login to the cluster hosts can provide you with debugging information during the installation.- If you do not have an existing SSH key pair on your local machine, follow the steps in Generating a key pair for cluster node SSH access.
-
In the SSH public key field, click Browse to upload the
id_rsa.pub
file containing the SSH public key. Alternatively, drag and drop the file into the field from the file manager. To see the file in the file manager, select Show hidden files in the menu.
Select the desired provisioning type.
NoteMinimal image file: Provision with virtual media downloads a smaller image that will fetch the data needed to boot.
In Networking, select Cluster-managed networking. Nutanix does not support User-managed networking.
- Optional: If the cluster hosts are behind a firewall that requires the use of a proxy, select Configure cluster-wide proxy settings. Enter the username, password, IP address and port for the HTTP and HTTPS URLs of the proxy server.
- Optional: Configure the discovery image if you want to boot it with an ignition file. See Configuring the discovery image for additional details.
- Click Generate Discovery ISO.
- Copy the Discovery ISO URL.
- In the Nutanix Prism UI, follow the directions to upload the discovery image from the Assisted Installer.
In the Nutanix Prism UI, create the control plane (master) VMs through Prism Central.
-
Enter the Name. For example,
control-plane
ormaster
. - Enter the Number of VMs. This should be 3 for the control plane.
- Ensure the remaining settings meet the minimum requirements for control plane hosts.
-
Enter the Name. For example,
In the Nutanix Prism UI, create the worker VMs through Prism Central.
-
Enter the Name. For example,
worker
. - Enter the Number of VMs. You should create at least 2 worker nodes.
- Ensure the remaining settings meet the minimum requirements for worker hosts.
-
Enter the Name. For example,
-
Return to the Assisted Installer user interface and wait until the Assisted Installer discovers the hosts and each of them have a
Ready
status. - Continue with the installation procedure.
13.2. Adding hosts on Nutanix with the API Link kopierenLink in die Zwischenablage kopiert!
To add hosts on Nutanix with the API, generate the discovery image ISO from the Assisted Installer. Use the minimal discovery image ISO. This is the default setting. The image includes only what is required to boot a host with networking. The majority of the content is downloaded upon boot. The ISO image is about 100MB in size.
Once this is complete, you must create an image for the Nutanix platform and create the Nutanix virtual machines.
Prerequisites
- You have set up the Assisted Installer API authentication.
- You have created an Assisted Installer cluster profile.
- You have created an Assisted Installer infrastructure environment.
-
You have your infrastructure environment ID exported in your shell as
$INFRA_ENV_ID
. - You have completed the Assisted Installer cluster configuration.
- You have a Nutanix cluster environment set up, and made a note of the cluster name and subnet name.
Procedure
- Configure the discovery image if you want it to boot with an ignition file.
Create a Nutanix cluster configuration file to hold the environment variables:
touch ~/nutanix-cluster-env.sh
$ touch ~/nutanix-cluster-env.sh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow chmod +x ~/nutanix-cluster-env.sh
$ chmod +x ~/nutanix-cluster-env.sh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow If you have to start a new terminal session, you can reload the environment variables easily. For example:
source ~/nutanix-cluster-env.sh
$ source ~/nutanix-cluster-env.sh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Assign the Nutanix cluster’s name to the
NTX_CLUSTER_NAME
environment variable in the configuration file:cat << EOF >> ~/nutanix-cluster-env.sh export NTX_CLUSTER_NAME=<cluster_name> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_CLUSTER_NAME=<cluster_name> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<cluster_name>
with the name of the Nutanix cluster.Assign the Nutanix cluster’s subnet name to the
NTX_SUBNET_NAME
environment variable in the configuration file:cat << EOF >> ~/nutanix-cluster-env.sh export NTX_SUBNET_NAME=<subnet_name> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_SUBNET_NAME=<subnet_name> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<subnet_name>
with the name of the Nutanix cluster’s subnet.Refresh the API token:
source refresh-token
$ source refresh-token
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Get the download URL:
curl -H "Authorization: Bearer ${API_TOKEN}" \ https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/downloads/image-url
$ curl -H "Authorization: Bearer ${API_TOKEN}" \ https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/downloads/image-url
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create the Nutanix image configuration file:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<image_url>
with the image URL downloaded from the previous step.Create the Nutanix image:
curl -k -u <user>:'<password>' -X 'POST' \ 'https://<domain-or-ip>:<port>/api/nutanix/v3/images \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d @./create-image.json | jq '.metadata.uuid'
$ curl -k -u <user>:'<password>' -X 'POST' \ 'https://<domain-or-ip>:<port>/api/nutanix/v3/images \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d @./create-image.json | jq '.metadata.uuid'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<user>
with the Nutanix user name. Replace'<password>'
with the Nutanix password. Replace<domain-or-ip>
with the domain name or IP address of the Nutanix plaform. Replace<port>
with the port for the Nutanix server. The port defaults to9440
.Assign the returned UUID to the
NTX_IMAGE_UUID
environment variable in the configuration file:cat << EOF >> ~/nutanix-cluster-env.sh export NTX_IMAGE_UUID=<uuid> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_IMAGE_UUID=<uuid> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Get the Nutanix cluster UUID:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<user>
with the Nutanix user name. Replace'<password>'
with the Nutanix password. Replace<domain-or-ip>
with the domain name or IP address of the Nutanix plaform. Replace<port>
with the port for the Nutanix server. The port defaults to9440
. Replace<nutanix_cluster_name>
with the name of the Nutanix cluster.Assign the returned Nutanix cluster UUID to the
NTX_CLUSTER_UUID
environment variable in the configuration file:cat << EOF >> ~/nutanix-cluster-env.sh export NTX_CLUSTER_UUID=<uuid> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_CLUSTER_UUID=<uuid> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<uuid>
with the returned UUID of the Nutanix cluster.Get the Nutanix cluster’s subnet UUID:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<user>
with the Nutanix user name. Replace'<password>'
with the Nutanix password. Replace<domain-or-ip>
with the domain name or IP address of the Nutanix plaform. Replace<port>
with the port for the Nutanix server. The port defaults to9440
. Replace<subnet_name>
with the name of the cluster’s subnet.Assign the returned Nutanix subnet UUID to the
NTX_CLUSTER_UUID
environment variable in the configuration file:cat << EOF >> ~/nutanix-cluster-env.sh export NTX_SUBNET_UUID=<uuid> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_SUBNET_UUID=<uuid> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<uuid>
with the returned UUID of the cluster subnet.Ensure the Nutanix environment variables are set:
source ~/nutanix-cluster-env.sh
$ source ~/nutanix-cluster-env.sh
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create a VM configuration file for each Nutanix host. Create three control plane (master) VMs and at least two worker VMs. For example:
touch create-master-0.json
$ touch create-master-0.json
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<host_name>
with the name of the host.Boot each Nutanix virtual machine:
curl -k -u <user>:'<password>' -X 'POST' \ 'https://<domain-or-ip>:<port>/api/nutanix/v3/vms' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d @./<vm_config_file_name> | jq '.metadata.uuid'
$ curl -k -u <user>:'<password>' -X 'POST' \ 'https://<domain-or-ip>:<port>/api/nutanix/v3/vms' \ -H 'accept: application/json' \ -H 'Content-Type: application/json' \ -d @./<vm_config_file_name> | jq '.metadata.uuid'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<user>
with the Nutanix user name. Replace'<password>'
with the Nutanix password. Replace<domain-or-ip>
with the domain name or IP address of the Nutanix plaform. Replace<port>
with the port for the Nutanix server. The port defaults to9440
. Replace<vm_config_file_name>
with the name of the VM configuration file.Assign the returned VM UUID to a unique environment variable in the configuration file:
cat << EOF >> ~/nutanix-cluster-env.sh export NTX_MASTER_0_UUID=<uuid> EOF
$ cat << EOF >> ~/nutanix-cluster-env.sh export NTX_MASTER_0_UUID=<uuid> EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
<uuid>
with the returned UUID of the VM.NoteThe environment variable must have a unique name for each VM.
Wait until the Assisted Installer has discovered each VM and they have passed validation.
curl -s -X GET "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID"
$ curl -s -X GET "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" --header "Content-Type: application/json" -H "Authorization: Bearer $API_TOKEN" | jq '.enabled_host_count'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Modify the cluster definition to enable integration with Nutanix:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Continue with the installation procedure.
13.3. Nutanix post-installation configuration Link kopierenLink in die Zwischenablage kopiert!
Follow the steps below to complete and validate the OpenShift Container Platform integration with the Nutanix cloud provider.
Prerequisites
- The Assisted Installer has finished installing the cluster successfully.
- The cluster is connected to console.redhat.com.
- You have access to the Red Hat OpenShift Container Platform command line interface.
13.3.1. Updating the Nutanix configuration settings Link kopierenLink in die Zwischenablage kopiert!
After installing OpenShift Container Platform on the Nutanix platform using the Assisted Installer, you must update the following Nutanix configuration settings manually:
-
<prismcentral_username>
: The Nutanix Prism Central username. -
<prismcentral_password>
: The Nutanix Prism Central password. -
<prismcentral_address>
: The Nutanix Prism Central address. -
<prismcentral_port>
: The Nutanix Prism Central port. -
<prismelement_username>
: The Nutanix Prism Element username. -
<prismelement_password>
: The Nutanix Prism Element password. -
<prismelement_address>
: The Nutanix Prism Element address. -
<prismelement_port>
: The Nutanix Prism Element port. -
<prismelement_clustername>
: The Nutanix Prism Element cluster name. -
<nutanix_storage_container>
: The Nutanix Prism storage container.
Procedure
In the OpenShift Container Platform command line interface, update the Nutanix cluster configuration settings:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
infrastructure.config.openshift.io/cluster patched
infrastructure.config.openshift.io/cluster patched
Copy to Clipboard Copied! Toggle word wrap Toggle overflow For additional details, see Creating a machine set on Nutanix.
Create the Nutanix secret:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
secret/nutanix-credentials created
secret/nutanix-credentials created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow When installing OpenShift Container Platform version 4.13 or later, update the Nutanix cloud provider configuration:
Get the Nutanix cloud provider configuration YAML file:
oc get cm cloud-provider-config -o yaml -n openshift-config > cloud-provider-config-backup.yaml
$ oc get cm cloud-provider-config -o yaml -n openshift-config > cloud-provider-config-backup.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create a backup of the configuration file:
cp cloud-provider-config_backup.yaml cloud-provider-config.yaml
$ cp cloud-provider-config_backup.yaml cloud-provider-config.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Open the configuration YAML file:
$ vi cloud-provider-config.yaml
$ vi cloud-provider-config.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Edit the configuration YAML file as follows:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Apply the configuration updates:
oc apply -f cloud-provider-config.yaml
$ oc apply -f cloud-provider-config.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
Warning: resource configmaps/cloud-provider-config is missing the kubectl.kubernetes.io/last-applied-configuration annotation which is required by oc apply. oc apply should only be used on resources created declaratively by either oc create --save-config or oc apply. The missing annotation will be patched automatically. configmap/cloud-provider-config configured
Warning: resource configmaps/cloud-provider-config is missing the kubectl.kubernetes.io/last-applied-configuration annotation which is required by oc apply. oc apply should only be used on resources created declaratively by either oc create --save-config or oc apply. The missing annotation will be patched automatically. configmap/cloud-provider-config configured
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
13.3.2. Creating the Nutanix CSI Operator group Link kopierenLink in die Zwischenablage kopiert!
Create an Operator group for the Nutanix CSI Operator.
For a description of operator groups and related concepts, see Common Operator Framework Terms in Additional Resources.
Procedure
Open the Nutanix CSI Operator Group YAML file:
$ vi openshift-cluster-csi-drivers-operator-group.yaml
$ vi openshift-cluster-csi-drivers-operator-group.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Edit the YAML file as follows:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create the Operator Group:
oc create -f openshift-cluster-csi-drivers-operator-group.yaml
$ oc create -f openshift-cluster-csi-drivers-operator-group.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
operatorgroup.operators.coreos.com/openshift-cluster-csi-driversjw9cd created
operatorgroup.operators.coreos.com/openshift-cluster-csi-driversjw9cd created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
13.3.3. Installing the Nutanix CSI Operator Link kopierenLink in die Zwischenablage kopiert!
The Nutanix Container Storage Interface (CSI) Operator for Kubernetes deploys and manages the Nutanix CSI Driver.
For instructions on performing this step through the Red Hat OpenShift Container Platform, see the Installing the Operator section of the Nutanix CSI Operator document in Additional Resources.
Procedure
Get the parameter values for the Nutanix CSI Operator YAML file:
Check that the Nutanix CSI Operator exists:
oc get packagemanifests | grep nutanix
$ oc get packagemanifests | grep nutanix
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
nutanixcsioperator Certified Operators 129m
nutanixcsioperator Certified Operators 129m
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Assign the default channel for the Operator to a BASH variable:
DEFAULT_CHANNEL=$(oc get packagemanifests nutanixcsioperator -o jsonpath={.status.defaultChannel})
$ DEFAULT_CHANNEL=$(oc get packagemanifests nutanixcsioperator -o jsonpath={.status.defaultChannel})
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Assign the starting cluster service version (CSV) for the Operator to a BASH variable:
STARTING_CSV=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.channels[*].currentCSV\})
$ STARTING_CSV=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.channels[*].currentCSV\})
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Assign the catalog source for the subscription to a BASH variable:
CATALOG_SOURCE=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.catalogSource\})
$ CATALOG_SOURCE=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.catalogSource\})
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Assign the Nutanix CSI Operator source namespace to a BASH variable:
SOURCE_NAMESPACE=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.catalogSourceNamespace\})
$ SOURCE_NAMESPACE=$(oc get packagemanifests nutanixcsioperator -o jsonpath=\{.status.catalogSourceNamespace\})
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Create the Nutanix CSI Operator YAML file using the BASH variables:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create the CSI Nutanix Operator:
oc apply -f nutanixcsioperator.yaml
$ oc apply -f nutanixcsioperator.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
subscription.operators.coreos.com/nutanixcsioperator created
subscription.operators.coreos.com/nutanixcsioperator created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Run the following command until the Operator subscription state changes to
AtLatestKnown
. This indicates that the Operator subscription has been created, and may take some time.oc get subscription nutanixcsioperator -n openshift-cluster-csi-drivers -o 'jsonpath={..status.state}'
$ oc get subscription nutanixcsioperator -n openshift-cluster-csi-drivers -o 'jsonpath={..status.state}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
13.3.4. Deploying the Nutanix CSI storage driver Link kopierenLink in die Zwischenablage kopiert!
The Nutanix Container Storage Interface (CSI) Driver for Kubernetes provides scalable and persistent storage for stateful applications.
For instructions on performing this step through the Red Hat OpenShift Container Platform, see the Installing the CSI Driver using the Operator section of the Nutanix CSI Operator document in Additional Resources.
Procedure
Create a
NutanixCsiStorage
resource to deploy the driver:Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
snutanixcsistorage.crd.nutanix.com/nutanixcsistorage created
snutanixcsistorage.crd.nutanix.com/nutanixcsistorage created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create a Nutanix secret YAML file for the CSI storage driver:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Note- 1
- Replace these parameters with actual values while keeping the same format.
Sample output
secret/nutanix-secret created
secret/nutanix-secret created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
13.3.5. Validating the post-installation configurations Link kopierenLink in die Zwischenablage kopiert!
Run the following steps to validate the configuration.
Procedure
Verify that you can create a storage class:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Note- 1
- Take <nutanix_storage_container> from the Nutanix configuration; for example, SelfServiceContainer.
Sample output
storageclass.storage.k8s.io/nutanix-volume created
storageclass.storage.k8s.io/nutanix-volume created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Verify that you can create the Nutanix persistent volume claim (PVC):
Create the persistent volume claim (PVC):
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
persistentvolumeclaim/nutanix-volume-pvc created
persistentvolumeclaim/nutanix-volume-pvc created
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Validate that the persistent volume claim (PVC) status is Bound:
oc get pvc -n openshift-cluster-csi-drivers
$ oc get pvc -n openshift-cluster-csi-drivers
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sample output
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE nutanix-volume-pvc Bound nutanix-volume 52s
NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE nutanix-volume-pvc Bound nutanix-volume 52s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow