6.3. Gestion des processus de déploiement

Procédure

1. Afin de démarrer un nouveau processus de déploiement à partir d’un objet DeploymentConfig existant, exécutez la commande suivante:

   $ oc rollout latest dc/<name>

   Copy to Clipboard Toggle word wrap
   Note

   Lorsqu’un processus de déploiement est déjà en cours, la commande affiche un message et un nouveau contrôleur de réplication ne sera pas déployé.

Procédure

1. Afin d’afficher des détails sur tous les contrôleurs de réplication récemment créés pour l’objet DeploymentConfig fourni, y compris tout processus de déploiement en cours d’exécution, exécutez la commande suivante:

   $ oc rollout history dc/<name>

   Copy to Clipboard Toggle word wrap

2. Afin d’afficher les détails spécifiques à une révision, ajouter le drapeau --révision:

   $ oc rollout history dc/<name> --revision=1

   Copy to Clipboard Toggle word wrap

3. Afin d’obtenir des informations plus détaillées sur un objet DeploymentConfig et sa dernière révision, utilisez la commande de description oc:

   $ oc describe dc <name>

   Copy to Clipboard Toggle word wrap

Procédure

1. De redémarrer un processus de déploiement défaillant:

   $ oc rollout retry dc/<name>

   Copy to Clipboard Toggle word wrap

   Lorsque la dernière révision de celle-ci a été déployée avec succès, la commande affiche un message et le processus de déploiement n’est pas récupéré.

   Note

   La réessayer d’un déploiement redémarre le processus de déploiement et ne crée pas de nouvelle révision du déploiement. Le contrôleur de réplication redémarré a la même configuration qu’il avait quand il a échoué.

Procédure

1. Afin de revenir à la dernière révision réussie de votre configuration:

   $ oc rollout undo dc/<name>

   Copy to Clipboard Toggle word wrap

   Le modèle de l’objet DeploymentConfig est retourné pour correspondre à la révision de déploiement spécifiée dans la commande d’annulation, et un nouveau contrôleur de réplication est lancé. Dans le cas où aucune révision n’est spécifiée avec --to-révision, la dernière révision déployée avec succès est utilisée.

2. Les déclencheurs de changement d’image sur l’objet DeploymentConfig sont désactivés dans le cadre du rollback afin d’éviter le démarrage accidentel d’un nouveau processus de déploiement peu après la fin du retour.

   Afin de réactiver les déclencheurs de changement d’image:

   $ oc set triggers dc/<name> --auto

   Copy to Clipboard Toggle word wrap

Procédure

1. Ajoutez les paramètres de commande au champ spec de l’objet DeploymentConfig. Il est également possible d’ajouter un champ args, qui modifie la commande (ou l’ENTRYPOINT si la commande n’existe pas).

   kind: DeploymentConfig
   apiVersion: apps.openshift.io/v1
   metadata:
     name: example-dc
   # ...
   spec:
     template:
   # ...
       spec:
        containers:
        - name: <container_name>
          image: 'image'
          command:
            - '<command>'
          args:
            - '<argument_1>'
            - '<argument_2>'
            - '<argument_3>'

   Copy to Clipboard Toggle word wrap

   À titre d’exemple, pour exécuter la commande java avec les arguments -jar et /opt/app-root/springboots2idemo.jar:

   kind: DeploymentConfig
   apiVersion: apps.openshift.io/v1
   metadata:
     name: example-dc
   # ...
   spec:
     template:
   # ...
       spec:
         containers:
           - name: example-spring-boot
             image: 'image'
             command:
               - java
             args:
               - '-jar'
               - /opt/app-root/springboots2idemo.jar
   # ...

   Copy to Clipboard Toggle word wrap

Procédure

1. Diffuser les journaux de la dernière révision pour un objet de déploiement donnéConfig:

   $ oc logs -f dc/<name>

   Copy to Clipboard Toggle word wrap

   En cas d’exécution ou d’échec de la dernière révision, la commande renvoie les journaux du processus responsable du déploiement de vos pods. En cas de succès, il renvoie les journaux d’un pod de votre application.

2. En outre, vous pouvez afficher les journaux des anciens processus de déploiement défaillants, si et seulement si ces processus (anciens contrôleurs de réplication et leurs pods de déploiement) existent et n’ont pas été élavés ou supprimés manuellement:

   $ oc logs --version=1 dc/<name>

   Copy to Clipboard Toggle word wrap

Procédure

1. Dans l’exemple suivant, chacune des ressources, cpu, mémoire et stockage éphémère est facultative:

   kind: Deployment
   apiVersion: apps/v1
   metadata:
     name: hello-openshift
   # ...
   spec:
   # ...
     type: "Recreate"
     resources:
       limits:
         cpu: "100m" 

   1

   
         memory: "256Mi" 

   2

   
         ephemeral-storage: "1Gi" 

   3

   Copy to Clipboard Toggle word wrap

   1

   CPU est en unités CPU: 100m représente 0,1 unité CPU (100 * 1e-3).

   2

   la mémoire est en octets: 256Mi représente 268435456 octets (256 * 2 ^ 20).

   3

   le stockage éphémère est en octets: 1Gi représente 1073741824 octets (2 ^ 30).

   Cependant, si un quota a été défini pour votre projet, l’un des deux éléments suivants est requis:

   • D’une section de ressources assortie d’une demande explicite:

     kind: Deployment
     apiVersion: apps/v1
     metadata:
       name: hello-openshift
     # ...
     spec:
     # ...
       type: "Recreate"
       resources:
         requests: 

     1

     
           cpu: "100m"
           memory: "256Mi"
           ephemeral-storage: "1Gi"

     Copy to Clipboard Toggle word wrap

     1

     L’objet demande contient la liste des ressources qui correspondent à la liste des ressources dans le quota.

   • Limite définie dans votre projet, où les valeurs par défaut de l’objet LimitRange s’appliquent aux pods créés au cours du processus de déploiement.

   Afin de définir les ressources de déploiement, choisissez l’une des options ci-dessus. Autrement, déployer la création de pod échoue, invoquant un défaut de satisfaire les quotas.

Procédure

1. Afin de mettre à l’échelle manuellement un objet DeploymentConfig, utilisez la commande oc scale. À titre d’exemple, la commande suivante définit les répliques de l’objet frontend DeploymentConfig à 3.

   $ oc scale dc frontend --replicas=3

   Copy to Clipboard Toggle word wrap

   Le nombre de répliques finit par se propager à l’état souhaité et actuel du déploiement configuré par le frontend objet DeploymentConfig.

Procédure

1. Créez un nouveau projet.
2. Accédez aux charges de travail Secrets.
3. Créez un secret qui contient des informations d’identification pour accéder à un référentiel privé d’images.
4. Accédez à Workloads DeploymentConfigs.
5. Créer un objet DeploymentConfig.
6. Dans la page de l’éditeur d’objet DeploymentConfig, définissez le secret Pull et enregistrez vos modifications.

Procédure

1. Éditer l’objet DeploymentConfig:

   $ oc edit dc/<deployment_config>

   Copy to Clipboard Toggle word wrap

2. Ajoutez les paramètres serviceAccount et serviceAccountName au champ spec, et spécifiez le compte de service que vous souhaitez utiliser:

   apiVersion: apps.openshift.io/v1
   kind: DeploymentConfig
   metadata:
     name: example-dc
   # ...
   spec:
   # ...
     securityContext: {}
     serviceAccount: <service_account>
     serviceAccountName: <service_account>

   Copy to Clipboard Toggle word wrap