Chapitre 11. Installing on Nutanix
11.1. Preparing to install on Nutanix Copier lienLien copié sur presse-papiers!
Before you install an OpenShift Container Platform cluster, be sure that your Nutanix environment meets the following requirements.
11.1.1. Nutanix version requirements Copier lienLien copié sur presse-papiers!
You must install the OpenShift Container Platform cluster to a Nutanix environment that meets the following requirements.
Composant | Required version |
---|---|
Nutanix AOS | 5.20.4+ or 6.5.1+ |
Prism Central | 2022.4+ |
11.1.2. Environment requirements Copier lienLien copié sur presse-papiers!
Before you install an OpenShift Container Platform cluster, review the following Nutanix AOS environment requirements.
11.1.2.1. Required account privileges Copier lienLien copié sur presse-papiers!
Installing a cluster to Nutanix requires an account with administrative privileges to read and create the required resources.
11.1.2.2. Cluster limits Copier lienLien copié sur presse-papiers!
Available resources vary between clusters. The number of possible clusters within a Nutanix environment is limited primarily by available storage space and any limitations associated with the resources that the cluster creates, and resources that you require to deploy the cluster, such a IP addresses and networks.
11.1.2.3. Cluster resources Copier lienLien copié sur presse-papiers!
A minimum of 800 GB of storage is required to use a standard cluster.
When you deploy a OpenShift Container Platform cluster that uses installer-provisioned infrastructure, the installation program must be able to create several resources in your Nutanix instance. Although these resources use 856 GB of storage, the bootstrap node is destroyed as part of the installation process.
A standard OpenShift Container Platform installation creates the following resources:
- 1 label
Virtual machines:
- 1 disk image
- 1 temporary bootstrap node
- 3 control plane nodes
- 3 compute machines
11.1.2.4. Networking requirements Copier lienLien copié sur presse-papiers!
You must use AHV IP Address Management (IPAM) for the network and ensure that it is configured to provide persistent IP addresses to the cluster machines. Additionally, create the following networking resources before you install the OpenShift Container Platform cluster:
- IP addresses
- DNS records
It is recommended that each OpenShift Container Platform node in the cluster have access to a Network Time Protocol (NTP) server that is discoverable via DHCP. Installation is possible without an NTP server. However, an NTP server prevents errors typically associated with asynchronous server clocks.
11.1.2.4.1. Required IP Addresses Copier lienLien copié sur presse-papiers!
An installer-provisioned installation requires two static virtual IP (VIP) addresses:
- A VIP address for the API is required. This address is used to access the cluster API.
- A VIP address for ingress is required. This address is used for cluster ingress traffic.
You specify these IP addresses when you install the OpenShift Container Platform cluster.
11.1.2.4.2. DNS records Copier lienLien copié sur presse-papiers!
You must create DNS records for two static IP addresses in the appropriate DNS server for the Nutanix instance that hosts your OpenShift Container Platform cluster. In each record, <cluster_name>
is the cluster name and <base_domain>
is the cluster base domain that you specify when you install the cluster.
A complete DNS record takes the form: <component>.<cluster_name>.<base_domain>.
.
Composant | Record | Description |
---|---|---|
API VIP |
| This DNS A/AAAA or CNAME record must point to the load balancer for the control plane machines. This record must be resolvable by both clients external to the cluster and from all the nodes within the cluster. |
Ingress VIP |
| A wildcard DNS A/AAAA or CNAME record that points to the load balancer that targets the machines that run the Ingress router pods, which are the worker nodes by default. This record must be resolvable by both clients external to the cluster and from all the nodes within the cluster. |
11.1.3. Configuration de l'utilitaire Cloud Credential Operator Copier lienLien copié sur presse-papiers!
The Cloud Credential Operator (CCO) manages cloud provider credentials as Kubernetes custom resource definitions (CRDs). To install a cluster on Nutanix, you must set the CCO to manual
mode as part of the installation process.
Pour créer et gérer des informations d'identification du nuage depuis l'extérieur du cluster lorsque le Cloud Credential Operator (CCO) fonctionne en mode manuel, extrayez et préparez le binaire de l'utilitaire CCO (ccoctl
).
L'utilitaire ccoctl
est un binaire Linux qui doit être exécuté dans un environnement Linux.
Conditions préalables
- Vous avez accès à un compte OpenShift Container Platform avec un accès administrateur de cluster.
-
Vous avez installé l'OpenShift CLI (
oc
).
Procédure
Obtenez l'image de la version d'OpenShift Container Platform en exécutant la commande suivante :
RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')
$ RELEASE_IMAGE=$(./openshift-install version | awk '/release image/ {print $3}')
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Obtenez l'image du conteneur CCO à partir de l'image de la version d'OpenShift Container Platform en exécutant la commande suivante :
CCO_IMAGE=$(oc adm release info --image-for='cloud-credential-operator' $RELEASE_IMAGE -a ~/.pull-secret)
$ CCO_IMAGE=$(oc adm release info --image-for='cloud-credential-operator' $RELEASE_IMAGE -a ~/.pull-secret)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NoteVeillez à ce que l'architecture de
$RELEASE_IMAGE
corresponde à l'architecture de l'environnement dans lequel vous utiliserez l'outilccoctl
.Extrayez le binaire
ccoctl
de l'image du conteneur CCO dans l'image de la version d'OpenShift Container Platform en exécutant la commande suivante :oc image extract $CCO_IMAGE --file="/usr/bin/ccoctl" -a ~/.pull-secret
$ oc image extract $CCO_IMAGE --file="/usr/bin/ccoctl" -a ~/.pull-secret
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Modifiez les autorisations pour rendre
ccoctl
exécutable en exécutant la commande suivante :chmod 775 ccoctl
$ chmod 775 ccoctl
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Vérification
Pour vérifier que
ccoctl
est prêt à être utilisé, affichez le fichier d'aide en exécutant la commande suivante :ccoctl --help
$ ccoctl --help
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Sortie de
ccoctl --help
:Copy to Clipboard Copied! Toggle word wrap Toggle overflow