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á.
# CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com e ações GitLab autogerenciadas
As ações de origem para conexões são suportadas pelo Conexões de código da AWS. CodeConnections permite criar e gerenciar conexões entre AWS recursos e repositórios de terceiros, como GitHub. Aciona um pipeline quando uma nova confirmação é feita em um repositório de código-fonte de terceiros. A ação de origem recupera alterações de código quando um pipeline é executado manualmente ou quando um evento do webhook é enviado pelo provedor de origem.
Você pode configurar ações no pipeline para usar uma configuração do Git que permite iniciar o pipeline com gatilhos. Para definir a configuração de gatilhos do pipeline e aplicar filtros, consulte mais detalhes em [Adicionar gatilho com tipos de eventos code push ou pull request](pipelines-filter.md).
**nota**
Esse recurso não está disponível nas regiões Ásia-Pacífico (Hong Kong), Ásia-Pacífico (Hyderabad), Ásia-Pacífico (Jacarta), Ásia-Pacífico (Melbourne), Ásia-Pacífico (Osaka), África (Cidade do Cabo), Oriente Médio (Bahrein), Oriente Médio (EAU), Europa (Espanha), Europa (Zurique), Israel (Tel Aviv) ou (Oeste dos EUA). AWS GovCloud Para fazer referência a outras ações disponíveis, consulte [Integrações de produtos e serviços com CodePipeline](integrations.md). Para considerações sobre essa ação na região Europa (Milão), consulte a nota em [CodeStarSourceConnection para Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com e ações GitLab autogerenciadas](#action-reference-CodestarConnectionSource).
As conexões podem associar seus AWS recursos aos seguintes repositórios de terceiros:
+ Bitbucket Cloud (por meio da opção **de provedor Bitbucket** no CodePipeline console ou do `Bitbucket` provedor na CLI)
**nota**
Você pode criar conexões para um repositório do Bitbucket Cloud. Não há suporte a tipos de provedores instalados do Bitbucket, como o Bitbucket Server.
+
**nota**
Se você estiver usando um espaço de trabalho do Bitbucket, precisará ter acesso de administrador para criar a conexão.
+ GitHub e GitHub Enterprise Cloud (por meio da opção de provedor **GitHub (via GitHub aplicativo)** no CodePipeline console ou do `GitHub` provedor na CLI)
**nota**
Se o seu repositório estiver em uma GitHub organização, você deverá ser o proprietário da organização para criar a conexão. Se você estiver usando um repositório que não esteja em uma organização, você precisará ser o proprietário do repositório.
+ GitHub Enterprise Server (por meio da opção de provedor **GitHub Enterprise Server** no CodePipeline console ou do `GitHub Enterprise Server` provedor na CLI)
+ GitLab.com (por meio da opção de **GitLab**provedor no CodePipeline console ou do `GitLab` provedor na CLI)
**nota**
Você pode criar conexões com um repositório no qual você tem a função de **Proprietário** e GitLab, em seguida, a conexão pode ser usada com o repositório com recursos como. CodePipeline Para repositórios em grupos, você não precisa ser o proprietário do grupo.
+ Instalação autogerenciada para GitLab (Enterprise Edition ou Community Edition) (por meio da opção de provedor **GitLab autogerenciado** no CodePipeline console ou do `GitLabSelfManaged` provedor na CLI)
**nota**
Cada conexão oferece suporte a todos os repositórios que você tem com esse provedor. Você só precisa criar uma nova conexão para cada tipo de provedor.
As conexões permitem que seu pipeline detecte alterações na origem por meio do aplicativo de instalação do provedor de terceiros. Por exemplo, webhooks são usados para assinar tipos de GitHub eventos e podem ser instalados em uma organização, um repositório ou um aplicativo. GitHub Sua conexão instala um webhook de repositório em seu GitHub aplicativo que se inscreve para GitHub eventos do tipo push.
Depois que uma alteração de código é detectada, você tem as seguintes opções para passar o código para ações subsequentes:
+ Padrão: como outras ações de CodePipeline origem existentes, `CodeStarSourceConnection` pode gerar um arquivo ZIP com uma cópia superficial do seu commit.
+ Clone completo: a ação `CodeStarSourceConnection` também pode ser configurada para gerar uma referência de URL para o repositório nas ações subsequentes.
Atualmente, a referência de URL do Git só pode ser usada por CodeBuild ações downstream para clonar o repositório e os metadados do Git associados. A tentativa de passar uma referência de URL do Git para CodeBuild não-ações resulta em um erro.
CodePipeline solicita que você adicione o aplicativo de instalação do AWS Connector à sua conta de terceiros ao criar uma conexão. Você já deve ter criado sua conta e repositório do provedor de terceiros para que possa se conectar por meio da ação `CodeStarSourceConnection`.
**nota**
Para criar ou anexar uma política ao seu perfil com as permissões necessárias para usar o AWS CodeStar Connections, consulte [Referência de permissões do Connections](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-connections). Dependendo de quando sua função CodePipeline de serviço foi criada, talvez seja necessário atualizar suas permissões para oferecer suporte às AWS CodeStar conexões. Para instruções, consulte [Adicionar permissões à função CodePipeline de serviço](how-to-custom-role.md#how-to-update-role-new-services).
**nota**
Para usar conexões na Europa (Milão) Região da AWS, você deve:
Instalar uma aplicação específica da região.
Habilitar a região.
Essa aplicação específica da região é compatível com conexões na região Europa (Milão). Ela é publicada no site do provedor externo e é separada da aplicação existente que permite conexões para outras regiões. Ao instalar essa aplicação, você autoriza provedores externos a compartilhar seus dados somente com o serviço dessa região, mas pode revogar as permissões a qualquer momento ao desinstalá-la.
O serviço não processará nem armazenará seus dados, a menos que você habilite a região. Ao habilitar essa região, você concede ao nosso serviço permissões para processar e armazenar seus dados.
Mesmo que a região não esteja habilitada, provedores externos ainda poderão compartilhar seus dados com nosso serviço se a aplicação específica da região permanecer instalada. Portanto, desinstale a aplicação depois de desabilitar a região. Para obter mais informações, consulte [Habilitar uma região](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable).
**Topics**
+ [Tipo de ação](#action-reference-CodestarConnectionSource-type)
+ [Parâmetros de configuração](#action-reference-CodestarConnectionSource-config)
+ [Input artifacts (Artefatos de entrada)](#action-reference-CodestarConnectionSource-input)
+ [Artefatos de saída](#action-reference-CodestarConnectionSource-output)
+ [Variáveis de saída](#action-reference-CodestarConnectionSource-variables)
+ [Permissões da função de serviço: CodeConnections ação](#edit-role-connections)
+ [Declaração de ação](#action-reference-CodestarConnectionSource-example)
+ [Instalação do aplicativo de instalação e criação de uma conexão](#action-reference-CodestarConnectionSource-auth)
+ [Consulte também](#action-reference-CodestarConnectionSource-links)
## Tipo de ação
+ Categoria: `Source`
+ Proprietário: `AWS`
+ Fornecedor: `CodeStarSourceConnection`
+ Versão: `1`
## Parâmetros de configuração
****ConnectionArn****
Obrigatório: Sim
O ARN de conexão configurado e autenticado para o provedor de origem.
****FullRepositoryId****
Obrigatório: Sim
O proprietário e o nome do repositório onde as alterações de origem devem ser detectadas.
Exemplo: `some-user/my-repo`
Você deve manter as letras maiúsculas e minúsculas corretas para o **FullRepositoryId**valor. Por exemplo, se seu nome de usuário for `some-user` e o nome do repositório for`My-Repo`, o valor recomendado de **FullRepositoryId**é`some-user/My-Repo`.
****BranchName****
Obrigatório: Sim
O nome da ramificação onde as alterações de origem devem ser detectadas.
****OutputArtifactFormat****
Obrigatório: não
Especifica o formato do artefato de saída. Pode ser `CODEBUILD_CLONE_REF` ou `CODE_ZIP`. Se não especificado, o padrão será `CODE_ZIP`.
A opção `CODEBUILD_CLONE_REF` só pode ser usada por ações downstream do CodeBuild.
Se você escolher essa opção, precisará atualizar as permissões para sua função de serviço CodeBuild do projeto, conforme mostrado em[Adicione CodeBuild GitClone permissões para conexões com o Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab](troubleshooting.md#codebuild-role-connections). Para um tutorial que mostra como usar a opção **Clone completo**, consulte [Tutorial: use o clone completo com uma fonte de GitHub pipeline](tutorials-github-gitclone.md).
**DetectChanges**
Obrigatório: não
Determina o acionamento automático do pipeline quando uma nova confirmação é feita no repositório e na ramificação configurados. Se não for especificado, o valor padrão será `true` e o campo não será exibido por padrão. Os valores válidos para esse parâmetro:
+ `true`: inicia CodePipeline automaticamente seu funil de novas confirmações.
+ `false`: CodePipeline não inicia seu funil com novos commits.
## Input artifacts (Artefatos de entrada)
+ **Número de artefatos:** `0`
+ **Descrição:** os artefatos de entrada não se aplicam a esse tipo de ação.
## Artefatos de saída
+ **Número de artefatos:** `1`
+ **Descrição:** os artefatos gerados no repositório são os artefatos de saída para a ação do `CodeStarSourceConnection`. O ID de confirmação do código-fonte é exibido CodePipeline como a revisão da fonte para a execução do pipeline acionado. Você pode configurar o artefato de saída desta ação em:
+ Um arquivo ZIP que contém o conteúdo do repositório e ramificação configurados na confirmação especificada como a revisão de origem para a execução do pipeline.
+ Um arquivo JSON que contém uma referência de URL para o repositório para que as ações downstream possam executar comandos Git diretamente.
**Importante**
Essa opção só pode ser usada por ações CodeBuild posteriores.
Se você escolher essa opção, precisará atualizar as permissões para sua função de serviço CodeBuild do projeto, conforme mostrado em[Solução de problemas CodePipeline](troubleshooting.md). Para assistir a um tutorial que mostre como usar a opção **Clone completo**, consulte [Tutorial: use o clone completo com uma fonte de GitHub pipeline](tutorials-github-gitclone.md).
## Variáveis de saída
Quando configurada, essa ação produz variáveis que podem ser referenciadas pela configuração de ação de uma ação downstream no pipeline. Esta ação produz variáveis que podem ser visualizadas como variáveis de saída, mesmo que a ação não tenha um namespace. Configure uma ação com um namespace a fim de disponibilizar as variáveis para a configuração de ações downstream.
Para obter mais informações, consulte [Referência de variáveis](reference-variables.md).
AuthorDate
A data em que a confirmação foi criada, no formato de timestamp.
BranchName
O nome da ramificação do repositório do onde a alteração de origem foi feita.
CommitId
O ID de confirmação do que acionou a execução do pipeline.
CommitMessage
A mensagem da descrição, se houver, associada à confirmação que acionou a execução do pipeline.
ConnectionArn
O ARN de conexão configurado e autenticado para o provedor de origem.
FullRepositoryName
O nome do repositório do onde a confirmação que acionou o pipeline foi feita.
## Permissões da função de serviço: CodeConnections ação
Pois CodeConnections, a permissão a seguir é necessária para criar pipelines com uma fonte que usa uma conexão, como o Bitbucket Cloud.
```
{
"Effect": "Allow",
"Action": [
"codeconnections:UseConnection"
],
"Resource": "resource_ARN"
},
```
Para obter mais informações sobre as permissões do IAM para conexões, consulte [Referência de permissões do Connections](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-connections).
## Declaração de ação
No exemplo a seguir, o artefato de saída é definido como o formato ZIP padrão `CODE_ZIP` para a conexão com o ARN `arn:aws:codestar-connections:region:account-id:connection/connection-id`.
------
#### [ YAML ]
```
Name: Source
Actions:
- InputArtifacts: []
ActionTypeId:
Version: '1'
Owner: AWS
Category: Source
Provider: CodeStarSourceConnection
OutputArtifacts:
- Name: SourceArtifact
RunOrder: 1
Configuration:
ConnectionArn: "arn:aws:codestar-connections:region:account-id:connection/connection-id"
FullRepositoryId: "some-user/my-repo"
BranchName: "main"
OutputArtifactFormat: "CODE_ZIP"
Name: ApplicationSource
```
------
#### [ JSON ]
```
{
"Name": "Source",
"Actions": [
{
"InputArtifacts": [],
"ActionTypeId": {
"Version": "1",
"Owner": "AWS",
"Category": "Source",
"Provider": "CodeStarSourceConnection"
},
"OutputArtifacts": [
{
"Name": "SourceArtifact"
}
],
"RunOrder": 1,
"Configuration": {
"ConnectionArn": "arn:aws:codestar-connections:region:account-id:connection/connection-id",
"FullRepositoryId": "some-user/my-repo",
"BranchName": "main",
"OutputArtifactFormat": "CODE_ZIP"
},
"Name": "ApplicationSource"
}
]
},
```
------
## Instalação do aplicativo de instalação e criação de uma conexão
Na primeira vez que você usa o console para adicionar uma nova conexão a um repositório de terceiros, você deve autorizar o CodePipeline acesso aos seus repositórios. Você escolhe ou cria um aplicativo de instalação que o ajuda a se conectar à conta em que o repositório de código de terceiros foi criado.
Ao usar o AWS CLI ou um CloudFormation modelo, você deve fornecer o ARN de conexão de uma conexão que já passou pelo handshake de instalação. Caso contrário, o pipeline não é acionado.
**nota**
Em uma ação de origem `CodeStarSourceConnection`, você não precisa configurar um webhook ou usar a pesquisa como valor padrão. A ação do Connections gerencia a detecção de alterações na origem para você.
## Consulte também
Os recursos relacionados a seguir podem ajudar você à medida que trabalha com esta ação.
+ [AWS::CodeStarConnections::Connection](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestarconnections-connection.html)— A referência do CloudFormation modelo para o recurso AWS CodeStar Conexões fornece parâmetros e exemplos de conexões em CloudFormation modelos.
+ [AWS CodeStarReferência da API](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html) de *AWS CodeStar conexões — A Referência da API* de conexões fornece informações de referência para as ações de conexões disponíveis.
+ Para visualizar as etapas de criação de um pipeline com as ações de origem compatíveis com o Connections, consulte o seguinte:
+ Para o Bitbucket Cloud, use a opção **Bitbucket** no console ou a ação `CodestarSourceConnection` na CLI. Consulte [Conexões do Bitbucket Cloud](connections-bitbucket.md).
+ Para GitHub um GitHub Enterprise Cloud, use a opção de **GitHub**provedor no console ou a `CodestarSourceConnection` ação na CLI. Consulte [GitHub conexões](connections-github.md).
+ Para o GitHub Enterprise Server, use a opção **GitHub Enterprise Server** provider no console ou a `CodestarSourceConnection` ação na CLI. Consulte [GitHub Conexões do Enterprise Server](connections-ghes.md).
+ Para GitLab .com, use a opção **GitLab**provider no console ou a `CodestarSourceConnection` ação com o `GitLab` provedor na CLI. Consulte [GitLabconexões.com](connections-gitlab.md).
+ Para ver um tutorial de introdução que cria um pipeline com uma fonte do Bitbucket e uma CodeBuild ação, consulte [Introdução às conexões](https://docs.aws.amazon.com/dtconsole/latest/userguide/getting-started-connections.html).
+ Para ver um tutorial que mostra como se conectar a um GitHub repositório e usar a opção de **clonagem completa** com uma CodeBuild ação posterior, consulte. [Tutorial: use o clone completo com uma fonte de GitHub pipeline](tutorials-github-gitclone.md)