Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Acesso ao GitLab no CodeBuild

Modo de foco

Nesta página

Acesso ao GitLab no CodeBuild - AWS CodeBuild

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
  1. Faça login no console do CodeBuild.

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

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

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

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

    Captura de tela do console mostrando a opção de conexão selecionada para GitLab.
  6. Quando a página de login do GitLab for exibida, faça login com suas credenciais e selecione Fazer login.

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

    Captura de tela mostrando a mensagem para autorizar a conexão da sua conta do GitLab.
  8. 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.

  9. Selecione Conectar.

    Depois que uma conexão com o GitLab é criada com êxito, um banner de sucesso é exibido na parte superior.

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

  11. 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 campo path_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 grupo mygroup, insira o seguinte: mygroup/myrepo. No GitLab, você pode encontrar o caminho do projeto por meio do namespace do URL.

  12. 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 ou 5392f7. Isso ajuda você a evitar colisões de checkout do Git com confirmações reais.

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

  14. 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
PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.