Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).

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.

# Introducción a los flujos de trabajo
<a name="workflows-getting-started"></a>

En este tutorial, aprenderá a crear y configurar un primer flujo de trabajo.

**sugerencia**  
¿Prefiere empezar con un flujo de trabajo preconfigurado? Consulte [Creación de un proyecto con un esquema](projects-create.md#projects-create-console-template), que incluye instrucciones para configurar un proyecto con un flujo de trabajo funcional, una aplicación de muestra y otros recursos.

**Topics**
+ [Requisitos previos](#get-started-create-workflow-prerequisites)
+ [Paso 1: creación y configuración del flujo de trabajo](#get-started-create-workflow-create)
+ [Paso 2: guardado del flujo de trabajo con una confirmación](#get-started-create-workflow-commit)
+ [Paso 3: visualización de los resultados de la ejecución](#get-started-create-workflow-results)
+ [(Opcional) Paso 4: limpieza](#get-started-create-workflow-cleanup)

## Requisitos previos
<a name="get-started-create-workflow-prerequisites"></a>

Antes de empezar:
+ Necesitas un CodeCatalyst **espacio**. Para obtener más información, consulte [Creación de un espacio](spaces-create.md).
+ En tu CodeCatalyst espacio, necesitas un proyecto vacío llamado:

  ```
  codecatalyst-project
  ```

   Para obtener más información, consulte [Crear un proyecto vacío en Amazon CodeCatalyst](projects-create.md#projects-create-empty).
+ En tu proyecto, necesitas un CodeCatalyst **repositorio** llamado:

  ```
  codecatalyst-source-repository
  ```

  Para obtener más información, consulte [Creación de un repositorio de código fuente](source-repositories-create.md).

**nota**  
Si tiene un proyecto y un repositorio de código fuente existentes, puede usarlos; sin embargo, crear unos nuevos facilita la limpieza que se desarrollará al final de este tutorial.

## Paso 1: creación y configuración del flujo de trabajo
<a name="get-started-create-workflow-create"></a>

En este paso, creará y configurará un flujo de trabajo que compilará y probará automáticamente el código fuente cuando se realicen cambios.

**Creación de un flujo de trabajo**

1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**.

1. Seleccione **Crear flujo de trabajo**.

   El archivo de definición del flujo de trabajo aparece en el editor YAML de la CodeCatalyst consola.

**Configuración del flujo de trabajo**

Puede configurar su flujo de trabajo en el editor **visual** o en el editor de **YAML**. Empecemos con el editor de YAML y, a continuación, pasemos al editor visual.

1. Seleccione **\$1 Acciones** para ver una lista de acciones del flujo de trabajo que puede agregar a su flujo de trabajo.

1. En la acción **Compilación**, seleccione **\$1** para añadir el YAML de la acción al archivo de definición del flujo de trabajo. Ahora, el flujo de trabajo tendrá un aspecto similar al siguiente.

   ```
   Name: Workflow_fe47
   SchemaVersion: "1.0"
   
   # Optional - Set automatic triggers.
   Triggers:
     - Type: Push
       Branches:
         - main
   
   # Required - Define action configurations.
   Actions:
     Build_f0:
       Identifier: aws/build@v1
   
       Inputs:
         Sources:
           - WorkflowSource # This specifies that the action requires this workflow as a source
   
       Outputs:
         AutoDiscoverReports:
           Enabled: true
           # Use as prefix for the report files
           ReportNamePrefix: rpt
   
       Configuration:
         Steps:
           - Run: echo "Hello, World!"
           - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml
           - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml
           - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy
               Test\"/></testsuite>" >> report.xml
   ```

   El flujo de trabajo copia los archivos del repositorio de `WorkflowSource` origen en la máquina de procesamiento que ejecuta la `Build_f0` acción, los imprime `Hello, World!` en los registros, descubre los informes de las pruebas en la máquina de procesamiento y los envía a la página de **informes** de la CodeCatalyst consola.

1. Seleccione **Visual** para ver el archivo de definición del flujo de trabajo en el editor visual. Los campos del editor visual permiten configurar las propiedades de YAML que se muestran en el editor de YAML.

## Paso 2: guardado del flujo de trabajo con una confirmación
<a name="get-started-create-workflow-commit"></a>

En este paso, guardará los cambios. Dado que los flujos de trabajo se almacenan como archivos `.yaml` en el repositorio, los cambios se guardan con confirmaciones.

**Confirmación de los cambios del flujo de trabajo**

1. (Opcional) Seleccione **Validar** para asegurarse de que el código de YAML del flujo de trabajo sea válido.

1. Elija **Confirmar**.

1. En **Nombre del archivo de flujo de trabajo**, introduzca un nombre para el archivo de configuración del flujo de trabajo, por ejemplo **my-first-workflow**.

1. En **Mensaje de confirmación**, especifique un mensaje para identificar la confirmación, por ejemplo **create my-first-workflow.yaml**.

1. En **Repositorio**, seleccione el repositorio en el que quiera guardar el flujo de trabajo (`codecatalyst-repository`).

1. En **Nombre de la ramificación**, seleccione la ramificación en la que quiera guardar el flujo de trabajo (`main`).

1. Elija **Confirmar**.

El nuevo flujo de trabajo aparece en la lista de flujos de trabajo. Puede que tarde unos momentos en aparecer.

Como los flujos de trabajo se guardan con confirmaciones, y dado que el flujo de trabajo tiene un desencadenador de inserción de código configurado, al guardar el flujo de trabajo se inicia un flujo de trabajo que se ejecuta automáticamente.

## Paso 3: visualización de los resultados de la ejecución
<a name="get-started-create-workflow-results"></a>

En este paso, navegará hasta la ejecución que se inició desde la confirmación y verá los resultados.

**Visualización de los resultados de ejecución**

1. Seleccione el nombre del flujo de trabajo, por ejemplo, `Workflow_fe47`.

   Un diagrama de flujo de trabajo que muestra la etiqueta del repositorio de origen (**WorkflowSource**) y la acción de compilación (por ejemplo, **build\$1F0**).

1. En el diagrama de ejecución del flujo de trabajo, seleccione la acción de compilación, (por ejemplo, **Build\$1f0**).

1. Revise el contenido de las pestañas **Registros**, **Informes**, **Configuración** y **Variables**. Estas pestañas muestran los resultados de la acción de compilación.

   Para obtener más información, consulte [Consulta de los resultados de una acción de compilación](build-view-results.md).

## (Opcional) Paso 4: limpieza
<a name="get-started-create-workflow-cleanup"></a>

En este paso, limpiará los recursos que ha creado en este tutorial.

**Eliminación de recursos**
+ Si ha creado un proyecto nuevo para este tutorial, elimínelo. Para obtener instrucciones, consulte [Eliminación de un proyecto](projects-delete.md). Al eliminar el proyecto, también se eliminan el repositorio de código fuente y el flujo de trabajo.