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 « Partage des automatisations ».

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.
• Un référentiel ne doit pas contenir de fichiers de workflow.
• 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. Sur GitHub, accédez à la page principale du référentiel.

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 version », sélectionnez Publier cette action dans GitHub Marketplace .

   Remarque : la case « Publier » est décochée si le compte propriétaire du dépôt n’a pas encore accepté le Contrat de développeur de la GitHub Marketplace. Si vous êtes propriétaire du dépôt ou si vous êtes propriétaire d’organisation, cliquez sur le lien « Accepter le Contrat de développeur de la Place de marché GitHub », puis acceptez le contrat. En l’absence de lien, envoyez au propriétaire d’organisation un lien vers cette page « Action de mise en production » et demandez-lui d’accepter le contrat.

4. Si les étiquettes de votre fichier de métadonnées contiennent des erreurs, un message d’erreur s’affichera. Corrigez-les en mettant à jour votre fichier de métadonnées. Une fois terminé, vous verrez un message du type « Tout semble parfait ! ». « Hello World ! ».

5. Sélectionnez le menu déroulant Catégorie principale, puis cliquez sur une catégorie qui permettra aux utilisateurs de trouver votre action dans GitHub Marketplace.

6. Si vous le souhaitez, sélectionnez le menu déroulant Autre catégorie et cliquez sur une catégorie secondaire.

7. Dans le champ d’étiquette, tapez une version pour votre action. 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. Dans le champ de titre, tapez un titre de version.

9. 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. Sur GitHub, accédez à la page principale du référentiel.

2. À droite de la liste des fichiers, cliquez sur Mises en production.

   

3. En regard de la version que vous souhaitez modifier, cliquez sur .

   

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

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

Transfert d’un référentiel d’actions

Vous pouvez transférer un référentiel d’actions à un autre utilisateur ou une autre organisation. Pour plus d’informations, consultez « Transfert d’un dépôt ».

Quand un administrateur de référentiel transfère un référentiel d’actions, GitHub crée automatiquement une redirection de l’URL précédente vers la nouvelle URL, ce qui signifie que les flux de travail qui utilisent l’action affectée n’ont pas besoin d’être mis à jour.

Les actions publiées sur GitHub Marketplace sont liées à un référentiel par leur identificateur unique name, ce qui signifie que vous pouvez publier de nouvelles versions d’une action à partir du référentiel transféré sous la même liste GitHub Marketplace. Si un référentiel d’actions est supprimé, la liste GitHub Marketplace est également supprimée et l’identificateur unique name devient disponible.

À propos des badges dans GitHub Marketplace

Les actions qui arborent le badge ou le badge de créateur vérifié indiquent que GitHub a vérifié que le créateur de l’action est bien une organisation partenaire. Les partenaires peuvent envoyer un e-mail à partnerships@github.com pour demander le badge de créateur vérifié.