GitLabconexões.com - AWS CodePipeline
Crie uma conexão com GitLab .com (console)Crie uma conexão com GitLab .com (CLI)

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

GitLabconexões.com

As conexões permitem que você autorize e estabeleça configurações que associem seu provedor terceirizado aos seus AWS recursos. Para associar seu repositório de terceiros como origem do pipeline, use uma conexão.

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

Para adicionar uma ação de código-fonte GitLab .com CodePipeline, você pode escolher entre:

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 GitLab em.com, você concede ao nosso serviço permissões para processar seus dados acessando sua conta e pode revogar as permissões a qualquer momento desinstalando o aplicativo.

Antes de começar

  • Você já deve ter criado uma conta com GitLab .com.

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

  • Para especificar uma origem para seu pipeline, é necessário que você já tenha criado um repositório no gitlab.com.

Crie uma conexão com GitLab .com (console)

Use essas etapas para usar o CodePipeline console para adicionar uma ação de conexões para seu projeto (repositório) no GitLab.

Para criar ou editar seu pipeline

  1. Faça login no CodePipeline console.

  2. Escolha uma das seguintes opções.

    • Opte por criar um pipeline. Siga as etapas em Criar um pipeline para concluir a primeira tela e escolha Próximo. Na página Fonte, em Provedor de Origem, escolha GitLab.

    • Opte por editar um pipeline existente. Escolha Editar e, em seguida, escolha Editar estágio. Escolha adicionar ou editar sua ação de origem. Na página Editar ação, em Nome da ação, insira um nome para a ação. Em Provedor de ação, selecione GitLab.

  3. Execute um destes procedimentos:

    • Em Conexão, se você ainda não tiver criado uma conexão com seu provedor, escolha Conectar GitLab a. Vá para a Etapa 4 para criar uma conexão.

    • Em Conexão, se você ainda não criou uma conexão com seu provedor, escolha a conexão. Vá para a etapa 9.

    nota

    Se você fechar a janela pop-up antes da criação de uma GitLab conexão.com, precisará atualizar a página.

  4. Para criar uma conexão com um GitLab repositório.com, em Selecionar um provedor, escolha GitLab. Em Connection name (Nome da conexão), digite o nome da conexão que você deseja criar. Escolha Connect to GitLab.

    Captura de tela do console mostrando a opção de conexão selecionada para GitLab.

  5. Quando a página de login de GitLab .com for exibida, faça login com suas credenciais e escolha Entrar.

  6. Se esta for a primeira vez que você autoriza a conexão, uma página de autorização será exibida com uma mensagem solicitando autorização para que a conexão acesse sua GitLab conta.com.

    Escolha Authorize.

    Captura de tela mostrando a mensagem para autorizar a conexão com sua GitLab conta.com.

  7. O navegador retorna à página do console de conexões. Em Criar GitLab conexão, a nova conexão é mostrada em Nome da conexão.

  8. Escolha Connect to GitLab.

    Você retornará ao CodePipeline console.

    nota

    Depois que uma GitLab conexão.com for criada com sucesso, um banner de sucesso será exibido na janela principal.

    Se você não tiver feito login anteriormente GitLab na máquina atual, precisará fechar manualmente a janela pop-up.

  9. Em Nome do repositório, escolha o nome do seu projeto em 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 path_with_namespace campo em https://docs.gitlab.com/ee/api/projects.html #. get-single-project Para obter mais informações sobre o namespace em GitLab, consulte https://docs.gitlab.com/ee/user/namespace/.

    nota

    Para grupos em GitLab, você deve 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. Você pode encontrar o caminho do projeto com o namespace na URL em. GitLab

  10. Em Gatilhos do Pipeline, você pode adicionar gatilhos se sua ação for uma ação. CodeConnections Para configurar a configuração do gatilho do pipeline e, opcionalmente, filtrar com gatilhos, veja mais detalhes em. Filtrar gatilhos em solicitações push ou pull de código

  11. Em Branch name (Nome da ramificação), escolha a ramificação onde deseja que o pipeline detecte alterações de origem.

    nota

    Se o nome da ramificação não for preenchido automaticamente, você não terá acesso de Proprietário ao repositório. O nome do projeto não é válido ou a conexão usada não tem acesso ao projeto/repositório.

  12. Em Output artifact format (Formato de artefato de saída), você deve escolher o formato para seus artefatos.

    • Para armazenar artefatos de saída da ação GitLab .com usando o método padrão, escolha CodePipeline default. A ação acessa os arquivos do GitLab repositório.com e armazena os artefatos em um arquivo ZIP no repositório de artefatos do pipeline.

    • Para armazenar um arquivo JSON que contém uma referência de URL ao repositório para que as ações downstream possam executar comandos Git diretamente, escolha Full clone (Clone completo). 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 emAdicione CodeBuild GitClone permissões para conexões com o Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab. 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.

  13. Opte por salvar a ação de origem e continuar.

Crie uma conexão com GitLab .com (CLI)

Você pode usar o 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 do AWS CLI ou AWS CloudFormation está no PENDING status por padrão. Depois de criar uma conexão com a CLI ou AWS CloudFormation, use o console para editar a conexão e definir seu status. AVAILABLE

Como criar uma conexão

  1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o create-connection comando, especificando --provider-type e --connection-name para sua conexão. Neste exemplo, o nome do provedor de terceiros é GitLab e o nome da conexão especificada é MyConnection.

    aws codestar-connections create-connection --provider-type GitLab --connection-name MyConnection

    Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.

    {
    "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

  2. Use o console para concluir a conexão. Para obter mais informações, consulte Atualizar uma conexão pendente.

  3. O pipeline assume como padrão a detecção de alterações ao enviar o código por push ao repositório de origem da conexão. Para definir a configuração do gatilho do pipeline para liberação manual ou para tags Git, execute um dos seguintes procedimentos:

    • Para definir a configuração do gatilho do pipeline para início somente por meio de liberação manual, adicione a seguinte linha à configuração: 

      "DetectChanges": "false",

    • Para configurar a configuração do gatilho do pipeline para filtrar com gatilhos, veja mais detalhes em. Filtrar gatilhos em solicitações push ou pull de código Por exemplo, o seguinte aumenta o nível do pipeline da definição JSON do pipeline. Neste exemplo, release-v0 e release-v1 são as tags Git a serem incluídas, enquanto release-v2 são as tags Git a serem excluídas.

      "triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]