Publicar acciones en GitHub Marketplace

Debes aceptar los términos de servicio para publicar acciones en GitHub Marketplace.

Acerca de la publicación de acciones

Antes de que puedas publicar una acción, deberás crear una acción en tu repositorio. Para obtener más información, consulta la sección "Crear acciones".

Cuando planeas publicar tu acción en GitHub Marketplace, necesitarás asegurarte 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 de GitHub Marketplace.

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

• La acción debe estar en un repositorio público.
• Cada repositorio debe contener una única acción.
• El archivo de metadatos de la acción (action.yml o action.yaml) debe estar en el directorio raíz del repositorio.
• El Nombre en el archivo de metadatos de la acción debe ser único.
  • El Nombre no debe coincidir con el nombre de una acción existente publicada en GitHub Marketplace.
  • El Nombre no debe coincidir con un usuario u organización en GitHub, excepto que el usuario o el propietario de la organización publique la acción. Por ejemplo, solo la organización GitHub puede publicar una acción denominada Github.
  • El Nombre no debe coincidir con una categoría existente de GitHub Marketplace.
  • GitHub reserva los nombres de las funciones de GitHub.

Publicar una acción

Puedes agregar la acción que has creado para GitHub Marketplace etiquetándola como un lanzamiento nuevo y publicándola.

Para preparar un nuevo lanzamiento y publicar la acción en GitHub Marketplace, sigue estas instrucciones:

1. En GitHub.com, visita la página principal del repositorio.
2. Cuando un repositorio contiene un archivo de metadatos de acción (action.yml o action.yaml), verás un mensaje emergente para publicar la acción en GitHub Marketplace. Haz clic en Draft a release (Crear el borrador de un lanzamiento).
3. Selecciona Publish this action to the (Publicar esta acción en) GitHub Marketplace. Si no puedes seleccionar la casilla de verificación Publish this action to the (Publicar esta acción en) GitHub Marketplace, deberás leer y aceptar el acuerdo primero GitHub Marketplace.
4. Si las etiquetas en tu archivo de metadatos contienen algún problema, verás un mensaje de error.
5. Si ves alguna sugerencia en pantalla, la solucionas actualizando tu archivo de metadatos. Una vez que esté completo, verás un mensaje "Everything looks Good" (Todo se ve bien).
6. Elige una "Primary Category" (Categoría principal) y, de manera opcional, "Another Category" (Otra categoría) que ayudará a las personas a encontrar tu acción en GitHub Marketplace.
7. Etiqueta tu acción con una versión y agrega un título de lanzamiento. 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 dedicada a la acción de GitHub Marketplace.
8. Completa todos los demás campos y haz clic en Publish release (Publicar versión). La publicación requiere que uses la autenticación de dos factores. Para obtener más información, consulta "Configurar autenticación de dos factores".

Eliminando una acción de GitHub Marketplace

Para eliminar una acción publicada del GitHub Marketplace, necesitarás actualizar cada lanzamiento publicado. Realiza los siguientes pasos para cada lanzamiento de la acción que has publicado en GitHub Marketplace.

1. En GitHub.com, visita la página principal del repositorio.
2. A la derecha de la lista de archivos, haz clic en Lanzamientos.
3. En la página Lanzamientos, a la derecha del lanzamiento que deseas editar, haz clic en Editar.
4. Selecciona Publish this action to the (Publicar esta acción en) GitHub Marketplace para eliminar el tilde de la casilla.
5. Haz clic en Update release (Actualizar versión) en la parte inferior de la página.