Prise en charge des conteneurs en bac à sable pour OpenShift

Procédure

1. Créer une ressource NodeFeatureDiscovery pour détecter les capacités des nœuds adaptés à l'exécution des conteneurs Kata :

   1. Enregistrez le YAML suivant dans le fichier nfd.yaml:

      apiVersion: nfd.openshift.io/v1
      kind: NodeFeatureDiscovery
      metadata:
        name: nfd-kata
        namespace: openshift-nfd
      spec:
        operand:
          image: quay.io/openshift/origin-node-feature-discovery:4.10
          imagePullPolicy: Always
          servicePort: 12000
        workerConfig:
          configData: |
            sources:
               custom:
                 - name: "feature.node.kubernetes.io/runtime.kata"
                   matchOn:
                     - cpuId: ["SSE4", "VMX"]
                       loadedKMod: ["kvm", "kvm_intel"]
                     - cpuId: ["SSE4", "SVM"]
                       loadedKMod: ["kvm", "kvm_amd"]

   2. Créer la ressource personnalisée (CR) NodeFeatureDiscovery:

      $ oc create -f nfd.yaml

      Exemple de sortie

      nodefeaturediscovery.nfd.openshift.io/nfd-kata created

      Une étiquette feature.node.kubernetes.io/runtime.kata=true est appliquée à tous les nœuds de travail qualifiés.

2. Définissez le champ checkNodeEligibility sur true dans la ressource KataConfig pour activer la fonctionnalité, par exemple :

   1. Enregistrez le YAML suivant dans le fichier kata-config.yaml:

      apiVersion: kataconfiguration.openshift.io/v1
      kind: KataConfig
      metadata:
        name: example-kataconfig
      spec:
        checkNodeEligibility: true

   2. Créer le CR KataConfig:

      $ oc create -f kata-config.yaml

      Exemple de sortie

      kataconfig.kataconfiguration.openshift.io/example-kataconfig created

Procédure

1. Depuis la perspective Administrator dans la console web, naviguez vers Operators → OperatorHub.
2. Dans le champ Filter by keyword, tapez OpenShift sandboxed containers.
3. Sélectionnez la tuile OpenShift sandboxed containers.
4. Lisez les informations sur l'opérateur et cliquez sur Install.

5. Sur la page Install Operator:

   1. Sélectionnez stable-1.3 dans la liste des options Update Channel disponibles.

   2. Vérifiez que Operator recommended Namespace est sélectionné pour Installed Namespace. Ceci installe l'Opérateur dans l'espace de noms obligatoire openshift-sandboxed-containers-operator. Si cet espace de noms n'existe pas encore, il est automatiquement créé.

      Note

      La tentative d'installation de l'Opérateur de conteneurs en bac à sable OpenShift dans un espace de noms autre que openshift-sandboxed-containers-operator entraîne l'échec de l'installation.

   3. Vérifiez que Automatic est sélectionné pour Approval Strategy. Automatic est la valeur par défaut, et permet des mises à jour automatiques des conteneurs OpenShift sandboxed lorsqu'une nouvelle version de z-stream est disponible.
6. Cliquez sur Install.

Vérification

1. Depuis la perspective Administrator dans la console web, naviguez vers Operators → Installed Operators.
2. Vérifier que l'opérateur OpenShift sandboxed containers est listé dans la liste des opérateurs.

Procédure

1. Depuis la perspective Administrator dans la console web, naviguez vers Operators → Installed Operators.
2. Sélectionnez l'Opérateur de conteneurs sandboxés OpenShift dans la liste des opérateurs.
3. Dans l'onglet KataConfig, cliquez sur Create KataConfig.

