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. # Uso de variables predefinidas Las *variables predefinidas* son pares clave-valor que un flujo de trabajo emite automáticamente y que están disponibles para su uso en las acciones del flujo de trabajo. Para obtener más información acerca de las variables, consulte [Uso de variables en flujos de trabajo](workflows-working-with-variables.md). **Topics** + [ # Ejemplos de referencia a variables predefinidas ](workflows-predefined-examples.md) + [ # Referencia a una variable predefinida ](workflows-working-with-variables-reference-output-vars.md) + [ # Determinación de qué variables predefinidas emite un flujo de trabajo ](workflows-working-with-variables-determine-output-vars.md) + [ # Lista de variables predefinidas ](workflow-ref-action-variables.md) # Ejemplos de referencia a variables predefinidas En los siguientes ejemplos se muestra cómo hacer referencia a variables predefinidas en el archivo de definición del flujo de trabajo. Para obtener más información acerca de las variables, consulte [Uso de variables predefinidas](workflows-using-predefined-variables.md). **Topics** + [ ## Ejemplo: hacer referencia a la variable predefinida CommitId "» ](#workflows-working-with-variables-ex-refer-action) + [ ## Ejemplo: hacer referencia a la variable predefinida BranchName «» ](#workflows-working-with-variables-ex-branch) ## Ejemplo: hacer referencia a la variable predefinida CommitId "» El siguiente ejemplo muestra cómo hacer referencia a la variable predefinida `CommitId` en la acción `MyBuildAction`. La `CommitId` variable se genera automáticamente mediante CodeCatalyst. Para obtener más información, consulte [Lista de variables predefinidas](workflow-ref-action-variables.md). Aunque en el ejemplo se muestra la variable que se utiliza en la acción de compilación, se puede utilizar `CommitId` en cualquier acción. ``` MyBuildAction: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Configuration: Steps: #Build Docker image and tag it with a commit ID - Run: docker build -t image-repo/my-docker-image:latest . - Run: docker tag image-repo/my-docker-image:${WorkflowSource.CommitId} ``` ## Ejemplo: hacer referencia a la variable predefinida BranchName «» El siguiente ejemplo muestra cómo hacer referencia a la variable predefinida `BranchName` en la acción `CDKDeploy`. La `BranchName` variable se genera automáticamente mediante CodeCatalyst. Para obtener más información, consulte [Lista de variables predefinidas](workflow-ref-action-variables.md). Aunque en el ejemplo se muestra la variable que se utiliza en la acción **AWS CDK deploy**, se puede utilizar `BranchName` en cualquier acción. ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 Inputs: Sources: - WorkflowSource Configuration: StackName: app-stack-${WorkflowSource.BranchName} ``` # Referencia a una variable predefinida Puedes hacer referencia a variables predefinidas en cualquier acción dentro de un CodeCatalyst flujo de trabajo de Amazon. Utilice las siguientes instrucciones para hacer referencia a una variable predefinida en un flujo de trabajo. Para obtener más información acerca de las variables, consulte [Uso de variables predefinidas](workflows-using-predefined-variables.md). **Requisito previo** Determine el nombre de la variable predefinida a la que quiera hacer referencia, por ejemplo `CommitId`. Para obtener más información, consulte [Determinación de qué variables predefinidas emite un flujo de trabajo](workflows-working-with-variables-determine-output-vars.md). ------ #### [ Visual ] *No disponible. Seleccione YAML para ver las instrucciones de YAML.* ------ #### [ YAML ] **Referencia a una variable predefinida (editor de YAML)** 1. Abra la CodeCatalyst consola en [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Elija el proyecto. 1. En el panel de navegación, elija **CI/CD** y, a continuación, elija **Flujos de trabajo**. 1. Elija el nombre del flujo de trabajo. Puede filtrar por el nombre del repositorio de código fuente o la ramificación donde esté definido el flujo de trabajo, o bien por el nombre o el estado del flujo de trabajo. 1. Elija **Edit (Edición de)**. 1. Elija **YAML**. 1. En una CodeCatalyst acción, añada la referencia de variable predefinida mediante la siguiente sintaxis: ``` ${action-group-name.action-name-or-WorkflowSource.variable-name} ``` Reemplace: + *action-group-name*con el nombre del grupo de acciones. **nota** Puede omitir *action-group-name* si no hay ningún grupo de acciones o si la variable es producida por una acción del mismo grupo de acciones. + *action-name-or-WorkflowSource*con: El nombre de la acción que genere la variable. o `WorkflowSource`, si la variable es la variable `BranchName` o `CommitId`. + *variable-name*con el nombre de la variable. Por ejemplo: ``` MySecondAction: Configuration: Steps: - Run: echo ${MyFirstECSAction.cluster} ``` Otro ejemplo. ``` MySecondAction: Configuration: Steps: - Run: echo ${WorkflowSource.CommitId} ``` Para obtener más ejemplos, consulte [Ejemplos de referencia a variables predefinidas](workflows-predefined-examples.md). Para obtener más información, consulte la [Definición de flujo de trabajo en YAML](workflow-reference.md) para su acción. 1. (Opcional) Seleccione **Validar** para validar el código de YAML del flujo de trabajo antes de confirmarlo. 1. Seleccione **Confirmar**, introduzca un mensaje de confirmación y vuelva a seleccionar **Confirmar**. ------ # Determinación de qué variables predefinidas emite un flujo de trabajo Utilice el siguiente procedimiento para determinar qué variables predefinidas emite un flujo de trabajo cuando se ejecuta. A continuación, puede hacer referencia a estas variables dentro del mismo flujo de trabajo. Para obtener más información acerca de las variables, consulte [Uso de variables predefinidas](workflows-using-predefined-variables.md). **Determinación de las variables predefinidas que emite un flujo de trabajo** + Realice una de las siguientes acciones: + **Ejecute el flujo de trabajo una vez**. Una vez finalizada la ejecución, las variables emitidas por el flujo de trabajo se muestran en la pestaña **Variables** de la página de detalles de la ejecución. Para obtener más información, consulte [Visualización del estado y los detalles de la ejecución de un flujo de trabajo](workflows-view-run.md). + **Consulte la [Lista de variables predefinidas](workflow-ref-action-variables.md)**. Esta referencia muestra el nombre de la variable (clave) y el valor de cada variable predefinida. **nota** El tamaño total máximo de las variables de un flujo de trabajo aparece en [Cuotas para flujos de trabajo en CodeCatalyst](workflows-quotas.md). Si el tamaño total supera el máximo, es posible que la acción que se produce una vez alcanzado el máximo genere un error. # Lista de variables predefinidas Consulte las siguientes secciones para ver las variables predefinidas generadas automáticamente por las acciones de CodeCatalyst como parte de la ejecución de un flujo de trabajo. Para obtener más información acerca de las variables, consulte [Uso de variables predefinidas](workflows-using-predefined-variables.md). **nota** Esta lista solo incluye las variables predefinidas emitidas por el origen de CodeCatalyst y las acciones de [CodeCatalyst](workflows-actions.md#workflows-actions-types). Si utiliza otros tipos de acciones, como las GitHub Actions o las acciones de CodeCatalyst Labs, consulte [Determinación de qué variables predefinidas emite un flujo de trabajo](workflows-working-with-variables-determine-output-vars.md). **Enumeración** **nota** No todas las acciones de CodeCatalyst generan variables predefinidas. Si la acción no está en la lista, no genera variables. + [variables BranchName '' y CommitId ''](workflows-sources-variables.md) + [Variables de «implementar CloudFormation pila»](deploy-action-cfn-variables.md) + [Variables de “Implementar en Amazon ECS”](deploy-action-ecs-variables.md) + [Variables de 'Implementar en clúster de Kubernetes'](deploy-action-eks-variables.md) + [Variables de 'Implementación de AWS CDK '](cdk-dep-action-variables.md) + [Variables de 'Arranque de AWS CDK '](cdk-boot-action-variables.md) + [Variables de invocar en AWS Lambda](lam-invoke-action-variables.md) + [Variables de Render Amazon ECS task definition](render-ecs-action-variables.md)