Xavki Open your Sources.. live

Article

Ansible 047 – MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE…

par

Print Friendly, PDF & Email

TL;DR

Cet episode de la formation Ansible traite de **MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE…**. L objectif est de comprendre un module precis, ses options importantes et ses limites. Le depot tutorials-ansible fournit le support de cours et, quand il existe, les fichiers pratiques dans 47-module-docker-container.

MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE…: c est quoi exactement ?

Avec Docker, Ansible pilote a la fois la preparation des hotes et le deploiement de conteneurs, reseaux, volumes ou services Swarm. Le point important est de separer ce qui releve de l image, du runtime et de l orchestration, tout en maintenant une approche declarative.

Dans cet article, on relie la video, le support GitLab et une lecture operationnelle du sujet. L objectif n est pas de remplacer la video, mais de fournir une fiche de synthese indexable, reutilisable et reliee aux autres episodes de la playlist.

Le probleme concret que cet episode resout

Le sujet **MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE…** repond a un besoin frequent dans les environnements DevOps: automatiser sans transformer les scripts en suite d actions fragiles. Avec Ansible, on cherche a decrire un etat attendu, a versionner cette description et a pouvoir relancer l execution sans surprise.

Pour un debutant, le risque est souvent de memoriser une commande sans comprendre le modele mental. Pour un profil plus avance, le risque inverse est de complexifier trop vite avec des roles, variables ou templates qui masquent l intention. Cet episode sert donc de point d ancrage dans la progression.

Ce que montre le support Xavki

Le support principal de ce chapitre est disponible ici: 47-module-docker-container.

Points cles extraits du support de cours:

  • Objectif: lancement d’image docker: docker
  • Objectif: lancement d’image docker: python3-docker ou pip3 install docker
  • mise en place et premier run: name: install docker & docker for python, name: start docker, name: copy files, name: copy image, name: build, alpine: 3.9, name: run
  • command et detach: name: run
  • exposition de ports: name: Start new docker container, 8080: 8080
  • exposition de ports et test: name: build, name: run, 8888: 8080, name: wait for instance
  • avec healthcheck: name: run, 8888: 8080
  • itération de conteneurs: name: iter container
  • itération de conteneurs: name: container list, name: remove all containers
  • output: name: run, name: print output
  • output
Découvrez  Ansible, comment générer des clefs SSH et les pousser, organiser un reboot ?

Exemple de code 1 (shell)

- name: install docker & docker for python
    apt:
      name: docker.io,python3-docker
      state: present
      update_cache: yes
      cache_valid_time: 3600
  - name: start docker
    systemd:
      name: docker
      state: started
      enabled: yes
  - name: copy files
    file:
      path: /tmp/build
      state: directory
  - name: copy image
    copy:
      src: app/
      dest: /tmp/build
  - name: build
    docker_image:
      name: imgbuild
      tag: v1.0
      source: build
      build:
        pull: yes
        path: /tmp/build/app/
        dockerfile: Dockerfile
        cache_from:
        - alpine:3.9
  - name: run
    docker_container:
      name: c1
      image: imgbuild:v1.0
      state: started

Exemple de code 2 (shell)

- name: run
    docker_container:
      name: c1
      image: ubuntu:latest
      state: started
      detach: no
      command: sleep 10

Exemple de code 3 (shell)

- name: Start new docker container
      docker_container:
        name: c1
        pull: yes
        image: "myapp:{{ version }}"
        ports:
          - 8080:8080

Exemple de code 4 (shell)

- name: build
    docker_image:
      build:
        path: /tmp/build/
        dockerfile: Dockerfile
        pull: yes
      name: myapp
      tag: v1.1
      source: build
  - name: run
    docker_container:
      name: c1
      image: myapp:v1.1
      state: started
      ports:
      - 8888:8080
  - name: wait for instance
    uri:
      url: "http://127.0.0.1:8888/select"
      status_code: 200
    register: result
    until: result.status == 200
    retries: 120
    delay: 1

Fichiers utiles repérés dans le repertoire du chapitre:

  • 47-module-docker-container/app/Dockerfile
  • 47-module-docker-container/app/app.py
  • 47-module-docker-container/slides.md

Modele mental minimal

Pour raisonner avec Ansible, gardez cette chaine en tete: **inventaire -> variables -> playbook -> modules -> resultat observe**. Quand une execution ne produit pas l effet attendu, il faut revenir dans cet ordre plutot que corriger au hasard.

Le numero de l episode aide aussi a situer le sujet dans la serie. Les premiers chapitres posent les bases, les chapitres intermediaires explorent les modules et les roles, puis la formation avance vers Docker, AWX, AWS, ELK, Jinja2 et la creation de modules.

