Cree, pruebe e implemente con flujos de trabajo en CodeCatalyst

Tras escribir el código de tu aplicación en CodeCatalystun entorno de desarrollo y subirlo a tu repositorio de CodeCatalyst código fuente, estarás listo para implementarlo. La forma de hacerlo automáticamente es mediante un flujo de trabajo.

Un flujo de trabajo es un procedimiento automatizado que describe cómo crear, probar e implementar el código como parte de un sistema de integración y entrega continuas (CI/CD). Un flujo de trabajo define una serie de pasos o acciones que se deben realizar durante la ejecución de un flujo de trabajo. Un flujo de trabajo también define los eventos, o desencadenantes, que provocan el inicio del flujo de trabajo. Para configurar un flujo de trabajo, debe crear un archivo de definición del flujo de trabajo mediante el editor visual o YAML de la CodeCatalyst consola.

sugerencia

Para ver rápidamente cómo puedes usar los flujos de trabajo en un proyecto, crea un proyecto con un plano. Cada esquema implementa un flujo de trabajo funcional que puede revisar, ejecutar y experimentar.

Acerca del archivo de definición del flujo de trabajo

Un archivo de definición de flujo de trabajo es un archivo YAML que describe el flujo de trabajo. El archivo se almacena en una ~/.codecatalyst/workflows/ carpeta en la raíz del repositorio de origen. El archivo puede tener la extensión.yml o .yaml.

El siguiente es un ejemplo de un archivo de definición de flujo de trabajo sencillo. Explicamos cada línea de este ejemplo en la siguiente tabla.

Name: MyWorkflow
SchemaVersion: 1.0
RunMode: QUEUED
Triggers:
  - Type: PUSH
    Branches:
      - main
Actions:
  Build:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:     
      Steps:
        - Run: docker build -t MyApp:latest .

Línea	Descripción
Name: MyWorkflow	Especifica el nombre del flujo de trabajo. Para obtener más información sobre la Name propiedad, consultePropiedades de nivel superior.
SchemaVersion: 1.0	Especifica la versión del esquema de flujo de trabajo. Para obtener más información sobre la SchemaVersion propiedad, consultePropiedades de nivel superior.
RunMode: QUEUED	Indica cómo CodeCatalyst gestiona las ejecuciones múltiples. Para obtener más información sobre el modo de ejecución, consulteConfiguración del comportamiento de puesta en cola de las corridas.
Triggers:	Especifica la lógica que hará que se inicie la ejecución de un flujo de trabajo. Para obtener más información acerca de los disparadores, consulte Iniciar un flujo de trabajo, ejecutarlo automáticamente con activadores.
- Type: PUSH Branches: - main	Indica que el flujo de trabajo debe iniciarse siempre que insertes código main en la rama del repositorio fuente predeterminado. Para obtener más información sobre la fuente del flujo de trabajo, consulteConexión de un flujo de trabajo a un repositorio de origen.
Actions:	Define las tareas que se van a realizar durante la ejecución de un flujo de trabajo. En este ejemplo, la Actions sección define una sola acción llamadaBuild. Para obtener más información sobre las acciones, consulteConfiguración de las acciones que realiza un flujo de trabajo.
Build:	Define las propiedades de la Build acción. Para obtener más información sobre la acción de creación, consulteConstruir con flujos de trabajo.
Identifier: aws/build@v1	Especifica el identificador único y codificado de la acción de creación.
Inputs: Sources: - WorkflowSource	Indica que la acción de compilación debe buscar en el repositorio de WorkflowSource origen los archivos que necesita para completar su procesamiento. Para obtener más información, consulte Conexión de un flujo de trabajo a un repositorio de origen.
Configuration:	Contiene las propiedades de configuración específicas de la acción de compilación.
Steps: - Run: docker build -t MyApp:latest .	Indica a la acción de compilación que debe crear una imagen de Docker llamada MyApp y etiquetarla. latest

Para obtener una lista completa de todas las propiedades disponibles en el archivo de definición del flujo de trabajo, consulte. Definición de flujo de trabajo YAML

Uso de los CodeCatalyst editores visuales y YAML de la consola

Para crear y editar el archivo de definición del flujo de trabajo, puedes usar el editor que prefieras, pero te recomendamos usar el editor visual o el editor YAML de la CodeCatalyst consola. Estos editores ofrecen una útil validación de archivos para garantizar que los nombres de las propiedades, los valores, el anidamiento, el espaciado, el uso de mayúsculas, etc. de YAML sean correctos.

La siguiente imagen muestra un flujo de trabajo en el editor visual. El editor visual le ofrece una interfaz de usuario completa a través de la cual puede crear y configurar el archivo de definición del flujo de trabajo. El editor visual incluye un diagrama de flujo de trabajo (1) que muestra los componentes principales del flujo de trabajo y un área de configuración (2).

Como alternativa, puedes usar el editor YAML, que se muestra en la siguiente imagen. Usa el editor YAML para pegar bloques de código grandes (de un tutorial, por ejemplo) o para añadir propiedades avanzadas que no se ofrecen en el editor visual.

Puedes cambiar del editor visual al editor YAML para ver el efecto que tienen tus configuraciones en el código YAML subyacente.

Descubriendo flujos de trabajo

Puedes ver tu flujo de trabajo en la página de resumen de los flujos de trabajo, junto con otros flujos de trabajo que hayas configurado en el mismo proyecto.

La siguiente imagen muestra la página de resumen de los flujos de trabajo. Se rellena con dos flujos de trabajo: BuildToPrody UnitTests. Puede ver que ambos se han ejecutado varias veces. Puedes elegir Ejecuciones recientes para ver rápidamente el historial de ejecuciones o elegir el nombre del flujo de trabajo para ver el código YAML del flujo de trabajo y otra información detallada.

Ver los detalles de ejecución del flujo de trabajo

Para ver los detalles de una ejecución de flujo de trabajo, seleccione la ejecución en la página de resumen de los flujos de trabajo.

La siguiente imagen muestra los detalles de una ejecución de flujo de trabajo llamada Run-CC11d que se inició automáticamente al confirmarse con la fuente. El diagrama de flujo de trabajo indica que se ha producido un error en una acción (1). Puede navegar hasta los registros (2) para ver los mensajes de registro detallados y solucionar problemas. Para obtener más información sobre las ejecuciones del flujo de trabajo, consulteEjecución de un flujo de trabajo.

Siguientes pasos

Para obtener más información sobre los conceptos de flujos de trabajo, consulteConceptos de flujos de.

Para crear su primer flujo de trabajo, consulteIntroducción a los flujos de trabajo.