Integración con GitHub Actions - Amazon CodeCatalyst
¿En qué se diferencian las acciones de GitHub de las acciones de CodeCatalyst?¿Pueden las acciones de GitHub interactuar con otras acciones de CodeCatalyst en el flujo de trabajo?¿Qué acciones de GitHub puedo usar?Limitaciones de las acciones de GitHub en CodeCatalyst¿Cómo añado una acción de GitHub (pasos generales)?¿La acción de GitHub se ejecuta en GitHub?¿Puedo usar también los flujos de trabajo de GitHub?Imagen de tiempo de ejecución utilizada por la acción de GitHub Actions

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración con GitHub Actions

Una GitHub Action se parece mucho a una acción de CodeCatalyst, excepto que se ha desarrollado para usarse con los flujos de trabajo de GitHub. Para obtener detalles sobre GitHub Actions, consulte la documentación de GitHub Actions.

Puede usar GitHub Actions junto con las acciones nativas de CodeCatalyst en un flujo de trabajo de CodeCatalyst.

Hay dos maneras de añadir una acción de GitHub a un flujo de trabajo de CodeCatalyst:

  • Puede seleccionar la acción de GitHub de una lista seleccionada en la consola de CodeCatalyst. Hay disponibles varias acciones de GitHub populares. Para obtener más información, consulte Adición de una acción de GitHub seleccionada.

  • Si la acción de GitHub que desea usar no está disponible en la consola de CodeCatalyst, puede añadirla mediante una acción de GitHub Actions.

    Una acción de GitHub Actions es una acción de CodeCatalyst que contiene una acción de GitHub y hace que sea compatible con los flujos de trabajo de CodeCatalyst.

    Este es un ejemplo de una acción de GitHub Actions que contiene a la acción Super-Linter de GitHub:

    Actions:
  GitHubAction:
    Identifier: aws/github-actions-runner@v1
    Configuration:
      Steps:
        - name: Lint Code Base
          uses: github/super-linter@v4
          env:
            VALIDATE_ALL_CODEBASE: "true"
            DEFAULT_BRANCH: main

    En el código anterior, la acción de GitHub Actions de CodeCatalyst (identificada por aws/github-actions-runner@v1) envuelve la acción Super-Linter (identificada por github/super-linter@v4), lo que hace que funcione en un flujo de trabajo de CodeCatalyst.

    Para obtener más información, consulte Adicción de la acción de GitHub Actions.

Todas las acciones de GitHub, tanto las seleccionadas como las no seleccionadas, deben estar encapsuladas en una acción de GitHub Actions (aws/github-actions-runner@v1), como se muestra en el ejemplo anterior. El encapsulado es necesario para que la acción funcione correctamente.

Temas

¿En qué se diferencian las acciones de GitHub de las acciones de CodeCatalyst?

Las acciones de GitHub que se usan dentro de un flujo de trabajo de CodeCatalyst no tienen el mismo nivel de acceso ni de integración con las características de CodeCatalyst y AWS (como los entornos y los problemas) que las acciones de CodeCatalyst.

¿Pueden las acciones de GitHub interactuar con otras acciones de CodeCatalyst en el flujo de trabajo?

Sí. Por ejemplo, las acciones de GitHub pueden usar variables generadas por otras acciones de CodeCatalyst como entrada, y también pueden compartir los artefactos y los parámetros de salida con las acciones de CodeCatalyst. Para obtener más información, consulte Exportación de los parámetros de salida de GitHub y Referencia a los parámetros de salida de GitHub.

¿Qué acciones de GitHub puedo usar?

Puede usar cualquier acción de GitHub disponible en la consola de CodeCatalyst y cualquier acción de GitHub disponible en GitHub Marketplace. Si decide usar una acción de GitHub del Marketplace, tenga en cuenta las siguientes limitaciones.

Limitaciones de las acciones de GitHub en CodeCatalyst

  • Las acciones de GitHub que dependen internamente del contexto de github o que hacen referencia a recursos específicos de GitHub no funcionarán en CodeCatalyst. Por ejemplo, las siguientes acciones no funcionarán en CodeCatalyst:

    • Acciones que intentan añadir, cambiar o actualizar recursos de GitHub. Los ejemplos incluyen las acciones que actualizan solicitudes de extracción o generan problemas en GitHub.

    • Casi todas las acciones se enumeran en https://github.com/actions.

  • Las acciones de GitHub que sean acciones de contenedor de Docker funcionarán, pero deben ejecutarse por el usuario de Docker predeterminado (root). No ejecute la acción como usuario 1001. (En el momento de escribir este artículo, el usuario 1001 funciona en GitHub, pero no en CodeCatalyst). Para obtener más información, consulte el tema USER en la asistencia sobre Dockerfile para GitHub Actions.

Para obtener una lista de las acciones de GitHub disponibles en la consola de CodeCatalyst, consulte Adición de una acción de GitHub seleccionada.

¿Cómo añado una acción de GitHub (pasos generales)?

Los pasos generales para añadir una acción de GitHub a un flujo de trabajo de CodeCatalyst son los siguientes:

  1. En su proyecto de CodeCatalyst, cree un flujo de trabajo. El flujo de trabajo es el lugar en el que puede definir cómo compilar, probar e implementar la aplicación. Para obtener más información, consulte Introducción a los flujos de trabajo.

  2. En el flujo de trabajo, añada una acción de GitHub seleccionada o añada la acción de GitHub Actions.

  3. Puede elegir una de las opciones siguientes:

    • Si elige añadir una acción seleccionada, configúrela. Para obtener más información, consulte Adición de una acción de GitHub seleccionada.

    • Si elige añadir una acción no seleccionada, pegue el código de YAML de la acción de GitHub dentro de la acción de GitHub Actions. Puede encontrar este código en la página de detalles de la acción de GitHub, en GitHub Marketplace. Es probable que tenga que modificar ligeramente el código para que funcione en CodeCatalyst. Para obtener más información, consulte Adicción de la acción de GitHub Actions.

  4. (Opcional) Dentro del flujo de trabajo, añada otras acciones, como las acciones de compilación y prueba. Para obtener más información, consulte Creación, pruebas e implementaciones con flujos de trabajo.

  5. Inicie el flujo de trabajo de forma manual o automática mediante un desencadenador. El flujo de trabajo ejecuta la acción de GitHub y cualquier otra acción del flujo de trabajo. Para obtener más información, consulte Inicio manual de la ejecución de un flujo de trabajo.

Para ver los pasos detallados, consulte:

¿La acción de GitHub se ejecuta en GitHub?

No. La acción de GitHub se ejecuta en CodeCatalyst utilizando la imagen del entorno de tiempo de ejecución de CodeCatalyst.

¿Puedo usar también los flujos de trabajo de GitHub?

No.

Imagen de tiempo de ejecución utilizada por la acción de GitHub Actions

La acción de GitHub Actions en CodeCatalyst se ejecuta en una imagen de noviembre de 2022. Para obtener más información, consulte Imágenes activas.