Publication d’actions dans GitHub Marketplace

Vous devez accepter les conditions d’utilisation du service pour publier des actions dans GitHub Marketplace.

À propos de la publication d’actions

Avant de pouvoir publier une action, vous devez la créer dans votre dépôt. Pour plus d’informations, consultez « Création d’actions ».

Quand vous prévoyez de publier votre action dans GitHub Marketplace, vous devez vérifier que le référentiel contient uniquement le fichier de métadonnées, le code et les fichiers nécessaires à l’action. La création d’un dépôt unique pour l’action vous permet d’étiqueter, publier et empaqueter le code dans une même unité. GitHub utilise également les métadonnées de l’action qui se trouvent dans votre page GitHub Marketplace.

Les actions sont immédiatement publiées dans GitHub Marketplace et ne sont pas examinées par GitHub tant qu’elles répondent aux exigences suivantes :

• L’action doit être dans un dépôt public.
• Chaque dépôt doit contenir une seule action.
• Le fichier de métadonnées de l’action (action.yml ou action.yaml) doit se trouver dans le répertoire racine du dépôt.
• Le name dans le fichier de métadonnées de l’action doit être unique.
  • Le name ne peut pas être identique au nom d’une action déjà publiée dans GitHub Marketplace.
  • Le name ne peut pas correspondre à un utilisateur ou à une organisation dans GitHub, sauf si l’utilisateur ou le propriétaire de l’organisation publie l’action. Par exemple, seule l’organisation GitHub peut publier une action nommée github.
  • Le name ne peut pas correspondre à une catégorie GitHub Marketplace existante.
  • GitHub réserve les noms des fonctionnalités GitHub.

Publishing an action

Vous pouvez ajouter l’action que vous avez créée à GitHub Marketplace en l’étiquetant comme une nouvelle version, puis en la publiant.

Pour créer le brouillon d’une nouvelle version et publier l’action dans GitHub Marketplace, suivez ces instructions :

1. Dans GitHub.com, accédez à la page principale du dépôt.

2. Accédez au fichier de métadonnées d’action de votre dépôt (action.yml ou action.yaml). Vous verrez une bannière permettant de publier l’action dans GitHub Marketplace. Cliquez sur Ébaucher une version.

   

3. Sous « Action de mise en production », cochez la case pour publier l’action sur GitHub Marketplace. Si vous ne pouvez pas cocher la case, vous devez d’abord cliquer sur le lien pour lire et accepter le Contrat développeur GitHub Marketplace.

4. Si les étiquettes de votre fichier de métadonnées contiennent des erreurs, un message d’erreur s’affichera.

5. Si des suggestions s’affichent, modifiez votre fichier de métadonnées en conséquence. Une fois terminé, vous verrez un message du type « Tout semble parfait ! ». « Hello World ! ».

6. Choisissez une « Catégorie principale » et, éventuellement une « Autre catégorie » pour aider les utilisateurs à trouver votre action dans les données GitHub Marketplace.

7. Étiquetez votre action avec une version et ajoutez un titre à la version. Cela permettra aux utilisateurs de savoir quelles modifications ou fonctionnalités ont été ajoutées à la version. Les utilisateurs verront la version dans la page GitHub Marketplace qui est dédiée à l’action.

8. Renseignez tous les autres champs, puis cliquez sur Publier la version. La publication vous oblige à utiliser l’authentification à 2 facteurs. Pour plus d’informations, consultez « Configuration de l’authentification à 2 facteurs ».

Supprimer une action de GitHub Marketplace

Pour supprimer une action publiée de GitHub Marketplace, vous devez mettre à jour chaque version publiée. Effectuez les étapes suivantes pour chaque version de l’action que vous avez publiée dans GitHub Marketplace.

1. Dans GitHub.com, accédez à la page principale du dépôt. 1. À droite de la liste des fichiers, cliquez sur Mises en production.

   

2. Next to the release you want to edit, click .

   

3. Sélectionnez à nouveau Publier cette action dans GitHub Marketplace pour décocher l’option.

4. Au bas de la page, cliquez sur Mettre à jour la version.