Configurando o GitLab

GitLab é um serviço de hospedagem baseado na web para repositórios Git. É possível ter ambas as cópias local e remota de seus repos, o que facilita a colaboração.

É possível configurar o GitLab como uma integração de ferramenta em sua cadeia de ferramentas para que seja possível gerenciar o código-fonte em um repositório novo ou existente em GitLab.com ou na instância do GitLab de sua empresa. Envolva-se na codificação social por meio de wikis, rastreamento de problemas e solicitações de mesclagem.

Se estiver configurando esta integração de ferramenta conforme estiver criando a cadeia de ferramentas, siga estas etapas:

Se você estiver armazenando seu código-fonte em um repositório GitLab, na seção Integrações configuráveis, clique em GitLab. Se você está configurando essa integração de ferramentas no IBM Cloud Público, você deve autorizar IBM Cloud para acessar GitLab escolhendo OAuth ou Personal Access Token.
- Se você escolher OAuth, clique em Autorizar para ir até o website GitLab. Se você não tiver uma sessão ativa do GitLab, será solicitado que efetue login. Clique em Autorizar aplicativo para permitir que o IBM Cloud acesse sua conta do GitLab. Se você tiver uma sessão do GitLab ativa, mas não inseriu sua senha recentemente, poderá ser solicitado a inserir sua senha do GitLab para confirmar.
- Se você escolher o Personal Access Token, você deve inserir o token de acesso pessoal para usar para autorizar com o GitLab para clonar repos e executar outras ações em seu nome. Se você não tem um token de acesso pessoal, você pode seguir a documentação no website GitLab para criar um. Certise-se de que seu token de acesso pessoal tenha api direitos.
Se você estiver usando um repositório em seu próprio servidor GitLab, na seção Integrações configuráveis, clique em Incluir servidor customizado.

a. Digite um título para o servidor GitHub customizado, especifique a URL raiz para o servidor e insira seu token de acesso pessoal.

b. Se você não tem um token de acesso pessoal, você pode seguir a documentação no website GitLab para criar um.

c. Se o seu servidor do GitHub estiver em air-gap ou não estiver acessível na Internet pública, você poderá conectar e integrar um Delivery Pipeline Private Worker para ser executado em sua própria infraestrutura do Kubernetes para acessar recursos internos ou locais. Para obter mais informações sobre Delivery Pipeline Trabalhadores privados, consulte Trabalhando com Delivery Pipeline Trabalhadores privados.
Revise os locais de repositório de destino padrão para os repositórios GitLab. Esses repos são clonados a partir dos mesmos repos de amostra. Se necessário, mude os nomes dos repos de destino.

Se você tiver uma cadeia de ferramentas e estiver incluindo esta integração de ferramenta nela, siga essas etapas:

No console IBM Cloud, clique no ícone Menu > Automação da plataforma > Cadeias de ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas para abrir a sua página de Visão geral. Como alternativa, na página Visão Geral do seu app, no cartão Entrega contínua, clique em Visualizar a cadeia de ferramentas. Em seguida, clique em Visão geral.
Clique em Incluir ferramenta.
Na seção Integrações de ferramentas, clique em GitLab.
Clique no servidor GitLab que você deseja usar.
Se você tiver um repositório GitLab e desejar usá-lo, para o tipo de repositório, clique em Existente e digite a URL.
Se você desejar usar um novo repositório GitLab, digite um nome para o repositório, digite a URL para o repositório que sendo clonado ou bifurcado e selecione o tipo de repositório:

a. Para criar um repositório vazio, clique em Novo.

b. Para criar uma cópia de um repositório GitLab, clique em Clonar.

c. Para bifurcar um repositório GitLab para que seja possível contribuir com as mudanças por meio de solicitações de mesclagem, clique em Bifurcar.
Se quiser criar um repositório público no servidor, desmarque a caixa de seleção Tornar este repositório privado.
Se quiser usar o Issues do GitLab para rastreamento de problemas, marque a caixa de seleção Ativar o GitLab Issues.
Se quiser rastrear a implementação de mudanças de código criando tags e comentários sobre confirmações, além de rótulos e comentários sobre problemas referenciados pelas confirmações, marque a caixa de seleção Rastrear a implementação de mudanças de código. Para obter mais informações, consulte Rastrear onde seu código é implantado com cadeias de ferramentas.
Clique em Criar integração.
Na página de visão geral da sua cadeia de ferramentas, na placa Repositórios, clique no repositório GitLab com o qual deseja trabalhar. Dependendo do repositório selecionado, o website GitLab ou o repositório GitLab de sua empresa é aberto, no qual é possível visualizar os conteúdos do repositório.
Se você ativou o GitLab Issues, clique em GitLab Issues para abri-lo. É possível usar essa instância do GitLab Issues para toda a sua cadeia de ferramentas, mesmo se a cadeia de ferramentas contém múltiplos repositórios GitLab.

