Chapitre 2. Configuration de l'opérateur Cluster Samples
Le Cluster Samples Operator, qui opère dans l'espace de noms openshift, installe et met à jour les flux d'images OpenShift Container Platform basés sur Red Hat Enterprise Linux (RHEL) et les modèles OpenShift Container Platform.
2.1. Comprendre l'opérateur Cluster Samples
Lors de l'installation, l'opérateur crée l'objet de configuration par défaut pour lui-même, puis crée les flux d'images et les modèles d'échantillons, y compris les modèles de démarrage rapide.
Pour faciliter les importations de flux d'images à partir d'autres registres nécessitant des informations d'identification, un administrateur de cluster peut créer des secrets supplémentaires contenant le contenu d'un fichier Docker config.json dans l'espace de noms openshift nécessaire à l'importation d'images.
La configuration du Cluster Samples Operator est une ressource à l'échelle du cluster, et le déploiement est contenu dans l'espace de noms openshift-cluster-samples-operator.
L'image de l'opérateur d'échantillons de clusters contient des définitions de flux d'images et de modèles pour la version associée d'OpenShift Container Platform. Lorsque chaque échantillon est créé ou mis à jour, le Cluster Samples Operator inclut une annotation qui indique la version d'OpenShift Container Platform. L'opérateur utilise cette annotation pour s'assurer que chaque échantillon correspond à la version. Les échantillons qui ne font pas partie de son inventaire sont ignorés, tout comme les échantillons ignorés. Les modifications apportées aux échantillons gérés par l'opérateur, lorsque l'annotation de la version est modifiée ou supprimée, sont automatiquement annulées.
Les images Jenkins font partie de la charge utile de l'installation et sont directement intégrées dans les flux d'images.
La ressource de configuration Cluster Samples Operator comprend un finalisateur qui nettoie les éléments suivants lors de la suppression :
- Flux d'images gérés par l'opérateur.
- Modèles gérés par l'opérateur.
- Ressources de configuration générées par l'opérateur.
- Ressources sur l'état des clusters.
Lors de la suppression de la ressource d'échantillons, l'opérateur de cluster d'échantillons recrée la ressource en utilisant la configuration par défaut.
2.1.1. Échantillons en grappes Utilisation de l'état de gestion par l'opérateur
Le Cluster Samples Operator est démarré en tant que Managed par défaut ou si un proxy global est configuré. Dans l'état Managed, le Cluster Samples Operator gère activement ses ressources et maintient le composant actif afin d'extraire les flux d'images d'échantillons et les images du registre et de s'assurer que les modèles d'échantillons requis sont installés.
Dans certaines circonstances, l'opérateur d'échantillonnage en grappes s'amorce lui-même comme Removed, y compris :
- Si le Cluster Samples Operator ne peut pas atteindre registry.redhat.io après trois minutes lors du démarrage initial après une installation propre.
- Si le Cluster Samples Operator détecte qu'il se trouve sur un réseau IPv6.
-
Si les paramètres de configuration du contrôleur d'images empêchent la création de flux d'images en utilisant le registre d'images par défaut ou le registre d'images spécifié par le paramètre
samplesRegistry.
Pour OpenShift Container Platform, le registre d'images par défaut est registry.redhat.io.
Cependant, si le Cluster Samples Operator détecte qu'il est sur un réseau IPv6 et qu'un proxy global OpenShift Container Platform est configuré, alors la vérification IPv6 remplace toutes les vérifications. Par conséquent, le Cluster Samples Operator s'amorce lui-même en tant que Removed.
Les installations IPv6 ne sont actuellement pas prises en charge par registry.redhat.io. L'opérateur d'échantillons de clusters extrait la plupart des flux d'images d'échantillons et des images de registry.redhat.io.
2.1.1.1. Installation restreinte du réseau
L'amorçage en tant que Removed lorsqu'il est impossible d'accéder à registry.redhat.io facilite les installations réseau restreintes lorsque la restriction réseau est déjà en place. L'amorçage en tant que Removed lorsque l'accès au réseau est restreint donne à l'administrateur de la grappe plus de temps pour décider si des échantillons sont souhaités, car l'opérateur d'échantillons de grappe ne soumet pas d'alertes indiquant que les importations de flux d'images d'échantillons échouent lorsque l'état de gestion est défini sur Removed. Lorsque l'opérateur d'échantillons de grappe se présente en tant que Managed et tente d'installer des flux d'images d'échantillons, il commence à émettre des alertes deux heures après l'installation initiale en cas d'échec des importations.
2.1.1.2. Installation d'un réseau restreint avec accès initial au réseau
Inversement, si un cluster destiné à être un réseau restreint ou un cluster déconnecté est installé pour la première fois alors que l'accès au réseau existe, le Cluster Samples Operator installe le contenu à partir de registry.redhat.io puisqu'il peut y accéder. Si vous souhaitez que le Cluster Samples Operator démarre toujours en tant que Removed afin de différer l'installation des échantillons jusqu'à ce que vous ayez décidé quels échantillons sont souhaités, mis en place des miroirs d'image, etc., suivez alors les instructions pour utiliser le Samples Operator avec un registre alternatif et des nœuds de personnalisation, tous deux liés dans la section des ressources supplémentaires, pour remplacer la configuration par défaut du Cluster Samples Operator et s'afficher initialement en tant que Removed.
Vous devez placer le fichier YAML supplémentaire suivant dans le répertoire openshift créé par openshift-install create manifest:
Exemple d'échantillons de grappes Opérateur Fichier YAML avec managementState: Removed
apiVersion: samples.operator.openshift.io/v1 kind: Config metadata: name: cluster spec: architectures: - x86_64 managementState: Removed
2.1.2. Échantillons en grappes Suivi de l'opérateur et récupération des erreurs d'importation de flux d'images
Après la création ou la mise à jour d'un flux d'images d'échantillons, l'opérateur d'échantillons de grappes surveille la progression de l'importation d'images de chaque balise de flux d'images.
En cas d'échec de l'importation, l'opérateur d'échantillons en grappe retente l'importation par le biais de l'API d'importation d'images de flux d'images, qui est la même API que celle utilisée par la commande oc import-image, environ toutes les 15 minutes jusqu'à ce que l'importation réussisse ou que la configuration de l'opérateur d'échantillons en grappe soit modifiée de telle sorte que le flux d'images soit ajouté à la liste skippedImagestreams ou que l'état de gestion soit modifié en Removed.
Ressources complémentaires
-
Si l'Opérateur d'échantillons en grappe est supprimé lors de l'installation, vous pouvez utiliser l'Opérateur d'échantillons en grappe avec un registre alternatif afin que le contenu puisse être importé, puis définir l'Opérateur d'échantillons en grappe sur
Managedpour obtenir les échantillons. Pour s'assurer que Cluster Samples Operator démarre en tant que
Removeddans une installation réseau restreinte avec un accès réseau initial pour différer l'installation des échantillons jusqu'à ce que vous ayez décidé quels échantillons sont souhaités, suivez les instructions pour personnaliser les nœuds afin de remplacer la configuration par défaut de Cluster Samples Operator et de démarrer initialement en tant queRemoved.- Pour héberger des échantillons dans votre environnement déconnecté, suivez les instructions relatives à l'utilisation de l'Opérateur d'échantillons de cluster avec un registre alternatif.
2.1.3. Échantillons de grappes Assistance de l'opérateur pour la mise en miroir
Lors de l'installation, OpenShift Container Platform crée une carte de configuration nommée imagestreamtag-to-image dans l'espace de noms openshift-cluster-samples-operator. La carte de configuration imagestreamtag-to-image contient une entrée, l'image de remplissage, pour chaque balise de flux d'images.
Le format de la clé pour chaque entrée dans le champ de données de la carte de configuration est <image_stream_name>_<image_stream_tag_name>.
Lors d'une installation déconnectée d'OpenShift Container Platform, le statut de l'opérateur Cluster Samples est défini sur Removed. Si vous choisissez de le changer en Managed, il installe les échantillons.
L'utilisation d'échantillons dans un environnement à réseau restreint ou interrompu peut nécessiter l'accès à des services externes à votre réseau. Voici quelques exemples de services : Github, Maven Central, npm, RubyGems, PyPi et autres. Il peut y avoir des étapes supplémentaires à franchir pour permettre aux objets des opérateurs d'échantillons de grappes d'accéder aux services dont ils ont besoin.
Vous pouvez utiliser cette carte de configuration comme référence pour savoir quelles images doivent être mises en miroir pour que vos flux d'images soient importés.
-
Lorsque l'opérateur d'échantillonnage de cluster est défini sur
Removed, vous pouvez créer votre registre en miroir ou déterminer le registre en miroir existant que vous souhaitez utiliser. - Mettez en miroir les échantillons que vous souhaitez dans le registre mis en miroir en utilisant la nouvelle carte de configuration comme guide.
-
Ajoutez tous les flux d'images que vous n'avez pas mis en miroir à la liste
skippedImagestreamsde l'objet de configuration Cluster Samples Operator. -
Définir
samplesRegistryde l'objet de configuration Cluster Samples Operator sur le registre en miroir. -
Définissez ensuite l'opérateur d'échantillonnage de cluster sur
Managedpour installer les flux d'images que vous avez mis en miroir.
Pour une procédure détaillée, voir Utilisation des flux d'images de l'opérateur Cluster Samples avec des registres alternatifs ou en miroir.
