

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

# Conectar repositórios de origem aos fluxos de trabalho
<a name="workflows-sources"></a>

*Origem*, também chamada de *origem de entrada*, é um repositório de origem ao qual uma [ação de fluxo de trabalho](workflows-actions.md) se conecta para receber os arquivos necessários com o objetivo de realizar as operações. Por exemplo, uma ação de fluxo de trabalho pode se conectar a um repositório de origem para receber arquivos de origem a aplicação com o objetivo de criar uma aplicação.

CodeCatalyst os fluxos de trabalho oferecem suporte às seguintes fontes:
+ CodeCatalyst repositórios de origem — Para obter mais informações, consulte[Armazene e colabore no código com repositórios de origem no CodeCatalystArmazenamento e colaboração no código com repositórios de origem](source.md).
+ GitHub repositórios, repositórios Bitbucket e repositórios de GitLab projetos — Para obter mais informações, consulte. [Adicione funcionalidade a projetos com extensões no CodeCatalystAdicionar funcionalidade a projetos com extensões](extensions.md)

**Topics**
+ [Especificar o repositório de origem de um arquivo de fluxo de trabalho](workflows-sources-specify-workflow-def.md)
+ [Especificar o repositório de origem da ação do fluxo de trabalho](workflows-sources-specify-action.md)
+ [Fazer referência a arquivos do repositório de origem](workflows-sources-reference-files.md)
+ [variáveis BranchName '' e CommitId ''](workflows-sources-variables.md)

# Especificar o repositório de origem de um arquivo de fluxo de trabalho
<a name="workflows-sources-specify-workflow-def"></a>

Use as instruções a seguir para especificar o repositório de CodeCatalyst origem em que você deseja armazenar seu arquivo de definição de fluxo de trabalho. Se você preferir especificar um GitHub repositório, repositório Bitbucket ou repositório de GitLab projeto, consulte em vez disso. [Adicione funcionalidade a projetos com extensões no CodeCatalystAdicionar funcionalidade a projetos com extensões](extensions.md)

O repositório de origem em que seu arquivo de definição de fluxo de trabalho reside é identificado pelo rótulo `WorkflowSource`.

**nota**  
Especifique o repositório de origem em que seu arquivo de definição de fluxo de trabalho reside ao confirmar seu arquivo de definição de fluxo de trabalho pela primeira vez. Depois dessa confirmação, o repositório e o arquivo de definição do fluxo de trabalho são vinculados permanentemente. A única maneira de alterar o repositório após a confirmação inicial é recriar o fluxo de trabalho em um repositório diferente.

**Como especificar o repositório de origem que armazenará o arquivo de definição do fluxo de trabalho**

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 **Criar fluxo de trabalho** para criar o fluxo de trabalho. Para obter mais informações, consulte [Criação de um fluxo de trabalho](workflows-create-workflow.md).

   Durante o processo de criação do fluxo de trabalho, você pode especificar o CodeCatalyst repositório, a ramificação e a pasta em que deseja armazenar o arquivo de definição do fluxo de trabalho.

# Especificar o repositório de origem da ação do fluxo de trabalho
<a name="workflows-sources-specify-action"></a>

Use as instruções a seguir para especificar um repositório de origem a ser usado com uma ação de fluxo de trabalho. Na startup, a ação empacota os arquivos no repositório de origem configurado em um artefato, faz download do artefato na [imagem do Docker do ambiente de runtime](build-images.md) em que a ação está sendo executada e, depois, conclui seu processamento usando os arquivos baixados.

**nota**  
Atualmente, em uma ação de fluxo de trabalho, você só pode especificar um repositório de origem, que é o repositório de origem em que o arquivo de definição do fluxo de trabalho reside (no diretório `.codecatalyst/workflows/` ou em um de seus subdiretórios). Esse repositório de origem é representado pelo rótulo `WorkflowSource`.

------
#### [ Visual ]

**Como especificar o repositório de origem que uma ação usará (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 especificar a origem.

1. Selecione **Entradas**.

1. Em **Origens – opcional**, faça o seguinte:

   Especifique os rótulos que representam os repositórios de origem que serão necessários para a ação. Atualmente, o único rótulo compatível é `WorkflowSource`, que representa o repositório de origem em que o arquivo de definição de fluxo de trabalho está armazenado.

   Se você omitir uma origem, deverá especificar pelo menos um artefato de entrada em `action-name/Inputs/Artifacts`.

   Para obter mais informações sobre fontes, consulte [Conectar repositórios de origem aos fluxos de trabalho](workflows-sources.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 ]

**Como especificar o repositório de origem que uma ação usará (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, adicione um código semelhante ao seguinte:

   ```
   action-name:
    Inputs:
      Sources:
        - WorkflowSource
   ```

   Para ter mais informações, consulte a descrição da propriedade `Sources` em [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.

------

# Fazer referência a arquivos do repositório de origem
<a name="workflows-sources-reference-files"></a>

Se você tiver arquivos que residem em um repositório de origem e precisar se referir a esses arquivos em uma das ações do fluxo de trabalho, conclua o procedimento a seguir.

**nota**  
Consulte também [Referência de arquivos em um artefato](workflows-working-artifacts-refer-files.md).

**Como fazer referência a um arquivo armazenado em um repositório de origem**
+ Na ação em que você deseja fazer referência a um arquivo, adicione um código semelhante ao seguinte:

  ```
  Actions:
    My-action:
      Inputs:
        Sources:
          - WorkflowSource
        Configuration:
          Steps:
          - run: cd my-app && cat file1.jar
  ```

  No código anterior, a ação procura no diretório `my-app` na raiz do repositório de origem `WorkflowSource` para encontrar e exibir o arquivo `file1.jar`.

# variáveis BranchName '' e CommitId ''
<a name="workflows-sources-variables"></a>

A CodeCatalyst fonte produz `BranchName` e define `CommitId` variáveis quando seu fluxo de trabalho é executado. Elas são conhecidas como *variáveis predefinidas*. Veja a tabela a seguir para ter informações sobre essas variáveis.

Para ter informações sobre como referenciar essas variáveis em um fluxo de trabalho, consulte [Usar variáveis predefinidas](workflows-using-predefined-variables.md).


| Chave | Valor | 
| --- | --- | 
|  CommitId  |  O ID de confirmação que representa o estado do repositório no momento em que a execução do fluxo de trabalho foi iniciada. Exemplo: `example3819261db00a3ab59468c8b` Consulte também: [Exemplo: referenciando a variável predefinida CommitId "”](workflows-predefined-examples.md#workflows-working-with-variables-ex-refer-action)  | 
|  BranchName  |  O nome da ramificação em que a execução do fluxo de trabalho foi iniciada. Exemplos: `main`, `feature/branch`, `test-LiJuan` Consulte também: [Exemplo: referenciando a variável predefinida BranchName "”](workflows-predefined-examples.md#workflows-working-with-variables-ex-branch)  | 