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á. # Uso de variáveis em fluxos de trabalho Uma *variável* é um par de valores-chave que contém informações que você pode consultar em seu fluxo de trabalho da Amazon CodeCatalyst . A parte do valor da variável é substituída por um valor real quando o fluxo de trabalho é executado. Há dois tipos de variáveis que podem ser usadas no fluxo de trabalho: + **Variáveis definidas pelo usuário** – Pares chave-valor que você define. + **Variáveis predefinidas** – Pares de chave-valor que são emitidos automaticamente por um fluxo de trabalho. Você não precisa defini-las. Para obter mais informações sobre fluxos de trabalho, consulte [Compilação, teste e implantação com fluxos de trabalhoCompilação, teste e implantação com fluxos de trabalho](workflow.md). **nota** CodeCatalyst também suporta [parâmetros GitHub de saída](https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter), que se comportam como variáveis e podem ser referenciados em outras ações. Para ter mais informações, consulte [Exportação dos parâmetros de saída do GitHub](integrations-github-action-export.md) e [Referenciando parâmetros GitHub de saída](integrations-github-action-referencing.md) **Topics** + [Usar variáveis definidas pelo usuário](workflows-using-variables.md) + [Usar variáveis predefinidas](workflows-using-predefined-variables.md) # Usar variáveis definidas pelo usuário *As variáveis definidas pelo usuário* são pares chave-valor que você define. Existem dois tipos: + **Variáveis de texto simples**, ou simplesmente **variáveis** – Pares de chave-valor que você define em texto simples no arquivo de definição do fluxo de trabalho. + **Segredos** — Esses são pares de valores-chave que você define em uma página separada de **segredos** do console da Amazon CodeCatalyst . A *chave* (nome) é um rótulo público e o *valor* contém as informações que você deseja manter privadas. Especifique apenas a chave no arquivo de definição do fluxo de trabalho. Use segredos no lugar de senhas e outras informações confidenciais no arquivo de definição do fluxo de trabalho. **nota** Resumindo, este guia usa o termo *variável* para *variável de texto simples*. 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 variáveis](workflows-working-with-variables-ex.md) + [Definição de uma variável](workflows-working-with-variables-define-input.md) + [Definição de um segredo](workflows-working-with-variables-define-secret.md) + [Exportação de uma variável para que outras ações possam usá-la](workflows-working-with-variables-export-input.md) + [Referência a uma variável na ação que a define](workflows-working-with-variables-reference-input.md) + [Referência a uma saída de variável por outra ação](workflows-working-with-variables-reference-action.md) + [Referência a um segredo](workflows-working-with-variables-reference-secret.md) # Exemplos de variáveis Os exemplos a seguir mostram como definir e referenciar variáveis no arquivo de definição 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** + [Exemplo: definição de uma variável usando a propriedade de entradas](#workflows-working-with-variables-ex-define-inputs) + [Exemplo: definição de uma variável usando a propriedade de etapas](#workflows-working-with-variables-ex-define-steps) + [Exemplo: exportação de uma variável usando a propriedade de saídas](#workflows-working-with-variables-ex-export-outputs) + [Exemplo: referência de uma variável definida na mesma ação](#workflows-working-with-variables-ex-refer-current) + [Exemplo: referência de uma variável definida em outra ação](#workflows-working-with-variables-ex-refer-other) + [Exemplo: referenciar um segredo](#workflows-working-with-variables-ex-refer-secret) ## Exemplo: definição de uma variável usando a propriedade de entradas O exemplo a seguir mostra como definir duas variáveis, `VAR1` e `VAR2`, em uma seção `Inputs`. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: "My variable 1" - Name: VAR2 Value: "My variable 2" ``` ## Exemplo: definição de uma variável usando a propriedade de etapas O exemplo a seguir mostra como definir explicitamente uma variável `DATE` na seção `Steps`. ``` Actions: Build: Identifier: aws/build@v1 Configuration: Steps: - Run: DATE=$(date +%m-%d-%y) ``` ## Exemplo: exportação de uma variável usando a propriedade de saídas O exemplo a seguir mostra como definir duas variáveis, `REPOSITORY-URI` e `TIMESTAMP`, e exportá-las usando a seção `Outputs`. ``` Actions: Build: Identifier: aws/build@v1 Inputs: Variables: - Name: REPOSITORY-URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - REPOSITORY-URI - TIMESTAMP ``` ## Exemplo: referência de uma variável definida na mesma ação O exemplo a seguir mostra como especificar uma variável `VAR1` em `MyBuildAction` e, depois, referenciá-la na mesma ação usando `$VAR1`. ``` Actions: MyBuildAction: Identifier: aws/build@v1 Inputs: Variables: - Name: VAR1 Value: my-value Configuration: Steps: - Run: $VAR1 ``` ## Exemplo: referência de uma variável definida em outra ação O exemplo a seguir mostra como especificar uma variável `TIMESTAMP` em `BuildActionA`, exportá-la usando a propriedade `Outputs` e, depois, referenciá-la em `BuildActionB` usando `${BuildActionA.TIMESTAMP}`. ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: TIMESTAMP=$(date +%m-%d-%y-%H-%m-%s) Outputs: Variables: - TIMESTAMP BuildActionB: Identifier: aws/build@v1 Configuration: Steps: - Run: docker build -t my-ecr-repo/image-repo:latest . - Run: docker tag my-ecr-repo/image-repo:${BuildActionA.TIMESTAMP} # Specifying just '$TIMESTAMP' here will not work # because TIMESTAMP is not a variable # in the BuildActionB action. ``` ## Exemplo: referenciar um segredo Os exemplos a seguir mostram como referenciar um segredo de `my-password`. `my-password` é a chave do segredo. A chave secreta e o valor da senha correspondente devem ser especificados na página **Segredos** do CodeCatalyst console antes de serem usados no arquivo de definição do fluxo de trabalho. Para obter mais informações, consulte [Mascarar dados usando segredos](workflows-secrets.md). ``` Actions: BuildActionA: Identifier: aws/build@v1 Configuration: Steps: - Run: curl -u LiJuan:${Secrets.my-password} https://example.com ``` # Definição de uma variável É possível definir variáveis de duas maneiras: + Na seção `Inputs` de uma ação de fluxo de trabalho. Consulte [Para definir uma variável na seção “Entradas”](#workflows-to-define-variable-input) + Na seção `Steps` de uma ação de fluxo de trabalho. Consulte [Para definir uma variável na seção “Etapas”](#workflows-to-define-variable-steps) **nota** O `Steps` método só funciona com as ações de CodeCatalyst compilação, teste e **GitHub ações**, porque essas são as únicas ações que incluem uma `Steps` seção. Para obter exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.md). Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). ------ #### [ Visual ] **Para definir uma variável na seção “Entradas” (editor visual)** 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 **Visual**. 1. No diagrama do fluxo de trabalho, selecione a ação onde deseja configurar a variável. 1. Selecione **Entradas**. 1. Em **Variáveis – opcional**, selecione **Adicionar variável** e, depois, faça o seguinte: Especifique uma sequência de name/value pares que defina as variáveis de entrada que você deseja disponibilizar para a ação. Os nomes de variável são limitados a caracteres alfanuméricos (a-z, A-Z, 0-9), hifens (-) e sublinhados (\$1). Não são permitidos espaços. Não é possível usar aspas para habilitar caracteres especiais e espaços nos nomes de variável. Para ter mais informações sobre variáveis, inclusive exemplos, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). 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. ------ #### [ YAML ] **Para definir uma variável na seção “Entradas” (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 ação de fluxo de trabalho, adicione um código semelhante ao seguinte: ``` action-name: Inputs: Variables: - Name: variable-name Value: variable-value ``` Para obter mais exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.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. ------ ------ #### [ Visual ] **Para definir uma variável na seção “Etapas” (editor visual)** 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 **Visual**. 1. No diagrama do fluxo de trabalho, selecione a ação onde deseja configurar a variável. 1. Escolher **configuração**. 1. Nos **comandos do Shell** ou no **GitHubActions YAML**, o que estiver disponível, defina uma variável na ação`Steps`, explícita ou implicitamente. + Para definir a variável explicitamente, inclua-a em um comando bash diretamente na seção `Steps`. + Para definir uma variável implicitamente, especifique-a em um arquivo referenciado na seção `Steps` da ação. Para obter exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.md). Para ter mais informações, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) para a 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. ------ #### [ YAML ] **Para definir uma variável na seção “Etapas” (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 ação de fluxo de trabalho, defina uma variável na seção `Steps` da ação, explícita ou implicitamente. + Para definir a variável explicitamente, inclua-a em um comando bash diretamente na seção `Steps`. + Para definir uma variável implicitamente, especifique-a em um arquivo referenciado na seção `Steps` da ação. Para obter exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.md). Para ter mais informações, consulte [Definição do YAML do fluxo de trabalho](workflow-reference.md) para a 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. ------ # Definição de um segredo Você define um segredo na página **Segredos** do CodeCatalyst console. Para obter mais informações, consulte [Mascarar dados usando segredos](workflows-secrets.md). Por exemplo, você pode definir um segredo parecido com este: + Nome (chave): **my-password** + Valor: **^\$1H3\$1\$1b9** Depois que o segredo for definido, você poderá especificar a chave do segredo (**my-password**) no arquivo de definição do fluxo de trabalho. Para obter um exemplo de como fazer isso, consulte [Exemplo: referenciar um segredo](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # Exportação de uma variável para que outras ações possam usá-la Use as instruções a seguir para exportar uma variável de uma ação para que você possa referenciá-la em outras ações. Antes de exportar uma variável, verifique o seguinte: + Se você só precisar referenciar a variável dentro da ação em que ela está definida, não será necessário exportá-la. + Nem todas as ações são compatíveis com a exportação de variáveis. Para determinar se a ação é compatível com esse recurso, siga as instruções do editor visual a seguir e veja se a ação inclui um botão **Variáveis** na guia **Saídas**. Se sim, a exportação de variáveis é compatível. + Para exportar uma variável de uma GitHub Ação, consulte[Exportação dos parâmetros de saída do GitHub](integrations-github-action-export.md). Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). **Pré-requisito** Certifique-se de ter definido a variável que você deseja exportar. Para obter mais informações, consulte [Definição de uma variável](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] **Para exportar uma variável (editor visual)** 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 **Visual**. 1. No diagrama de fluxo de trabalho, selecione a ação da qual deseja exportar a variável. 1. Selecione **Saídas**. 1. Em **Variáveis – opcional**, selecione **Adicionar variável** e, depois, faça o seguinte: Especifique o nome de uma variável a ser exportada pela ação. Essa variável já deve estar definida na seção `Inputs` ou `Steps` da mesma 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. ------ #### [ YAML ] **Para exportar uma variável (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. Na ação da qual você deseja exportar a variável, adicione um código semelhante ao seguinte: ``` action-name: Outputs: Variables: - Name: variable-name ``` Para obter mais exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.md). 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. ------ # Referência a uma variável na ação que a define Use as instruções a seguir para referenciar uma variável na ação que a define. **nota** Para referenciar uma variável gerada por uma GitHub Ação, consulte[Referenciando parâmetros GitHub de saída](integrations-github-action-referencing.md). Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). **Pré-requisito** Certifique-se de ter definido a variável que você deseja referenciar. Para obter mais informações, consulte [Definição de uma variável](workflows-working-with-variables-define-input.md). ------ #### [ Visual ] *Não disponível. Escolha YAML para visualizar as instruções YAML.* ------ #### [ YAML ] **Para referenciar uma variável na ação que a define** 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. Na CodeCatalyst ação que define a variável à qual você deseja se referir, adicione a variável usando a seguinte sintaxe bash: ``` $variable-name ``` Por exemplo: ``` MyAction: Configuration: Steps: - Run: $variable-name ``` Para obter mais exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.md). Para ter mais informações, consulte as informações de referência da ação em [Definição do YAML do fluxo de trabalho](workflow-reference.md). 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. ------ # Referência a uma saída de variável por outra ação Use as instruções a seguir para referenciar saídas de variáveis por outras ações. **nota** Para referenciar uma saída variável de uma GitHub Ação, consulte[Referenciando parâmetros GitHub de saída](integrations-github-action-referencing.md). Para ter mais informações sobre variáveis, consulte [Uso de variáveis em fluxos de trabalho](workflows-working-with-variables.md). **Pré-requisito** Certifique-se de ter exportado a variável que você deseja referenciar. Para obter mais informações, consulte [Exportação de uma variável para que outras ações possam usá-la](workflows-working-with-variables-export-input.md). ------ #### [ Visual ] *Não disponível. Escolha YAML para visualizar as instruções YAML.* ------ #### [ YAML ] **Para referenciar uma saída de variável por outra ação (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. Na CodeCatalyst ação, adicione uma referência à variável usando a seguinte sintaxe: ``` ${action-group-name.action-name.variable-name} ``` Substitua: + *action-group-name*com o nome do grupo de ações que contém a ação que gera a variável. **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*com o nome da ação que gera a variável. + *variable-name*com o nome da variável. Por exemplo: ``` MySecondAction: Configuration: Steps: - Run: ${MyFirstAction.TIMESTAMP} ``` Para obter mais exemplos, consulte [Exemplos de variáveis](workflows-working-with-variables-ex.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. ------ # Referência a um segredo Para receber instruções sobre como fazer referência a um segredo no arquivo de definição do fluxo de trabalho, consulte [Usar um segredo](workflows-secrets.using.md). Para ver um exemplo, consulte [Exemplo: referenciar um segredo](workflows-working-with-variables-ex.md#workflows-working-with-variables-ex-refer-secret). # 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)