Cas d usage concrets

Voici quelques cas d usage typiques pour ce sujet:

  • Deployer des stacks multi-conteneurs avec Docker Compose
  • Configurer des reseaux Docker pour la communication inter-conteneurs
  • Gerer des volumes persistants pour les donnees
  • Orchestrer des services Swarm en production

Bonnes pratiques associes

  • Preférer les modules integrés aux commandes shell
  • Verifier l idempotence de chaque module utilise
  • Utiliser le parametre check pour tester sans appliquer
  • Gerer les erreurs avec ignore_errors quand necessaire

Pieges courants a eviter

  • Utiliser shell ou command quand un module existe
  • Ne pas verifier le resultat d un module
  • Oublier de gerer les erreurs avec ignore_errors ou failed_when
  • Utiliser des modules non maintenus ou experimentaux

Exemple de pratique conseillee

Une bonne maniere d utiliser cet episode consiste a repartir du repertoire 47-module-docker-container, lire le support, puis reproduire les commandes dans un environnement jetable. Si le chapitre contient des playbooks ou roles, lancez d abord une lecture statique: inventaire utilise, variables attendues, modules appeles, handlers eventuels et fichiers templates.

Découvrez  Ansible 009 - INVENTORY : LES VARIABLES D'INVENTAIRE (HOST_VARS, GROUP_VARS...)

Ensuite seulement, executez le playbook sur une cible de test. L interet est de comparer trois choses: ce que le playbook declare, ce qu Ansible affiche pendant l execution, et ce qui existe reellement sur la machine apres le run.

Pour aller plus loin

  • Deployer des applications conteneurisees avec Ansible
  • Configurer un cluster Docker Swarm
  • Automatiser la gestion des images Docker
  • Integrer Docker avec votre pipeline CI/CD

Points de vigilance

  • Ne stockez pas de secrets en clair dans les variables ou les inventaires.
  • Verifiez toujours l idempotence en relancant le playbook au moins une deuxieme fois.
  • Preferez un module Ansible dedie a une commande shell quand le module existe.
  • Gardez les variables lisibles: trop de niveaux rendent le debug plus difficile.
  • Documentez les prerequis locaux: collections, roles Galaxy, version d Ansible et acces SSH.

Liens internes conseilles

Liens utiles

FAQ

Cet episode suffit-il pour maitriser MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE… ?

Non. Il sert de point d entree ou de chapitre cible dans une progression plus large. Il faut le completer par la pratique sur le depot et par les episodes voisins de la playlist. La maitrise vient de l experience pratique et de la repetition sur differents cas d usage.

Faut-il regarder la video ou lire uniquement le depot ?

Les deux sources sont complementaires. La video donne le fil pedagogique, le contexte et les explications orales, tandis que le depot donne les chemins, supports et fichiers concrets a reprendre. Pour une comprehension complete, combinez les deux approches.

Comment verifier que j ai compris ce chapitre ?

Relancez l exemple sur un environnement de test, modifiez volontairement une variable ou une cible, puis expliquez le resultat obtenu. Si vous savez diagnostiquer l ecart entre l etat attendu et l etat reel, le chapitre est compris. Essayez aussi d adapter l exemple a un cas similaire mais different.

Peut-on reutiliser directement ces fichiers en production ?

Le depot est un support pedagogique. Avant un usage production, il faut revoir les versions, les secrets, les droits, les inventaires, les handlers, les sauvegardes et les contraintes propres a votre infrastructure. Adaptez toujours les exemples a votre contexte specifique.

Quels sont les prerequis pour suivre cet episode ?

Les prerequis varient selon le numero. Pour les premiers episodes, une connaissance basique de Linux et de SSH suffit. Pour les episodes avances (AWX, AWS, ELK), il est recommande de maitriser les bases d Ansible et d avoir un environnement de test operationnel.

Conclusion

L episode **Ansible 47 – MODULE DOCKER_CONTAINER : CREER DES CONTENEURS, HEALTHCHECK, PORTS, COMMANDE…** s inscrit dans une formation progressive qui part des fondamentaux pour aller vers des cas DevOps plus complets. L important est de conserver une logique simple: comprendre le sujet, lire les fichiers du depot, pratiquer sur un environnement de test, puis relier ce chapitre aux episodes precedents et suivants. La repetition et l experimentation sont les cles pour acquerir une veritable maitrise d Ansible.

Explorer les formations Xavki

Pour apprendre dans l ordre, repartez depuis la roadmap ou une playlist thematique.

Roadmap DevOps YouTube