Skip to main content

Publicar acciones en GitHub Marketplace

Puedes publicar acciones en GitHub Marketplace y compartir acciones que has creado con la comunidad de GitHub.

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 «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 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.com, navega a 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 .

    Nota: La casilla "Publicar" 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.com, navega a la página principal del repositorio.

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

    Captura de pantalla de la página principal de un repositorio. Un vínculo con la etiqueta "Versiones" aparece resaltado con un contorno naranja.

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

    Captura de pantalla de una versión en la lista de versiones. Un icono de lápiz está resaltado con un contorno naranja.

  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.

Nota: El distintivo «Verificado» que se ve en el perfil de GitHub de una organización es diferente del distintivo de creador verificado en GitHub Marketplace. Si transfieres un repositorio de acciones, la lista de GitHub Marketplace perderá el distintivo de creador verificado a menos que el nuevo propietario también sea un creador verificado.

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 partnerships@github.com para solicitar la insignia de creador verificado.

Captura de pantalla de GitHub Actions con el distintivo de creador comprobado.