4. Dans la page Create KataConfig, entrez les détails suivants :

   • Name: Entrez un nom pour la ressource KataConfig. Par défaut, le nom est défini comme example-kataconfig.
   • Labels (Facultatif) : Saisissez tout attribut pertinent permettant d'identifier la ressource KataConfig. Chaque étiquette représente une paire clé-valeur.
   • checkNodeEligibility (Facultatif) : Cochez cette case pour utiliser l'opérateur de découverte des fonctionnalités du nœud (NFD) afin de détecter l'éligibilité du nœud à l'exécution de kata en tant que RuntimeClass. Pour plus d'informations, voir "Checking whether cluster nodes are eligible to run OpenShift sandboxed containers" (Vérification de l'éligibilité des nœuds de cluster à l'exécution des conteneurs OpenShift en bac à sable).

   • kataConfigPoolSelector: Par défaut, kata est installé en tant que RuntimeClass sur tous les nœuds. Si vous souhaitez installer kata en tant que RuntimeClass uniquement sur certains nœuds, vous devez ajouter un matchExpression:

     1. Élargir la kataConfigPoolSelector domaine.
     2. Dans le kataConfigPoolSelectordéveloppez matchExpressions. Il s'agit d'une liste d'exigences relatives aux sélecteurs d'étiquettes.
     3. Cliquez sur Add matchExpressions.
     4. Dans le champ key, ajoutez la clé d'étiquette à laquelle le sélecteur s'applique.
     5. Dans le champ operator, ajoutez la relation de la clé aux valeurs de l'étiquette. Les opérateurs valides sont In, NotIn, Exists et DoesNotExist.
     6. Développez la zone values, puis cliquez sur Add value.
     7. Dans le champ Value, entrez true ou false pour la valeur de l'étiquette key.
   • logLevel: Définir le niveau des données de journal récupérées pour les nœuds exécutant kata en tant que RuntimeClass. Pour plus d'informations, voir "Collecting OpenShift sandboxed containers data" (Collecte des données des conteneurs en bac à sable OpenShift).
5. Cliquez sur Create.

Vérification

1. Dans l'onglet KataConfig, sélectionnez le nouveau CR KataConfig.
2. Dans la page KataConfig, sélectionnez l'onglet YAML.

3. Contrôler le champ installationStatus dans le statut.

   Un message apparaît à chaque mise à jour. Cliquez sur Reload pour voir le CR KataConfig mis à jour.

   Lorsque la valeur de Completed nodes est égale au nombre de nœuds de travail ou de nœuds étiquetés, l'installation est terminée. L'état contient également une liste des nœuds où l'installation est terminée.

Procédure

1. Dans la perspective Administrator de la console Web, développez Workloads et sélectionnez le type de charge de travail que vous souhaitez créer.
2. Dans la page de la charge de travail, cliquez sur pour créer la charge de travail.

3. Dans le fichier YAML pour la charge de travail, dans le champ spec où le conteneur est listé, ajoutez runtimeClassName: kata.

   Exemple pour Pod

       apiVersion: v1
       kind: Pod
       metadata:
         name: example
         labels:
           app: httpd
         namespace: openshift-sandboxed-containers-operator
       spec:
         runtimeClassName: kata
         containers:
           - name: httpd
             image: 'image-registry.openshift-image-registry.svc:5000/openshift/httpd:latest'
             ports:
               - containerPort: 8080

   Exemple de déploiement

       apiVersion: apps/v1
       kind: Deployment
       metadata:
         name: example
         namespace: openshift-sandboxed-containers-operator
       spec:
         selector:
           matchLabels:
             app: httpd
         replicas: 3
         template:
           metadata:
             labels:
               app: httpd
           spec:
             runtimeClassName: kata
             containers:
               - name: httpd
                 image: >-
                   image-registry.openshift-image-registry.svc:5000/openshift/httpd:latest
                 ports:
                   - containerPort: 8080

4. Cliquez sur Save.

Procédure

1. Créez l'objet Namespace pour l'Opérateur de conteneurs en bac à sable OpenShift.

   1. Créez un fichier YAML de l'objet Namespace qui contient le manifeste suivant :

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-sandboxed-containers-operator

   2. Créer l'objet Namespace:

      $ oc create -f Namespace.yaml

