Para o GitLab, você usa uma conexão do GitLab para acessar o provedor de origem.
Conectar o CodeBuild ao GitLab
As conexões permitem que você autorize e estabeleça configurações que associam seu provedor de terceiros aos recursos da AWS usando o Conexões de código da AWS. Para associar o repositório de terceiros como origem do projeto de compilação, use uma conexão.
Para adicionar um provedor de origem do GitLab ou GitLab Self Managed no CodeBuild, é possível optar entre:
-
Use o assistente Criar projeto de compilação do console do CodeBuild ou a página Editar origem para escolher a opção de provedor GitLab ou GitLab Self Managed. Consulte Criar uma conexão com o GitLab (console) para adicionar o provedor de origem. O console ajuda você a criar um recurso de conexão.
-
Use a CLI para criar os recursos de conexão, consulte Criar uma conexão com o GitLab (CLI) para criar um recurso de conexão com a CLI.
nota
É possível criar uma conexão por meio do console do Developer Tools em Configurações. Consulte Criar uma conexão.
nota
Ao autorizar a instalação dessa conexão no GitLab, você concede ao nosso serviço permissões para processar seus dados acessando sua conta e pode revogá-las a qualquer momento desinstalando a aplicação.
Criar uma conexão com o GitLab
Essa seção descreve como conectar o GitLab ao CodeBuild. Para obter mais informações sobre conexões do GitLab, consulte Conectar o CodeBuild ao GitLab.
Antes de começar
-
É necessário que você já tenha criado uma conta no GitLab.
nota
As conexões fornecem acesso somente a repositórios pertencentes à conta usada para criar e autorizar a conexão.
nota
Você pode criar conexões com um repositório em que tenha a função de Proprietário no GitLab e, depois, a conexão pode ser usada com o repositório com recursos como o CodeBuild. Para repositórios em grupos, você não precisa ser o proprietário do grupo.
-
Para especificar uma origem para o projeto de compilação, é necessário que você já tenha criado um repositório no GitLab.
Criar uma conexão com o GitLab (console)
Execute estas etapas para usar o console do CodeBuild para adicionar uma conexão para seu projeto (repositório) no GitLab.
Para criar ou editar seu projeto de compilação
-
Faça login no console do CodeBuild.
-
Escolha uma das seguintes opções.
-
Selecione para criar um projeto de compilação. Siga as etapas em Criar um projeto de compilação (console) para concluir a primeira tela e, na seção Origem, em Provedor de origem, escolha GitLab.
-
Opte por editar um projeto de compilação existente. Escolha Editar e depois Origem. Na página Editar origem, em Provedor de origem, escolha GitLab.
-
-
Escolha uma das seguintes opções:
-
Em Conexão, escolha Conexão padrão. A conexão padrão aplica uma conexão padrão do GitLab em todos os projetos.
-
Em Conexão, escolha Conexão personalizada. A conexão personalizada aplica uma conexão personalizada do GitLab que substitui as configurações padrão da conta.
-
-
Execute um destes procedimentos:
-
Em Conexão padrão ou Conexão personalizada, se você ainda não criou uma conexão com seu provedor, escolha Criar uma conexão do GitLab. Vá para a etapa 5 para criar uma conexão.
-
Em Conexão, se você já tiver criado uma conexão com seu provedor, escolha a conexão. Prossiga para a etapa 10.
nota
Se você fechar a janela pop-up antes de criar uma conexão com o GitLab, precisará atualizar a página.
-
-
Para criar uma conexão com um repositório do GitLab, em Selecionar um provedor, escolha GitLab. Em Connection name (Nome da conexão), digite o nome da conexão que você deseja criar. Selecione Conectar-se ao GitLab.
-
Quando a página de login do GitLab for exibida, faça login com suas credenciais e selecione Fazer login.
-
Se esta é a primeira vez que você autoriza a conexão, uma página de autorização é exibida com uma mensagem solicitando autorização para a conexão acessar sua conta do GitLab.
Escolha Authorize.
-
O navegador retorna à página do console de conexões. Em Configurações de conexão do GitLab, a nova conexão é mostrada em Nome da conexão.
-
Selecione Conectar.
Depois que uma conexão com o GitLab é criada com êxito, um banner de sucesso é exibido na parte superior.
-
Na página Criar projeto de compilação, na lista suspensa Conexão padrão ou Conexão personalizada, verifique se o ARN da conexão está listado. Se não, escolha o botão Atualizar para que apareça.
-
Em Repositório, escolha o nome do projeto no GitLab especificando o caminho do projeto com o namespace. Por exemplo, para um repositório em nível de grupo, insira o nome do repositório no seguinte formato:
group-name/repository-name
. Para obter mais informações sobre o caminho e o namespace, consulte o campopath_with_namespace
em https://docs.gitlab.com/ee/api/projects.html#get-single-project. Para obter mais informações sobre o namespace no GitLab, consulte https://docs.gitlab.com/ee/user/namespace/ . nota
Para grupos no GitLab, é necessário especificar manualmente o caminho do projeto com o namespace. Por exemplo, para um repositório
myrepo
em um grupomygroup
, insira o seguinte:mygroup/myrepo
. No GitLab, você pode encontrar o caminho do projeto por meio do namespace do URL. -
Em Versão de origem - opcional, insira um ID de solicitação pull, uma ramificação, um ID de confirmação, uma tag ou uma referência e um ID de confirmação. Para obter mais informações, consulte Exemplo de versão de fonte com o AWS CodeBuild.
nota
Recomendamos escolher nomes de ramificações do Git que não se pareçam com IDs de confirmação, como
811dd1ba1aba14473856cee38308caed7190c0d
ou5392f7
. Isso ajuda você a evitar colisões de checkout do Git com confirmações reais. -
Em Profundidade do clone de Git - opcional, você pode criar um clone superficial com um histórico truncado para o número especificado de confirmações. Se quiser um clone completo, escolha Completo.
-
Em Status da compilação - opcional, selecione Relatar status de compilação ao provedor de origem quando as compilações iniciarem e terminarem se quiser relatar os status de início e conclusão da compilação ao provedor de origem.
Para poder relatar o status da compilação ao provedor de origem, o usuário associado ao provedor de origem deve ter acesso de gravação ao repositório. Se o usuário não tiver acesso de gravação, o status de compilação não poderá ser atualizado. Para obter mais informações, consulte Acesso do provedor de origem.
Criar uma conexão com o GitLab (CLI)
É possível usar a AWS Command Line Interface (AWS CLI) para criar uma conexão.
Para fazer isso, use o comando create-connection.
Importante
Uma conexão criada por meio da AWS CLI ou do AWS CloudFormation permanece no status PENDING
por padrão. Depois de criar uma conexão com a CLI ou o AWS CloudFormation, use o console para editar a conexão e tornar seu status AVAILABLE
.
Como criar uma conexão
-
Siga as instruções no Guia do usuário do console Developer Tools para Criar uma conexão com o GitLab (CLI).