A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md). As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Usar variáveis predefinidas *Variáveis predefinidas* são pares de chave-valor emitidos automaticamente por um fluxo de trabalho e disponibilizados para você usar em ações de fluxo de trabalho. Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). **Topics** + [Exemplos de referência de variáveis predefinidas](workflows-predefined-examples.md) + [Referência a uma variável predefinida](workflows-working-with-variables-reference-output-vars.md) + [Determinação de quais variáveis predefinidas seu fluxo de trabalho emite](workflows-working-with-variables-determine-output-vars.md) + [Lista de variáveis predefinidas](workflow-ref-action-variables.md) # Exemplos de referência de variáveis predefinidas Os exemplos a seguir mostram como fazer referência a variáveis predefinidas no arquivo de definição de fluxo de trabalho. Para ter mais informações sobre variáveis predefinidas, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md). **Topics** + [Exemplo: referenciando a variável predefinida CommitId "”](#workflows-working-with-variables-ex-refer-action) + [Exemplo: referenciando a variável predefinida BranchName "”](#workflows-working-with-variables-ex-branch) ## Exemplo: referenciando a variável predefinida CommitId "” O exemplo a seguir mostra como fazer referência à variável predefinida `CommitId` na ação `MyBuildAction`. A `CommitId` variável é gerada automaticamente por CodeCatalyst. Para obter mais informações, consulte [Lista de variáveis predefinidas](workflow-ref-action-variables.md). Embora o exemplo mostre a variável que está sendo usada na ação de criação, você pode usar `CommitId` em qualquer ação. ``` 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} ``` ## Exemplo: referenciando a variável predefinida BranchName "” O exemplo a seguir mostra como fazer referência à variável predefinida `BranchName` na ação `CDKDeploy`. A `BranchName` variável é gerada automaticamente por CodeCatalyst. Para obter mais informações, consulte [Lista de variáveis predefinidas](workflow-ref-action-variables.md). Embora o exemplo mostre a variável que está sendo usada na ação **implantar AWS CDK **, você pode usar `BranchName` em qualquer ação. ``` CDKDeploy: Identifier: aws/cdk-deploy@v2 Inputs: Sources: - WorkflowSource Configuration: StackName: app-stack-${WorkflowSource.BranchName} ``` # Referência a uma variável predefinida Você pode referenciar variáveis predefinidas em qualquer ação dentro de um CodeCatalyst fluxo de trabalho da Amazon. Use as instruções a seguir para referenciar uma variável predefinida em um fluxo de trabalho. Para ter mais informações sobre variáveis predefinidas, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md). **Pré-requisito** Determine o nome da variável predefinida que você deseja referenciar, como `CommitId`. Para obter mais informações, consulte [Determinação de quais variáveis predefinidas seu fluxo de trabalho emite](workflows-working-with-variables-determine-output-vars.md). ------ #### [ Visual ] *Não disponível. Escolha YAML para visualizar as instruções YAML.* ------ #### [ YAML ] **Como fazer referência a uma variável predefinida (editor YAML)** 1. Abra o CodeCatalyst console em [https://codecatalyst.aws/](https://codecatalyst.aws/). 1. Selecione o projeto. 1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**. 1. Selecione o nome do fluxo de trabalho. É possível filtrar pelo nome do repositório ou da ramificação de origem em que o fluxo de trabalho está definido, ou filtrar pelo nome ou o status do fluxo de trabalho. 1. Escolha **Editar**. 1. Selecione **YAML**. 1. Em uma CodeCatalyst ação, adicione a referência de variável predefinida usando a seguinte sintaxe: ``` ${action-group-name.action-name-or-WorkflowSource.variable-name} ``` Substitua: + *action-group-name*com o nome do grupo de ação. **nota** Você pode omitir *action-group-name* se não houver um grupo de ações ou se a variável for produzida por uma ação no mesmo grupo de ações. + *action-name-or-WorkflowSource*com: O nome da ação que gera a variável. or `WorkflowSource`, se a variável for `BranchName` ou `CommitId`. + *variable-name*com o nome da variável. Por exemplo: ``` MySecondAction: Configuration: Steps: - Run: echo ${MyFirstECSAction.cluster} ``` Outro exemplo: ``` MySecondAction: Configuration: Steps: - Run: echo ${WorkflowSource.CommitId} ``` Para obter mais exemplos, consulte [Exemplos de referência de variáveis predefinidas](workflows-predefined-examples.md). Para ter mais informações, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) para sua ação. 1. (Opcional) Selecione **Validar** para validar o código YAML do fluxo de trabalho antes de confirmar. 1. Selecione **Confirmar**, insira uma mensagem de confirmação e escolha **Confirmar** novamente. ------ # Determinação de quais variáveis predefinidas seu fluxo de trabalho emite Use o seguinte procedimento para determinar quais variáveis predefinidas um fluxo de trabalho emite quando executado. Em seguida, você pode referenciar essas variáveis no mesmo fluxo de trabalho. Para ter mais informações sobre variáveis predefinidas, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md). **Como determinar as variáveis predefinidas que seu fluxo de trabalho emite** + Execute um destes procedimentos: + **Execute o fluxo de trabalho uma vez**. Após a conclusão da execução, as variáveis emitidas pelo fluxo de trabalho são exibidas na guia **Variáveis** da página de detalhes da execução. Para obter mais informações, consulte [Visualização do status e detalhes de execução do fluxo de trabalho](workflows-view-run.md). + **Consulte [Lista de variáveis predefinidas](workflow-ref-action-variables.md)**. Essa referência lista o nome da variável (chave) e o valor de cada variável predefinida. **nota** O tamanho total máximo das variáveis de um fluxo de trabalho está listado em [Cotas para fluxos de trabalho em CodeCatalyst](workflows-quotas.md). Se o tamanho total exceder o máximo, a ação seguinte poderá falhar. # Lista de variáveis predefinidas Consulte as seções a seguir para visualizar as variáveis predefinidas produzidas automaticamente pelas ações do CodeCatalyst como parte da execução de um fluxo de trabalho. Para ter mais informações sobre variáveis predefinidas, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md). **nota** Essa lista inclui somente variáveis predefinidas emitidas pela origem do CodeCatalyst e pelas [ações do CodeCatalyst](workflows-actions.md#workflows-actions-types). Se você estiver usando outros tipos de ações, como ações do GitHub ou do CodeCatalyst Labs, consulte [Determinação de quais variáveis predefinidas seu fluxo de trabalho emite](workflows-working-with-variables-determine-output-vars.md). **Lista** **nota** Nem todas as ações do CodeCatalyst produzem variáveis predefinidas. Se a ação não estiver na lista, ela não produzirá variáveis. + [variáveis BranchName '' e CommitId ''](workflows-sources-variables.md) + [Variáveis de “ CloudFormation pilha de implantação”](deploy-action-cfn-variables.md) + [Variáveis de “Implantar no Amazon ECS”](deploy-action-ecs-variables.md) + [Variáveis de “Implantar no cluster do Kubernetes”](deploy-action-eks-variables.md) + [Variáveis de “Implantação do AWS CDK ”](cdk-dep-action-variables.md) + [variáveis de “Inicialização do AWS CDK ”](cdk-boot-action-variables.md) + [Variáveis de “Invocação do AWS Lambda ”](lam-invoke-action-variables.md) + [Variáveis de “Renderizar definição de tarefa do Amazon ECS”](render-ecs-action-variables.md)