2. Créez l'objet OperatorGroup pour l'Opérateur de conteneurs en bac à sable OpenShift.

   1. Créez un fichier YAML de l'objet OperatorGroup qui contient le manifeste suivant :

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-sandboxed-containers-operator
        namespace: openshift-sandboxed-containers-operator
      spec:
        targetNamespaces:
        - openshift-sandboxed-containers-operator

   2. Créer l'objet OperatorGroup:

      $ oc create -f OperatorGroup.yaml

3. Créez l'objet Subscription pour abonner Namespace à l'opérateur de conteneurs en bac à sable d'OpenShift.

   1. Créez un fichier YAML de l'objet Subscription qui contient le manifeste suivant :

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: openshift-sandboxed-containers-operator
        namespace: openshift-sandboxed-containers-operator
      spec:
        channel: "stable-1.3"
        installPlanApproval: Automatic
        name: sandboxed-containers-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace
        startingCSV: sandboxed-containers-operator.v1.3.2

   2. Créer l'objet Subscription:

      $ oc create -f Subscription.yaml

Procédure

1. Créer un fichier YAML avec le manifeste suivant :

   apiVersion: kataconfiguration.openshift.io/v1
   kind: KataConfig
   metadata:
     name: cluster-kataconfig
   spec:
     checkNodeEligibility: false 

   1

   
     logLevel: info

   1

   Définissez "checkNodeEligibility" à true pour détecter l'éligibilité du nœud à exécuter kata en tant que RuntimeClass. Pour plus d'informations, voir "Checking whether cluster nodes are eligible to run OpenShift sandboxed containers" (Vérifier si les nœuds du cluster sont éligibles à l'exécution des conteneurs OpenShift).

2. (Facultatif) Si vous souhaitez installer kata en tant que RuntimeClass uniquement sur certains nœuds, créez un fichier YAML qui inclut l'étiquette dans le manifeste :

   apiVersion: kataconfiguration.openshift.io/v1
   kind: KataConfig
   metadata:
     name: cluster-kataconfig
   spec:
     checkNodeEligibility: false
     logLevel: info
     kataConfigPoolSelector:
       matchLabels:
         <label_key>: '<label_value>' 

   1

   1

   Les étiquettes dans kataConfigPoolSelector ne prennent en charge que des valeurs uniques ; la syntaxe de nodeSelector n'est pas prise en charge.

3. Créer la ressource KataConfig:

   oc create -f <file name>.yaml

Procédure

1. Dans la perspective de Administrator, naviguez vers Workloads → Pods.
2. Recherchez le pod que vous souhaitez supprimer en utilisant le champ Search by name.
3. Cliquez sur le nom du pod pour l'ouvrir.
4. Sur la page Details, vérifiez que kata est affiché pour Runtime class.
5. Cliquez sur le menu Actions et sélectionnez Delete Pod.
6. Cliquez sur Delete dans la fenêtre de confirmation.

Procédure

1. Dans la perspective de Administrator, naviguez vers Operators → Installed Operators.
2. Recherchez l'opérateur de conteneurs OpenShift sandboxed en utilisant le champ Search by name.
3. Cliquez sur l'opérateur pour l'ouvrir, puis sélectionnez l'onglet KataConfig.
4. Cliquez sur le menu Options pour la ressource KataConfig, puis sélectionnez Delete KataConfig.
5. Cliquez sur Delete dans la fenêtre de confirmation.

Procédure

1. Dans la perspective de Administrator, naviguez vers Operators → Installed Operators.
2. Recherchez l'opérateur de conteneurs OpenShift sandboxed en utilisant le champ Search by name.
3. Cliquez sur le menu Options de l'opérateur et sélectionnez Uninstall Operator.
4. Cliquez sur Uninstall dans la fenêtre de confirmation.

Procédure

1. Dans la perspective de Administrator, naviguez vers Administration → Namespaces.
2. Recherchez l'espace de noms openshift-sandboxed-containers-operator en utilisant le champ Search by name.

3. Cliquez sur le menu Options pour l'espace de noms et sélectionnez Delete Namespace.

   Note

   Si l'option Delete Namespace n'est pas disponible, vous n'êtes pas autorisé à supprimer l'espace de noms.

4. Dans le volet Delete Namespace, saisissez openshift-sandboxed-containers-operator et cliquez sur Delete.
5. Cliquez sur Delete.

Procédure

1. Dans la perspective de Administrator, naviguez vers Administration → CustomResourceDefinitions.
2. Recherchez KataConfig en utilisant le champ Search by name.
3. Cliquez sur le menu Options pour le CRD KataConfig, puis sélectionnez Delete CustomResourceDefinition.
4. Cliquez sur Delete dans la fenêtre de confirmation.
5. Attendez que le CRD KataConfig disparaisse de la liste. Cela peut prendre plusieurs minutes.

Procédure

1. Recherchez les pods qui utilisent kata comme runtimeClass en exécutant la commande suivante :

   $ oc get pods -A -o json | jq -r '.items[] | select(.spec.runtimeClassName == "kata").metadata.name'

2. Pour supprimer chaque module, exécutez la commande suivante :

   oc delete pod <pod-name>

Procédure

1. Supprimez la ressource personnalisée KataConfig en exécutant la commande suivante :

   oc delete kataconfig <KataConfig_CR_Name>

Procédure

1. Récupérez le nom de la version du service de cluster (CSV) pour les conteneurs OpenShift sandboxed à partir de l'abonnement en exécutant la commande suivante :

   CSV_NAME=$(oc get csv -n openshift-sandboxed-containers-operator -o=custom-columns=:metadata.name)

2. Supprimez l'abonnement OpenShift sandboxed containers Operator de Operator Lifecyle Manager (OLM) en exécutant la commande suivante :

   $ oc delete subscription sandboxed-containers-operator -n openshift-sandboxed-containers-operator

3. Supprimez le nom CSV pour les conteneurs OpenShift sandboxed en exécutant la commande suivante :

   $ oc delete csv ${CSV_NAME} -n openshift-sandboxed-containers-operator

4. Récupérez le nom du groupe d'opérateurs des conteneurs sandboxés d'OpenShift en exécutant la commande suivante :

   $ OG_NAME=$(oc get operatorgroup -n openshift-sandboxed-containers-operator -o=jsonpath={..name})

5. Supprimez le nom du groupe d'opérateurs des conteneurs OpenShift sandboxed en exécutant la commande suivante :

   $ oc delete operatorgroup ${OG_NAME} -n openshift-sandboxed-containers-operator

6. Supprimez l'espace de noms des conteneurs OpenShift sandboxed en exécutant la commande suivante :

   $ oc delete namespace openshift-sandboxed-containers-operator

Procédure

1. Supprimez le CRD KataConfig en exécutant la commande suivante :

   $ oc delete crd kataconfigs.kataconfiguration.openshift.io

Procédure

1. Dans la perspective Administrator d'OpenShift Container Platform, naviguez vers Operators → Installed Operators.
2. Sélectionnez le site OpenShift sandboxed containers Operator et allez dans l'onglet KataConfig.
3. Recherchez la ressource KataConfig en utilisant le champ Search by name. Le nom par défaut de la ressource KataConfig est example-kataconfig.
4. Sélectionnez la ressource KataConfig et allez dans l'onglet KataConfig.

5. Modifier le numéro de version pour kataMonitorImage:

       checkNodeEligibility: false
       kataConfigPoolSelector: null
       kataMonitorImage: 'registry.redhat.io/openshift-sandboxed-containers/osc-monitor-rhel8:1.3.0'

6. Cliquez sur Save.