Publicar acciones en GitHub Marketplace

Requisitos previos

Antes de que puedas publicar una acción, deberás crear una acción en tu repositorio. Para más información, consulta Reutilización de automatizaciones.

Cuando vaya a publicar su acción en GitHub Marketplace, deberá asegurarse de que el repositorio solo incluya el archivo de metadatos, el código y los archivos necesarios para la acción. Crear un repositorio único para la acción te permite etiquetar, lanzar y empaquetar el código en una sola unidad. GitHub también usa los metadatos de la acción en tu página GitHub Marketplace.

Las acciones se publican en GitHub Marketplace inmediatamente y no son revisadas por GitHub siempre que cumplan estos requisitos:

• La acción debe estar en un repositorio público.
• Cada repositorio debe contener un solo archivo de metadatos de acción (action.yml o action.yaml) en la raíz.
  • Los repositorios pueden incluir otros archivos de metadatos de acciones en subcarpetas, pero no se mostrarán automáticamente en Marketplace.
• El elemento name en el archivo de metadatos de la acción debe ser único.
  • El name no puede coincidir con un nombre de acción existente ya publicado en GitHub Marketplace.
  • El name no puede coincidir con un usuario u organización en GitHub, a menos que el usuario o el propietario de la organización publique la acción. Por ejemplo, solo la GitHub organización puede publicar una acción denominada github.
  • El name no puede coincidir con una categoría GitHub Marketplace existente.
  • GitHub reserva los nombres de las funciones de GitHub.

Publicación de una acción

Puede agregar la acción que ha creado a GitHub Marketplace etiquetándola como una nueva versión y publicándola.

Para redactar una nueva versión y publicar la acción en GitHub Marketplace, siga estas instrucciones:

1. En GitHub, navegue hasta la página principal del repositorio.

2. Vaya al archivo de metadatos de acción en el repositorio (action.yml) y verá un banner para publicar la acción en GitHub Marketplace. Haz clic en Redactar una versión.

3. En "Acción de publicación", seleccione Publicar esta acción en el GitHub Marketplace.

   Nota:

   La casilla "Publicar" está deshabilitada si la cuenta propietaria del repositorio aún no ha aceptado el GitHub Marketplace Contrato de desarrollador. Si eres el propietario del repositorio o eres propietario de una organización, haz clic en el vínculo para "aceptar el contrato para desarrolladores de Marketplace de GitHub" y, luego, acepta el contrato. Si no hay ningún vínculo, envía al propietario de la organización un vínculo a la página "Acción de lanzamiento" y pídele que acepte el contrato.

4. Si las etiquetas de tu archivo de metadatos contienen algún problema, verás un mensaje de error o uno de advertencia. Para solucionarlos, actualiza el archivo de metadatos. Una vez que esté completo, verás un mensaje "Everything looks Good!" (Todo se ve bien). de la directiva).

5. Seleccione el menú desplegable Categoría principal y haga clic en una categoría que ayude a las personas a encontrar la acción en GitHub Marketplace.

6. Opcionalmente, selecciona el menú desplegable Otra categoría y haz clic en una categoría secundaria.

7. En el campo de etiqueta, escribe una versión para tu acción. Esto permite que las personas conozcan qué cambios o características incluye el lanzamiento. Las personas verán la versión en la página específica de la acción GitHub Marketplace.

8. En el campo de título, escribe un título de lanzamiento.

9. Completa todos los demás campos y haz clic en Publicar versión. La publicación requiere que uses la autenticación de dos factores. Para más información, consulta Configurar la autenticación de dos factores.

Quitar una acción de GitHub Marketplace

Para eliminar una acción publicada de GitHub Marketplace, tendrás que actualizar cada publicación publicada. Realice los pasos siguientes para cada versión de la acción que ha publicado en GitHub Marketplace.

1. En GitHub, navegue hasta la página principal del repositorio.

2. A la derecha de la lista de archivos, haga clic en Releases.

   

3. Junto a la versión que deseas editar, haz clic en .

   

4. Seleccione Publicar esta acción en GitHub Marketplace para desmarcar la casilla.

5. En la parte inferior de la página, haz clic en Actualizar versión.

Transferencia de un repositorio de acciones

Puedes transferir un repositorio de acciones a otra cuenta de usuario u organización. Para más información, consulta Transferir un repositorio.

Cuando un administrador del repositorio transfiere un repositorio de acciones, GitHub crea automáticamente una redirección de la dirección URL anterior a la nueva dirección URL, lo que significa que los flujos de trabajo que usan la acción afectada no necesitan actualizarse.

Las acciones publicadas en GitHub Marketplace están vinculadas a un repositorio por su identificador único name , lo que significa que puede publicar nuevas versiones de una acción desde el repositorio transferido en la misma GitHub Marketplace lista. Si se elimina un repositorio de acciones, la GitHub Marketplace lista también se elimina y el identificador único name está disponible.

Acerca de las insignias en GitHub Marketplace

Las acciones con la insignia , o insignia de creador verificado, indican que GitHub ha verificado al creador de la acción como organización asociada. Los partners pueden enviar un correo electrónico a partnerships@github.com para solicitar la insignia de creador verificado.