Actions personnalisées et Marketplace
Explorez la Marketplace de GitHub Actions pour découvrir des actions préconfigurées et apprenez à créer vos propres actions personnalisées.
Actions personnalisées et Marketplace est une leçon DevOps Bootcamp gratuite sur CoddyKit. Ceci est la leçon 3 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.
Découvrir la Marketplace GitHub Actions
Bienvenue dans la Marketplace GitHub Actions ! C'est un espace dynamique où vous trouverez des milliers d'actions préconfigurées créées par GitHub, des contributeurs de l'open source et des partenaires commerciaux.
Ces actions s'intègrent facilement à vos flux de travail et vous font gagner du temps et des efforts en réutilisant des solutions existantes pour les tâches courantes.
Trouver la bonne action
La navigation dans la Marketplace est simple. Vous pouvez rechercher des actions par mots-clés, filtrer par catégorie (comme « CI/CD » ou « Déploiement ») et les trier par popularité.
- Recherchez des actions très bien notées et activement maintenues.
- Consultez la documentation de l'action pour connaître les instructions d'utilisation, les entrées et les sorties.
- Examinez le nombre de fois où une action a été utilisée dans des dépôts publics pour disposer d'un indice de confiance.
Intégrer une action prête à l'emploi
Utiliser une action de la Marketplace est simple. Vous la référencez à l'aide du mot-clé uses dans votre YAML de flux de travail, suivi de owner/repo@version de l'action.
Un exemple courant est actions/checkout, qui récupère le code de votre dépôt afin que votre flux de travail puisse y accéder.
name: Marketplace Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Say hello
run: echo "Hello from workflow!"Entrées et sorties des actions
De nombreuses actions acceptent des entrées pour personnaliser leur comportement, indiquées à l'aide du mot-clé with. Elles peuvent également produire des sorties que d'autres étapes de votre flux de travail peuvent utiliser.
Par exemple, l'action actions/setup-node peut recevoir l'entrée node-version.
name: Node Setup Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js 18.x
uses: actions/setup-node@v3
with:
node-version: '18.x'
- name: Install dependencies
run: npm installQuand créer sa propre action
La Marketplace offre de nombreuses possibilités, mais vous avez parfois besoin de quelque chose de spécifique. C'est là que les actions personnalisées deviennent utiles !
Vous pouvez créer une action personnalisée pour :
- automatiser les outils internes de l'entreprise ;
- intégrer une API particulière qui n'est pas prise en charge par les actions existantes ;
- effectuer des tâches très spécialisées propres au processus de compilation de votre projet.
Types d'actions personnalisées
Vous pouvez créer deux grands types d'actions personnalisées :
- Actions JavaScript : elles s'exécutent directement sur la machine de l'exécuteur avec Node.js. Elles sont généralement plus rapides à développer et plus faciles à partager.
- Actions dans un conteneur Docker : elles s'exécutent dans un conteneur Docker. Elles sont idéales pour encapsuler les environnements et les dépendances et garantir une exécution cohérente sur différents exécuteurs.
Pour simplifier, nous nous concentrerons sur les actions JavaScript.
Le fichier `action.yml`
Toute action personnalisée nécessite un fichier action.yml. Ce fichier définit les métadonnées de l'action, notamment son nom, sa description, les entrées qu'elle accepte, les sorties qu'elle produit et son mode d'exécution.
Il s'agit en quelque sorte du manifeste de votre action : il indique à GitHub Actions tout ce qu'il doit savoir.
name: 'My Custom Greeting Action'
description: 'Greets a person with a custom message.'
inputs:
who-to-greet:
description: 'Who to greet'
required: true
default: 'World'
outputs:
time:
description: 'The time we greeted you'
runs:
using: 'node16'
main: 'index.js'Créer une action JavaScript simple
Créons une action JavaScript très simple. Vous aurez besoin d'un fichier index.js (indiqué dans action.yml) et généralement d'un fichier package.json pour les dépendances.
Le paquet @actions/core est essentiel pour interagir avec le flux de travail, notamment pour récupérer les entrées et définir les sorties.
const core = require('@actions/core');
async function run() {
try {
const nameToGreet = core.getInput('who-to-greet');
console.log(`Hello ${nameToGreet}!`);
const time = (new Date()).toTimeString();
core.setOutput("time", time);
} catch (error) {
core.setFailed(error.message);
}
}
run();Intégrer votre action personnalisée
Pour utiliser votre action personnalisée, placez ses fichiers (action.yml, index.js, etc.) dans un sous-répertoire de votre dépôt. Référencez-la ensuite dans votre flux de travail à l'aide d'un chemin relatif avec uses: ./path/to/your/action.
Vous pouvez ainsi tester votre action localement avant de la publier éventuellement dans la Marketplace.
name: Use Custom Action Demo
on: [push]
jobs:
greet:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run my custom action
uses: ./my-custom-action # Path to action directory
with:
who-to-greet: 'CoddyKit User'
- name: Get the output time
run: echo "The greeting time was ${{ steps.run-my-custom-action.outputs.time }}"Composants d'une action personnalisée
Vous avez découvert les éléments clés nécessaires à la création et à l'utilisation d'actions GitHub personnalisées. Vérifions votre compréhension !
Récapitulatif : Marketplace et actions personnalisées
Excellent travail ! Vous avez exploré la puissance de la Marketplace GitHub Actions et des actions personnalisées.
- La Marketplace propose de nombreuses actions prêtes à l'emploi pour simplifier vos flux de travail.
- Les actions personnalisées vous permettent d'étendre GitHub Actions afin de répondre aux besoins particuliers de vos projets ou de votre organisation.
En les combinant, vous pouvez créer des chaînes d'automatisation extrêmement puissantes et adaptées à vos besoins !
Questions Fréquemment Posées
La leçon « Actions personnalisées et Marketplace » est-elle gratuite ?
Oui — le texte complet de « Actions personnalisées et 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 personnalisées et Marketplace » ?
Explorez la Marketplace de GitHub Actions pour découvrir des actions préconfigurées et apprenez à créer vos propres actions personnalisées. 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 3 sur 4.
Combien de temps prend la leçon « Actions personnalisées et 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
- Introduction à GitHub Actions
- Créer des flux de travail CI/CD
- Actions personnalisées et Marketplace
- Secrets et variables d’environnement dans les actions