0Pricing
CI/CD with GitHub Actions & DevOps Pipelines · Lección

Composite Actions y publicación en el Marketplace

Cree composite actions que agrupen varios pasos, versiónelas correctamente y publique su action personalizada en GitHub Marketplace para reutilizarla.

Composite Actions y publicación en el Marketplace es una lección gratuita de CI/CD with GitHub Actions & DevOps Pipelines en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de CI/CD with GitHub Actions & DevOps Pipelines, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de CI/CD with GitHub Actions & DevOps Pipelines incluye 4 lecciones en total.

Tres tipos de acciones personalizadas

GitHub admite tres formas de crear una acción personalizada:

  • Acciones de JavaScript — ejecutan código de Node
  • Acciones de Docker — se ejecutan dentro de un contenedor
  • Acciones Composite — agrupan varios pasos del flujo de trabajo

Esta lección se centra en las acciones Composite y su publicación.

Qué es una acción Composite

Una acción Composite empaqueta varios pasos run y llamadas a otras acciones en una única unidad reutilizable, sin escribir JavaScript ni crear una imagen de Docker.

Es ideal para encapsular una secuencia repetida de comandos de shell.

El archivo action.yml

Cada acción se define mediante un archivo action.yml en su raíz. Para una acción Composite, establezca runs.using en composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

Shell es obligatorio

Una regla sutil: en las acciones Composite, cada paso run debe declarar un shell. Olvidarlo es el error más común al crear acciones Composite.

    - run: echo 'hello'
      shell: bash

Definición de entradas

Haga que la acción sea configurable mediante inputs. Las personas que la llaman pasan valores mediante with, y usted hace referencia a ellos como inputs.<name>.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Definición de salidas

Una acción compuesta puede devolver salidas. Un paso escribe en GITHUB_OUTPUT y la acción lo asigna a una salida con nombre.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Uso de una acción local

Puede hacer referencia a una acción almacenada en el mismo repositorio mediante su ruta, lo que resulta muy útil durante el desarrollo antes de publicarla.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Control de versiones con etiquetas

Las acciones publicadas se referencian mediante una referencia de Git. Práctica recomendada: etiquete las versiones como v1.0.0 y mantenga también una etiqueta móvil v1.

Los consumidores que usan @v1 reciben automáticamente actualizaciones que no introducen cambios incompatibles.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Preparación para Marketplace

Para publicar en GitHub Marketplace, la acción debe estar en un repositorio público con un archivo action.yml que contenga name, description e, idealmente, branding (icono y color).

branding:
  icon: package
  color: blue

Publicación de la versión

En la página Releases del repositorio, cree un borrador de versión para su etiqueta. GitHub muestra una casilla Publish this Action to the Marketplace.

Acepte el acuerdo, elija las categorías y publique. La acción podrá ser encontrada por cualquier persona.

Documentación del uso

Una buena acción incluye un README claro con un ejemplo de uso, las entradas y las salidas.

Las empresas que evalúan su acción dependen en gran medida de esta documentación, así que manténgala precisa y completa.

Comprobación rápida

Compruebe su comprensión de las acciones compuestas.

Resumen

Ha aprendido a crear y publicar acciones compuestas.

  • Las acciones compuestas agrupan pasos mediante runs.using: composite
  • Cada paso de ejecución necesita un shell explícito
  • Exponga entradas y salidas para facilitar la reutilización
  • Etiquete con versiones semánticas y una etiqueta principal móvil, y publique después en Marketplace

Las acciones reutilizables permiten a los equipos escalar la lógica compartida de CI/CD.

Preguntas frecuentes

¿La lección «Composite Actions y publicación en el Marketplace» es gratis?

Sí — el texto completo de «Composite Actions y publicación en el Marketplace» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de CI/CD with GitHub Actions & DevOps Pipelines, actualiza a CoddyKit PRO. El curso de CI/CD with GitHub Actions & DevOps Pipelines incluye 4 lecciones en total.

¿Qué aprenderé en «Composite Actions y publicación en el Marketplace»?

Cree composite actions que agrupen varios pasos, versiónelas correctamente y publique su action personalizada en GitHub Marketplace para reutilizarla. Practicas CI/CD with GitHub Actions & DevOps Pipelines con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar CI/CD with GitHub Actions & DevOps Pipelines?

No se requiere experiencia previa. CI/CD with GitHub Actions & DevOps Pipelines en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «Composite Actions y publicación en el Marketplace»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de CI/CD with GitHub Actions & DevOps Pipelines?

Sí. Cada lección de CI/CD with GitHub Actions & DevOps Pipelines incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

  1. Desarrollo de GitHub Actions personalizadas
  2. Runners autohospedados para entornos locales
  3. Integración con sistemas empresariales
  4. Composite Actions y publicación en el Marketplace
← Volver a CI/CD with GitHub Actions & DevOps Pipelines