Installation d'une grappe avec un programme d'installation basé sur un agent à l'aide de Terraform
Voyez comment provisionner l'infrastructure OCI pour la plate-forme de conteneur Red Hat OpenShift à l'aide d'un script Terraform avec le programme d'installation basé sur un agent.
Utilisez le plugiciel Red Hat OpenShift pour provisionner automatiquement l'infrastructure avec Terraform. La dernière version de la pile Terraform est disponible dans la page Informations sur la pile du plugiciel Red Hat OpenShift.
Vous pouvez accéder aux versions antérieures de Terraform à partir de la page OpenShift sur les versions OCI sur GitHub. Téléchargez la version requise du fichier create-cluster.zip
à partir de la section Actifs.
- Exécutez la pile
create-resource-attribution-tags
avant d'exécuter la pilecreate-cluster
pour éviter l'échec de l'installation. Pour plus d'informations, voir la rubrique Préalables. - La pile
create-resource-attribution-tags
ne doit être exécutée qu'une seule fois. Si l'espace de noms de marqueur et les marqueurs définis existent déjà, vous pouvez ignorer cette étape pour les installations futures. - OpenShift nécessite des autorisations de gestion pour effectuer des opérations sur des instances, des volumes et des ressources de réseau. Déployez OpenShift dans un compartiment dédié pour éviter les conflits avec d'autres applications qui pourraient s'exécuter dans le même compartiment.
Voir Ressources définies par Terraform pour OpenShift pour obtenir la liste des ressources créées par la pile.
- Ouvrez le menu de navigation et sélectionnez Services de développement, puis Red Hat OpenShift.
-
Dans la page Informations sur la pile, entrez un nom et une description facultatifs.
- La dernière version de la pile Terraform est automatiquement chargée pour vous.
- Les champs Créer dans le compartiment et Version Terraform sont préalimentés.
- Dans la page Configurer les variables, vérifiez et configurez les variables requises pour les ressources d'infrastructure créées par la pile lorsque vous exécutez la tâche Appliquer pour la première fois.
-
Dans la section Configuration de la grappe OpenShift :
- Remplacez la méthode d'installation par basée sur un agent.
- Configurer le calcul et le nombre de plans de contrôle. Ces valeurs sont utilisées lors de la génération du fichier
install-config.yaml
pour le programme d'installation basé sur un agent. - Désélectionnez la case Créer une image et des instances OpenShift.
OpenShift Configuration de la grappe
Champ Description OCID de la location OCID de la location courante.
Valeur par défaut : Location courante
Compartiment du compartiment OCID du compartiment dans lequel vous voulez créer la grappe OpenShift.
Valeur par défaut : Compartiment courant
Nom de la grappe Nom de la grappe OpenShift.
Note : Utilisez la même valeur pour le nom de grappe que vous avez spécifié dans vos fichiers
agent-config.yaml
etinstall-config.yaml
et assurez-vous qu'il est compatible avec le DNS.Méthode d'installation Méthode d'installation à utiliser pour installer la grappe.
Remarque : Pour une installation basée sur un agent, sélectionnez Basée sur un agent.
Valeur par défaut : Programme d'installation assisté
Créer une image et des instances OpenShift Active la création de l'image et des instances OpenShift.
Valeur par défaut : Vrai
URI de la source de l'image OpenShift URL de demande préauthentifiée créée dans la tâche précédente, Chargement d'une image ISO Red Hat dans le stockage d'objets.
Note : Ce champ est visible uniquement lorsque la case Créer une image et des instances OpenShift est cochée ultérieurement.
-
Dans la section OpenShift Marqueurs d'attribution de ressource , vérifiez et configurez les champs suivants :
OpenShift Marqueurs d'attribution de ressource
Champ Description Compartiment de l'espace de noms de marqueur pour les marqueurs d'attribution de ressource OpenShift Compartiment de l'espace de noms de marqueur pour les marqueurs d'attribution de ressource OpenShift.
Note : Assurez-vous que le marqueur spécifié existe avant d'appliquer la pile Terraform. Le compartiment dans lequel l'espace de noms de marqueur pour le marquage des ressources est créé prend par défaut le compartiment courant. Pour l'attribution OpenShift sur les ressources OCI, l'espace de noms de marqueur et les marqueurs définis sont réglés à
openshift-tags
etopenshift-resource
. Si l'espace de noms openshift-tags existe déjà, assurez-vous qu'il est correctement défini et appliqué. Par exemple :defined-tags" - {"openshift-tags"- {"openshift-resource" - "openshift-resource-infra"} }
-
Dans la section Configurations avancées d'installation basées sur un agent, vérifiez et configurez les champs suivants :
Note
Cette section n'apparaît que lorsque la valeur Méthode d'installation est réglée à Programme d'installation basé sur un agent.Configurations avancées d'installation basées sur un agentChamp Description Adresse IP du rendez-vous Adresse IP utilisée pour amorcer la grappe à l'aide du programme d'installation basé sur un agent. Doit se trouver dans le sous-réseau
private_ocp
.Installation basée sur un agent déconnecté Indique si la grappe est en cours d'installation dans un environnement déconnecté (air-gapped). Si vous cochez cette case, vous pouvez également créer un serveur Web, qui peut être utilisé pour héberger le fichier
agent.x86_64-rootfs.img
et faciliter l'installation basée sur un agent.Valeur par défaut : Faux
Définir la version du programme d'installation OpenShift Version du programme d'installation OpenShift à utiliser. Spécifiez une version prise en charge spécifique si vous ne voulez pas la dernière version. Par exemple, 4.19.1.
Valeur par défaut : Faux
Version du programme d'installation OpenShift Version du programme d'installation OpenShift. Vous pouvez trouver une liste des versions publiées dans la page Téléchargements de clientsOpenShift.
Valeur par défaut : Dernière valeur
SSH public Clé SSH publique à utiliser par le serveur Web.
Note : Cette clé est également ajoutée au fichier
install-config.yaml
et est requise pour fournir l'accès aux instances Openshift.Clé secrète d'extraction Red Hat Clé secrète à extraire pour l'authentification lors du téléchargement des images de conteneur pour les composants et services de la plate-forme de conteneur OpenShift à partir de sources telles que Quay.io. Pour plus d'informations, voir Installer OpenShift Container Platform 4.
Espace de noms du stockage d'objets Espace de noms du stockage OCI pour la location. Vous pouvez trouver cette valeur dans la page Détails du seau de votre bukcet. Pour plus d'informations, voir Espaces de noms du stockage d'objets.
Seau de stockage d'objets Seau de stockage d'objets OCI dans lequel les fichiers d'installation OpenShift sont stockés. Adresse IP privée du serveur Web Adresse IP privée du serveur sur lequel vous voulez charger l'image rootfs
. Ce paramètre est requis uniquement pour les environnements déconnectés. Cette adresse IP doit être incluse dans la valeurbootArtifactsBaseURL
du fichieragent-config.yaml
.Forme du serveur Web Forme d'instance de calcul de l'instance de serveur Web. Pour plus d'informations, voir Formes prises en charge. Image du serveur Web source_id de l'image à utiliser pour l'instance de serveur Web. Si une image n'est pas présélectionnée, sélectionnez-la dans une liste d'images Oracle Linux disponibles.
OCPU du serveur Web Nombre d'OCPU disponibles pour l'instance de forme de serveur Web.
Valeur par défaut : 2
Mémoire du serveur Web Quantité de mémoire disponible, en gigaoctets, pour l'instance de forme de serveur Web.
Valeur par défaut : 8
Paramètres du mandataire de configuration Fournissez des informations supplémentaires sur le mandataire si les hôtes se trouvent derrière un pare-feu qui nécessite l'utilisation d'un mandataire. URL du mandataire HTTP Spécifiez l'URL du mandataire HTTP. Par exemple http://my.proxy.server.
URL du mandataire HTPPS Spécifiez l'URL du mandataire HTTPs. Par exemple https://my.proxy.server.
Aucun domaine mandataire Indiquez l'option No Proxy Domains. Par exemple, localhost,127.0.0.1,{basedomain}
. -
Dans la section Configuration du réseau, vérifiez et configurez les champs suivants :
Configuration de réseau
Champ Description Créer un DNS public Créez une zone DNS publique en fonction du domaine de base spécifié dans le champ DNS de zone.
Note : Si vous ne voulez pas créer un DNS public, créez une zone DNS privée à moins d'utiliser votre propre solution DNS. Pour résoudre les noms d'hôte de grappe sans DNS, ajoutez des entrées à
/etc/hosts
qui mappent les noms d'hôte de grappe à l'adresse IP de l'équilibreur de chargeapi_apps
à l'aide de la sortieetc_hosts_entry
.Valeur par défaut : Vrai
Créer un DNS privé Crée une zone DNS privée basée sur le domaine de base, spécifié dans le champ DNS de zone, pour prendre en charge la résolution de nom d'hôte dans le VCN.
Note : La zone DNS privée contient les mêmes enregistrements que la zone DNS publique. Si vous utilisez un domaine de base non enregistré, nous vous recommandons de créer une zone DNS privée. Sinon, vous devrez peut-être utiliser d'autres méthodes pour résoudre les noms d'hôte de grappe. Pour plus d'informations, voir DNS privé.
Valeur par défaut : Faux
Activer l'équilibreur de charge d'API public Crée un équilibreur de charge pour le point d'extrémité de l'API OpenShift dans le sous-réseau public avec une adresse IP publique pour l'accès externe.
Note : Si cette option n'est pas sélectionnée, l'équilibreur de charge est créé dans un sous-réseau privé avec un accès limité au sein du VCN ou des réseaux privés connectés. Dans les environnements sur place (par exemple, C3/PCA), les adresses IP publiques peuvent être internes (RFC 1918). L'accès public est utile pour la gestion à distance, l'automatisation et l'intégration et le développement en continu. Communiquez avec l'administrateur de réseau si nécessaire.
Valeur par défaut : Faux
Activer l'équilibreur de charge des applications publiques Crée un équilibreur de charge pour les applications OpenShift dans le sous-réseau public avec une adresse IP publique pour l'accès externe aux charges de travail. Par exemple,
console-openshift-console.apps.mycluster.mydomain.com
ouconsole-openshift-console.apps.devcluster.openshift.com
Note : Si cette option n'est pas sélectionnée, l'équilibreur de charge est créé dans un sous-réseau privé, ce qui limite l'accès au sein du VCN ou au moyen d'un réseau privé virtuel/privé. L'accès public est utile pour les applications accessibles sur Internet, les services à la clientèle ou les charges de travail multilocataires. Dans les configurations sur place (par exemple, C3/PCA), les adresses IP publiques peuvent être internes (RFC 1918). Contactez votre équipe réseau pour assurer une bonne exposition.
Valeur par défaut : Vrai
DNS de zone Domaine de base pour les enregistrements DNS de votre grappe (par exemple, devcluster.openshift.com
), utilisé pour créer des zones DNS publiques ou privées (ou les deux). Cette valeur doit correspondre à ce qui est spécifié pourbaseDomain
dans le fichierinstall-config.yaml
.Étiquette DNS du VCN Étiquette DNS du VCN, utilisée avec le nom d'hôte de la carte VNIC et l'étiquette DNS du sous-réseau pour former un nom de domaine complet pour chaque carte VNIC du sous-réseau (par exemple,
bminstance1.subnet123.vcn1.oraclevcn.com
).Valeur par défaut : openshiftvcn
Utiliser l'infrastructure de réseau existante Indiquez si vous souhaitez utiliser l'infrastructure existante. Valeur par défaut : Faux
Compartiment du service de réseau Sélectionnez le compartiment où se trouvent les ressources de réseau existantes. Cela peut être différent ou identique au compartiment principal où les ressources OpenShift sont créées. Valeur par défaut : Compartiment courant
VCN existant OCID du VCN existant à utiliser lorsque use_existing_network
est Vrai.Sous-réseau privé existant pour OCP OCID du sous-réseau privé existant à utiliser pour l'OCP lorsque use_existing_network
est Vrai.Sous-réseau privé existant sans système d'exploitation OCID du sous-réseau privé existant à utiliser sans système d'exploitation lorsque use_existing_network
est Vrai. Cela doit être différent du sous-réseauprivate_ocp
, sinon vous pourriez rencontrer des problèmes.Bloc CIDR du réseau en nuage virtuel Blocs IPv4 CIDR pour le VCN de votre grappe OpenShift.
Valeur par défaut : 10.0.0.0/16
CIDR de sous-réseau public Blocs IPv4 CIDR pour le sous-réseau public de votre grappe OpenShift.
Valeur par défaut : 10.0.0.0/20
Bloc CIDR de sous-réseau privé pour OCP Blocs IPv4 CIDR pour le sous-réseau privé de votre grappe OpenShift.
Valeur par défaut : 10.0.16.0/20
Bloc CIDR de sous-réseau privé réservé pour les instances sans système d'exploitation Blocs IPv4 CIDR pour le sous-réseau privé des grappes sans système d'exploitation OpenShift.
Valeur par défaut : 10.0.32.0/20
bande passante maximale de l'équilibreur de charge Bande passante (Mbps) qui détermine la bande passante maximale (entrante et sortante) que l'équilibreur de charge peut atteindre. Les valeurs doivent être comprises entre
minimumBandwidthInMbps
et 8000.Valeur par défaut : 500
Bande passante minimale de l'équilibreur de charge Bande passante (Mbps qui détermine la bande passante préprovisionnée totale (entrante plus sortante). Les valeurs doivent être comprises entre 10 et
maximumBandwidthInMbps
.Valeur par défaut : 10
-
(Facultatif) Dans la section Configuration avancée, vérifiez et configurez les champs suivants :
Configurations avancées
Champ Description Version du pilote CCM et CSI OCI Version du pilote CCM et CSI OCI à déployer. Pour plus d'informations, consultez la liste des versions de pilote.
Valeur par défaut : v1.32.0
Utiliser des marqueurs de rôle d'instance existants Indique s'il faut réutiliser l'espace de noms de marqueur de rôle d'instance existant et les marqueurs définis lors du marquage des ressources OCI. Par défaut, un nouveau jeu de ressources de marquage de rôle d'instance est créé et détruit avec le reste des ressources de grappe.
Si nécessaire, créez des ressources de marqueur de rôle d'instance séparément qui peuvent être réutilisées avec la pile Terraform à partir de la page create-instance-role-tags dans le référentiel oci-openshift GitHub. Les ressources de marquage de rôle d'instance existantes ne sont pas détruites lorsque la grappe est supprimée.
Valeur par défaut : Faux
(Facultatif) Nom de l'espace de noms de marqueur du rôle d'instance Nom de l'espace de noms de marqueur du rôle d'instance à réutiliser.
Note : Ce champ est visible uniquement lorsque la case Utiliser des marqueurs de rôle d'instance existants est cochée.
Valeur par défaut : openshift-{cluster_name}
OCID du compartiment de l'espace de noms du marqueur de rôle d'instance Compartiment contenant l'espace de noms de marqueur du rôle d'instance existant.
Note : Ce champ est visible uniquement lorsque la case Utiliser des marqueurs de rôle d'instance existants est cochée.
Valeur par défaut : Compartiment courant
- Sélectionnez Suivant.
- Dans la page Vérifier, vérifiez les informations et les variables de la pile.
- Sélectionnez Créer pour créer la pile. La console redirige vers la page des détails de la pile du gestionnaire de ressources pour la nouvelle pile.
-
Dans la page des détails de la pile, sélectionnez Appliquer pour créer une tâche d'application et provisionner l'infrastructure pour la grappe. Après avoir exécuté une tâche d'application, obtenez les détails de la tâche pour vérifier son statut. Réussite (
SUCCEEDED
) indique que la tâche est terminée. Une fois l'opération terminée, toutes les ressources OpenShift sont créées, à l'exception de l'image ISO et des instances de calcul. - Dans la page Piles du gestionnaire de ressources, sélectionnez le nom de la pile pour voir ses détails. Si la vue de liste des tâches n'est pas affichée, sélectionnez Tâches dans la section Ressources pour voir la liste des tâches.
- Sélectionnez la tâche pour la création de la pile. La page Détails de la tâche est affichée dans la console.
- Sélectionnez Sorties dans la section Ressources pour voir la liste des sorties pour la tâche.
-
(Facultatif) Sélectionnez Afficher pour voir et vérifier le contenu des sorties basées sur un agent pertinentes :
agent_config
,install_config
,dynamic_custom_manifest
. -
Sélectionnez Copier pour copier le contenu des sorties basées sur un agent.
Note
- Nous vous recommandons de ne pas sélectionner et copier manuellement le texte, car cela peut causer des problèmes d'indentation lorsque vous collez cette sortie à l'étape suivante.
- Pour les installations déconnectées avec un serveur Web, les fichiers de sortie sont déjà disponibles sur le serveur Web prêt à l'emploi. Elles sont également disponibles dans votre compartiment de stockage d'objets.
-
À l'aide d'un éditeur de texte ou de code, enregistrez les sorties copiées dans les fichiers suivants :
agent-config.yaml
,install-config.yaml
,dynamic-custom-manifest.yaml
. Vous pouvez également les télécharger à partir du seau de stockage d'objets. -
Créez des fichiers de configuration et une image ISO amorçable pour l'installation de votre grappe. Voir Création de fichiers de configuration pour installer une grappe sur OCI (documentation sur Red Hat) pour obtenir des instructions sur :
- Préparation et personnalisation des fichiers d'installation.
- Téléchargement d'un programme d'installation basé sur un agent.
- Génération de l'image ISO.
- (Pour les environnements déconnectés) Déplacement de l'image
rootfs
vers/var/www/html
sur votre serveur Web. - Enregistrement de
kubeconfig
etkubeadmin-password
à partir du dossier d'authentification.
Revenez à cette documentation après avoir créé les fichiers de configuration et l'image ISO, puis poursuivez l'installation. - Chargez le fichier d'image ISO de détection dans un seau du service de stockage d'objets pour OCI. Pour insérer des données dans le stockage d'objets, si vous avez besoin d'instructions.
- Naviguez jusqu'au service Gestionnaire de ressources et accédez à la page des détails de la pile que vous avez créée pour installer OpenShift.
- Sous Ressources, sélectionnez Variables.
- Sélectionnez Modifier les variables.
-
Dans la section Configuration de la grappe OpenShift :
- Cochez la case Créer une image et des instances OpenShift.
- Collez la chaîne de demande préauthentifiée dans le champ URI de la source de l'image OpenShift.
-
Vérifiez les valeurs des sections Configuration des noeuds du plan de contrôle et Configuration des noeuds de calcul.
Note
Assurez-vous que les valeurs Nombre de noeuds du plan de contrôle et Nombre de noeuds de calcul correspondent aux valeurs du fichierinstall-config.yaml
lors de la création de l'image.Configuration des noeuds du plan de contrôleNote : Cette section est visible uniquement lorsque la case Créer une image et des instances OpenShift est cochée.
Champ Description Forme du plan de contrôle Forme d'instance de calcul des noeuds de plan de contrôle. Pour plus d'informations, voir Formes de calcul.
Valeur par défaut : VM.Standard.E5. Champ flexible
Nombre de noeuds du plan de contrôle Nombre de noeuds de plan de contrôle dans la grappe.
Valeur par défaut : 3
OCPU de noeud de plan de contrôle Nombre d'OCPU disponibles pour chaque forme de noeud de plan de contrôle.
Valeur par défaut : 4
Mémoire du noeud du plan de contrôle Quantité de mémoire disponible, en gigaoctets (Go), pour chaque forme de noeud de plan de contrôle.
Valeur par défaut : 24
Volume de démarrage du noeud de plan de contrôle Taille du volume de démarrage (Go) de chaque noeud de plan de contrôle.
Valeur par défaut : 1024
Unité virtuelle de noeud de plan de contrôle Nombre d'unités de performance de volume (UPV) appliquées au volume, par 1 Go, de chaque noeud de plan de contrôle.
Valeur par défaut : 100
Répartir les instances de plan de contrôle entre les domaines de disponibilité Active la répartition automatique des instances de plan de contrôle entre les domaines de disponibilité dans une séquence tourniquetée, à partir du domaine de disponibilité sélectionné. Si cette option n'est pas sélectionnée, tous les noeuds sont créés dans le domaine de disponibilité de départ sélectionné.
Valeur par défaut : Vrai
(Facultatif) Démarrage du domaine de disponibilité Domaine de disponibilité utilisé pour le positionnement initial du noeud. Les noeuds supplémentaires sont automatiquement répartis entre les domaines de disponibilité dans une séquence tourniquet, à partir du domaine de disponibilité sélectionné.
Répartir les instances de plan de contrôle entre les fichiers de configuration Répartit les instances de plan de contrôle entre les domaines d'erreur en cas de circuit cyclique. Si cette option n'est pas sélectionnée, le service de calcul d'OCI les répartit en fonction de la disponibilité de la forme et d'autres critères.
Valeur par défaut : Vrai
Configuration des noeuds de calculNote : Cette section est visible uniquement lorsque la case Créer une image et des instances OpenShift est cochée.
Champ Description Forme de calcul Forme d'instance des noeuds de calcul. Pour plus d'informations, voir Formes de calcul.
Valeur par défaut : VM.Standard.E5. Champ flexible
Nombre de noeuds de calcul Nombre de noeuds de calcul dans la grappe.
Valeur par défaut : 3
OCPU de noeud de calcul Nombre d'OCPU disponibles pour chaque forme de noeud de calcul.
Valeur par défaut : 6
Mémoire du noeud de calcul Quantité de mémoire disponible, en gigaoctets (Go), pour chaque forme de noeud de plan de contrôle.
Valeur par défaut : 16
Volume de démarrage du noeud de calcul Taille du volume de démarrage (Go) de chaque noeud de plan de contrôle.
Valeur par défaut : 100
UPV de noeud de calcul Nombre d'unités de performance de volume (UPV) appliquées au volume, par 1 Go, de chaque noeud de calcul.
Valeur par défaut : 30
Répartir les instances de calcul entre les domaines de disponibilité Permet la répartition automatique des instances de calcul entre les domaines de disponibilité dans une séquence cyclique, à partir du domaine de disponibilité sélectionné. Si cette option n'est pas sélectionnée, tous les noeuds sont créés dans le domaine de disponibilité de départ sélectionné.
Valeur par défaut : Vrai
(Facultatif) Démarrage du domaine de disponibilité Domaine de disponibilité utilisé pour le positionnement initial du noeud. Les noeuds supplémentaires sont automatiquement répartis entre les domaines de disponibilité dans une séquence tourniquet, à partir du domaine de disponibilité sélectionné.
Répartir les instances de calcul entre les fichiers FD Répartit les instances de calcul sur les domaines d'erreur en cascade. Si cette option n'est pas sélectionnée, le service de calcul d'OCI les répartit en fonction de la disponibilité de la forme et d'autres critères.
Valeur par défaut : Vrai
-
Dans la section Configuration avancée de l'installation basée sur un agent, notez la valeur dans le champ Adresse IP de rendez-vous. Cette adresse IP est affectée à l'une des instances de plan de contrôle, qui agit ensuite comme noeud d'amorçage pour la grappe. Vous pouvez accéder au noeud de grappe d'amorçage à partir du serveur Web pour surveiller le processus d'installation.
ssh -i id_rsa core@<rendezvous_ip>
Une fois connecté, exécutez la commande suivante pour surveiller les journaux sur le noeud d'amorçage :journalctl -f
Avant d'exécuter la commande SSH, chargez votre clé SSH privée
id_rsa
sur le serveur Web.scp ~/.ssh/id_rsa opc@<webserver_public_ip>:/home/opc
Note
- La valeur du champ Adresse IP de rendez-vous doit correspondre à
rendezvousIP
dansagent-config.yaml
. - Ne modifiez aucune configuration dans la section Configuration avancée d'installation basée sur un agent au cours de cette étape.
- La valeur du champ Adresse IP de rendez-vous doit correspondre à
- Sélectionnez Suivant pour vérifier et enregistrer les modifications.
-
Dans la page des détails de la pile, sélectionnez Appliquer pour exécuter une autre tâche d'application pour la pile. La tâche crée l'image logicielle personnalisée utilisée par les instances de calcul de la grappe et provisionne les instances de calcul. Une fois les instances de calcul provisionnées par la pile, l'installation de la grappe commence automatiquement.
Étape suivante Suivez les instructions sous Vérification de l'exécution de l'installation de la grappe basée sur un agent sur OCI (documentation sur Red Hat) pour vérifier que votre grappe est en cours d'exécution. Cette étape est effectuée dans l'interface de ligne de commande de la plate-forme conteneur OpenShift.