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, vea «Uso compartido de automatizaciones».

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 sola acción.
• Cada repositorio no debe contener ningún archivo de flujo de trabajo.
• El archivo de metadatos de la acción (action.yml o action.yaml) debe estar en el directorio raíz del repositorio.
• El elemento name en el archivo de metadatos de la acción debe ser único.
  • El elemento name no debe coincidir con el nombre de una acción existente publicada en GitHub Marketplace.
  • El elemento name no debe 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 organización GitHub puede publicar una acción denominada github.
  • El elemento name no debe coincidir con una categoría existente de GitHub Marketplace.
  • GitHub reserva los nombres de las funciones de GitHub.

Publicación de 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, navegue hasta la página principal del repositorio.

2. Navega al archivo de metadatos de acción en el repositorio (action.yml o action.yaml), verás un banner para publicar la acción en GitHub Marketplace. Haz clic en Borrador de una versión.

3. En "Acción de lanzamiento", selecciona Publicar esta acción en GitHub Marketplace .

   Note

   La casilla "Publish" está deshabilitada si la cuenta propietaria del repositorio aún no ha aceptado el contrato de desarrollador de GitHub Marketplace. 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 en tu archivo de metadatos contienen algún problema, verás un mensaje de error. Para solucionarlos, actualiza el archivo de metadatos. Una vez que esté completo, verás un mensaje "Everything looks Good!" (Todo se ve bien). "Hola mundo".

5. Selecciona el menú desplegable Categoría principal y haz clic en una categoría que ayude a los usuarios 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 la 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 dedicada a la acción de GitHub Marketplace.

8. En el campo de título, escribe un título de versión.

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 obtener más información, vea «Configurar la 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, 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. Selecciona Publicar esta acción en GitHub Marketplace para quitar la marca del cuadro.

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 obtener más información, vea «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 no es necesario actualizar los flujos de trabajo que usan la acción afectada.

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

Acerca de las insignias de GitHub Marketplace

Las acciones con la o la insignia de creador verificado indican que GitHub ha verificado al creador de esta acción como socio de la organización. Los partners pueden enviar un correo electrónico a [email protected] para solicitar la insignia de creador verificado.