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 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).