DevOps Bootcamp · Leçon

Actions composites et publication sur la Marketplace

Créez des actions composites regroupant plusieurs étapes, versionnez-les correctement et publiez votre action personnalisée sur la GitHub Marketplace pour la réutiliser.

Actions composites et publication sur la Marketplace est une leçon DevOps Bootcamp gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage DevOps Bootcamp, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours DevOps Bootcamp comprend 4 leçons au total.

Trois types d’actions personnalisées

GitHub permet de créer une action personnalisée de trois façons :

Actions JavaScript — exécutent du code Node
Actions Docker — s’exécutent dans un conteneur
Actions composites — regroupent plusieurs étapes de flux de travail

Cette leçon se concentre sur les actions composites et leur publication.

Qu’est-ce qu’une action composite

Une action composite regroupe plusieurs étapes d’exécution et appels à d’autres actions dans une seule unité réutilisable, sans écrire de JavaScript ni créer d’image Docker.

Elle est idéale pour encapsuler une séquence répétée de commandes shell.

Le fichier action.yml

Chaque action est définie par un fichier action.yml à sa racine. Pour une action composite, définissez runs.using sur composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

Le shell est obligatoire

Une règle subtile : dans les actions composites, chaque étape run doit déclarer un shell. L’oublier est l’erreur la plus courante lors de la création d’actions composites.

    - run: echo 'hello'
      shell: bash

Définir les entrées

Rendez l’action configurable avec inputs. Les appelants transmettent des valeurs via with, auxquelles vous faites référence avec inputs.<name>.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Définir les sorties

Une action composite peut renvoyer des sorties. Une étape écrit dans GITHUB_OUTPUT et l’action l’associe à une sortie nommée.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Utiliser une action locale

Vous pouvez référencer une action stockée dans le même dépôt par son chemin, ce qui est très pratique pendant le développement avant sa publication.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Gérer les versions avec des balises

Les actions publiées sont référencées par une référence git. Bonne pratique : balisez les versions avec v1.0.0 et conservez également une balise v1 évolutive.

Les appelants qui utilisent @v1 obtiennent automatiquement les mises à jour rétrocompatibles.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Se préparer pour la Marketplace

Pour publier une action sur la GitHub Marketplace, celle-ci doit se trouver dans un dépôt public contenant un fichier action.yml avec name, description et, idéalement, branding (icône et couleur).

branding:
  icon: package
  color: blue

Publier la version

Sur la page Releases du dépôt, préparez une version pour votre balise. GitHub affiche une case à cocher Publish this Action to the Marketplace.

Acceptez l’accord, choisissez les catégories, puis publiez. L’action devient consultable par tout le monde.

Documenter l’utilisation

Une bonne action est accompagnée d’un README clair présentant un exemple d’utilisation, les entrées et les sorties.

Les entreprises qui évaluent votre action s’appuient largement sur cette documentation ; veillez donc à ce qu’elle soit exacte et complète.

Vérification rapide

Vérifiez votre compréhension des actions composites.

Récapitulatif

Vous avez appris à créer et à publier des actions composites.

Les actions composites regroupent des étapes via runs.using: composite
Chaque étape d’exécution nécessite un shell explicite
Exposez des entrées et des sorties pour favoriser la réutilisation
Utilisez des versions sémantiques et une balise majeure évolutive, puis publiez sur la Marketplace

Les actions réutilisables permettent aux équipes de faire évoluer leur logique CI/CD partagée.

Questions Fréquemment Posées

La leçon « Actions composites et publication sur la Marketplace » est-elle gratuite ?

Oui — le texte complet de « Actions composites et publication sur la Marketplace » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours DevOps Bootcamp, passe à CoddyKit PRO. Le cours DevOps Bootcamp comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Actions composites et publication sur la Marketplace » ?

Créez des actions composites regroupant plusieurs étapes, versionnez-les correctement et publiez votre action personnalisée sur la GitHub Marketplace pour la réutiliser. Tu pratiques DevOps Bootcamp avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer DevOps Bootcamp ?

Aucune expérience préalable n'est requise. DevOps Bootcamp sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Actions composites et publication sur la Marketplace » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon DevOps Bootcamp ?

Oui. Chaque leçon DevOps Bootcamp inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Développement d’actions GitHub personnalisées
Exécuteurs autohébergés sur site
Intégration aux systèmes d’entreprise
Actions composites et publication sur la Marketplace

← Retour à DevOps Bootcamp