Se você não tiver privilégios de proprietário ou de mestre para o repositório ao qual está vinculando, sua integração será limitada porque não será possível usar um webhook. Webhooks são necessários para executar automaticamente um pipeline quando uma confirmação é enviada por push para o repositório. Sem um webhook, os pipelines deverão ser iniciados manualmente.

Configuração GitLab usando a API

A integração de ferramentas do GitLab suporta os seguintes parâmetros de configuração que você pode usar com a API HTTP API e SDKs quando você criar, reade update integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor gitlab.

Parâmetros de integração da ferramentaGitLab
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
api_root_url	opcional, atualizável	Sequência	api_root_url	O URL da API do GitLab.
api_token	opcional, atualizável	Senha	api_token	O Token de Acesso Pessoal (PAT). Esse parâmetro é necessário apenas se o `auth_type` for configurado como `pat`, caso contrário, ele será ignorado.
auth_type	opcional, atualizável, `Default: oauth`	Sequência	auth_type	Configure o método de autenticação para usar para acessar o provedor Git.
blind_connection	opcional, atualizável, `Default: false`	Booleano	blind_connection	Defina esse valor como true para indicar que o servidor não pode ser endereçado na Internet pública porque IBM Cloud não pode validar os detalhes de conexão que você fornece. Certas funções que exigem acesso à API do servidor Git serão desativadas. Delivery Pipeline funciona somente com o uso de um trabalhador privado que tenha acesso à rede do servidor Git.
default_branch	opcional, atualizável	Sequência	default_branch	O nome do ramo padrão do repo Git.
enable_traceability	opcional, atualizável, `Default: false`	Booleano	enable_traceability	Defina esse valor como " `true` para rastrear a implantação de alterações de código criando tags, rótulos e comentários em commits, pull requests e problemas referenciados.
git_id	opcional, imutável	Sequência	git_id	Configure este valor para `gitlab` para gitlab.com, ou para o GUID de um servidor personalizado GitLab.
has_issues	opcional, atualizável, `Default: true`	Booleano	toolchain_issues_enabled	Configure este valor para `true` para ativar o Issues no repo GitLab e adiciona um cartão de integração de ferramentas de Issues à cadeia de ferramentas. Configure este valor para `false` para remover a placa de integração de ferramentas da cadeia de ferramentas. Esta ação não impacta se as questões estão ativadas no próprio repo GitLab.
integration_owner	opcional, atualizável	Sequência	integration_owner	Selecione o usuário que as operações Git são realizadas como.
owner_id	opcional, imutável	Sequência	owner_id	O usuário ou grupo GitLab que possui o repo. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Este valor é computado quando você se liga a um repo existente.
private_repo	opcional, imutável, `Default: true`	Booleano	private_repo	Configure este valor para `true` para fazer o repo privado quando você cria um repo, ou clone ou fork um repo. Este parâmetro não é usado quando você se liga a um repo existente.
repo_id	opcional, imutável	Sequência	repo_id	O ID do projeto GitLab.
repo_name	opcional, imutável	Sequência	repo_name	O nome do repositório GitLab a ser criado. Esse parâmetro é necessário quando você cria um repo, ou clone ou fork um repo. Este valor é computado quando você se liga a um repo existente.
repo_url	opcional, imutável	Sequência	repo_url	A URL do repo GitLab para esta integração de ferramenta. Este parâmetro é necessário quando você se liga a um repo existente. Esse valor é computado quando você cria um repo, ou clone ou fork um repo.
source_repo_url	opcional, imutável	Sequência	source_repo_url	A URL do repo que você deseja para fork ou clone. Esse parâmetro é necessário quando você forca ou clone um repo, mas ele não é usado quando você cria um repo ou link para um repo existente.
token_url	opcional, atualizável	Sequência	token_url	A URL do token que é usada para autorizar com o servidor GitLab.
tipo	necessário, imutável	Sequência	tipo	A operação para executar para inicializar a nova integração da ferramenta. Use `new` para criar um repo Git, `clone` para clonar um repo existente em um novo repo Git, `fork` para fork um repo Git existente ou `link` para se vincular a um repo Git existente.