Estas instruções são destinadas a desenvolvedores de aplicativos, administradores de plataforma e gerentes de segurança que querem usar repositórios de código-fonte do GitLab Enterprise com o Google. Especificamente, é possível usar repositórios do GitLab Enterprise com o Gemini Code Assist.
Para saber mais sobre o Developer Connect, consulte Visão geral do Developer Connect.
Antes de começar
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Developer Connect, Secret Manager APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.-
Verifique se você tem acesso a uma conta no GitLab Enterprise.
Para ajudar a manter o trabalho da sua equipe seguro, recomendamos que você conclua as tarefas deste guia usando uma conta de serviço ou uma conta compartilhada pela sua equipe, não uma conta pessoal.
- Verifique se você é proprietário de um repositório do GitLab Enterprise ou se tem permissões de administrador em um repositório compartilhado.
- Opcional: crie uma chave de criptografia gerenciada pelo cliente (CMEK) para criptografar os secrets de autenticação criados pelo Developer Connect.
- Opcional: para usar as instruções de linha de comando deste guia, siga estas etapas:
- Instale a CLI do Google Cloud. Se
você já instalou a CLI gcloud anteriormente, verifique se tem
a versão mais recente disponível executando
gcloud components update. - Crie uma conta de serviço do Developer Connect
executando o seguinte comando, em que PROJECT_ID é o Google Cloud ID do projeto:
gcloud beta services identity create \ --service=developerconnect.googleapis.com \ --project=PROJECT_ID
- Instale a CLI do Google Cloud. Se
você já instalou a CLI gcloud anteriormente, verifique se tem
a versão mais recente disponível executando
Requisitos do host
Se você não tiver instalado uma instância do servidor do GitLab Enterprise Edition, consulte o guia de instalação do GitLab Enterprise Edition para ver instruções.
Ao seguir as instruções para instalar uma instância do servidor do GitLab Enterprise Edition, observe o seguinte:
Você precisa configurar o host para processar o protocolo
HTTPS. Hosts configurados com o protocoloHTTPnão são compatíveis.Configure o host com o mesmo URL usado para acessá-lo em Google Cloud. Para saber mais, consulte a documentação do GitLab sobre como configurar o URL externo.
Funções exigidas
Para receber as permissões necessárias para criar conexões e links, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Se você não for o proprietário do projeto:
Administrador do Developer Connect (
roles/developerconnect.admin) na sua conta de usuário. -
Se você planeja usar uma CMEK para criptografar os secrets criados pelo Developer Connect:
Criptografador/Descriptografador de CryptoKey do Cloud KMS (
roles/cloudkms.cryptoKeyEncrypterDecrypter) na conta de serviço do Secret Manager. -
Se você planeja usar a CLI gcloud para concluir as etapas deste guia:
Papel de administrador do Secret Manager (
roles/secretmanager.admin) na conta de serviço do Developer Connect. -
Se você planeja usar o console do Google Cloud para concluir as etapas deste guia:
Administrador do IAM do projeto (
roles/resourcemanager.projectIamAdmin) na sua conta de usuário.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.
Criar tokens de acesso
Para criar tokens de acesso no GitLab, siga estas etapas:
Siga as instruções na documentação do GitLab para criar tokens de acesso pessoal, tokens de acesso de grupo ou tokens de acesso de projeto com as seguintes permissões:
- Um token com escopo
apipara conectar e desconectar repositórios. - Um token com escopo
read_apipara permitir que o Developer Connect leia o código-fonte nos seus repositórios. - Para tokens de acesso de grupo e de projeto, os tokens precisam ter um papel de mantenedor ou superior.
- Um token com escopo
Crie uma conexão
Nesta seção, descrevemos como criar uma conexão entre o Developer Connect e o GitLab Enterprise. Se você estiver usando o console do Google Cloud , também poderá começar a adicionar links a repositórios ao concluir a configuração da conexão.
Para criar uma nova conexão do GitLab Enterprise, selecione uma das seguintes opções:
Console
Para iniciar uma conexão, siga estas etapas:
No console do Google Cloud , abra o Developer Connect.
O Developer Connect exibe a página Repositórios Git.
- Se você encontrar uma lista de provedores de gerenciamento de código-fonte: comece a configurar sua primeira conexão selecionando um provedor de gerenciamento de código-fonte. Clique em Conectar no card do GitLab Enterprise.
Se você encontrar uma tabela com as conexões atuais: defina o provedor de gerenciamento de código-fonte clicando em Criar conexão > GitLab Enterprise.
A página Criar conexão é aberta.
Em Região, escolha uma região para os recursos de conexão.
- Em Nome, insira um nome para a nova conexão.
Em URL do host, digite o URL do host ao qual você quer se conectar.
Na seção Tokens de acesso, insira os tokens da sua conta:
- Token de acesso à API: insira o token de acesso com o escopo
api. - Ler token de acesso à API: insira o token de acesso com o escopo
read_api.
Você é responsável por garantir que os tokens do GitLab permaneçam válidos. Os tokens do GitLab têm uma vida útil máxima de 365 dias, a menos que especificado de outra forma pelo criador do token ou por um administrador. Para saber como gerenciar as configurações de expiração de tokens e as notificações, consulte a documentação do GitLab sobre tokens de acesso pessoal, tokens de acesso de grupo e tokens de acesso de projeto.
- Token de acesso à API: insira o token de acesso com o escopo
Clique em Mostrar mais para ver as configurações opcionais.
Opcional: por padrão, o Developer Connect pode atuar como um proxy para chamadas do Git para o GitLab Enterprise. Para desativar essa opção, desmarque a caixa de seleção Ativar o proxy do Developer Connect.
Em Tipo de rede, selecione Internet pública.
Se você quiser usar uma rede privada, consulte Conectar-se a repositórios do GitLab Enterprise hospedados em uma rede privada.
Opcional: na seção Criptografia, selecione uma chave CMEK para criptografar os secrets do Secret Manager criados pelo Developer Connect.
Clique em Continuar.
Depois que a conexão for criada, a página Vincular repositórios vai aparecer.
Siga estas etapas para vincular repositórios à sua conexão:
Na lista de repositórios disponíveis, selecione os que você quer usar.
Clique em OK.
Clique em Vincular.
Sua conexão é adicionada à página Conexões, e os links do repositório são adicionados à página Repositórios no console do Google Cloud . É possível adicionar mais links às conexões atuais a qualquer momento.
Se você estiver configurando o Gemini Code Assist, siga as etapas em Configurar e usar a personalização de código do Gemini Code Assist.
gcloud
Crie um secret de webhook no Secret Manager executando o seguinte comando, em que WEBHOOK_SECRET_NAME é um nome para o secret de webhook:
cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAMEArmazene os tokens de acesso no Secret Manager executando os seguintes comandos:
gcloud secrets create API_SECRET_NAME echo -n API_SECRET_DATA | gcloud secrets versions add API_SECRET_NAME --data-file=- gcloud secrets create READ_SECRET_NAME echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-Substitua:
- API_SECRET_NAME: um nome para o secret que armazena
o token com o escopo
api. - API_SECRET_DATA: o token com escopo
api, semelhante aglpat-XXXXXXXXXXXXXXXX. - READ_SECRET_NAME: um nome para o secret que armazena
o token com o escopo
read_api. - READ_SECRET_DATA: o token com escopo
read_api, semelhante aglpat-XXXXXXXXXXXXXXXX.
- API_SECRET_NAME: um nome para o secret que armazena
o token com o escopo
Inicie uma conexão com sua conta corporativa do GitLab Enterprise executando o comando
developer-connect connections create:gcloud developer-connect connections create CONNECTION_NAME \ --location=REGION \ --gitlab-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \ --gitlab-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/API_SECRET_NAME/versions/VERSION \ --gitlab-enterprise-config-host-uri=HOST_URI \ --gitlab-enterprise-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION \ --git-proxy-config-enabledSubstitua:
- CONNECTION_NAME: o nome da conexão.
- REGION: a região da conexão.
- PROJECT_ID: o ID do projeto do Google Cloud.
- READ_SECRET_NAME: o nome do secret do Secret Manager que contém o token com o escopo
read_api. - API_SECRET_NAME: o nome do secret do Secret Manager que contém o token com o escopo
api. - VERSION: o número da versão de cada secret. Pode ser
latestpara usar o número da versão mais recente. - HOST_URI: o URI do host ao qual você quer se conectar.
- WEBHOOK_SECRET_NAME: o nome do secret do Secret Manager que contém o webhook.
--git-proxy-config-enabled: uma flag opcional que permite que o Developer Connect atue como um proxy para chamadas do Git para o GitLab Enterprise.
O Developer Connect conclui a conexão com o GitLab. Em seguida, vincule aos repositórios.
Vincular a repositórios usando uma conexão atual
Depois de estabelecer uma conexão com o GitLab Enterprise, é possível vincular a repositórios. Repita essas etapas mais tarde para vincular outros repositórios, conforme necessário.
Para criar links de repositório em uma conexão atual do GitLab Enterprise, selecione uma das seguintes opções:
Console
Para criar links para repositórios, siga estas etapas:
Abra a página Repositórios no console do Google Cloud .
Clique em Vincular repositório.
O painel Vincular repositórios Git é aberto.
Na lista de conexões, escolha uma.
Clique em Continuar.
Na lista de repositórios, selecione os que você quer vincular.
O Developer Connect mostra nomes sugeridos para os recursos do repositório.
Selecione uma opção de nomenclatura de recurso de repositório:
- Gerado: use os nomes de recursos de repositório gerados.
- Manual: insira os nomes que quiser.
Clique em Criar.
O Developer Connect cria os links do repositório e os exibe no console do Google Cloud .
gcloud
Vincule a um repositório do GitLab executando o seguinte comando:
gcloud developer-connect connections git-repository-links create REPO_NAME \
--clone-uri=REPO_URI \
--connection=CONNECTION_NAME \
--location=REGION
Substitua:
- REPO_NAME: o nome do link do repositório.
- REPO_URI: o link para o repositório, semelhante
a
https://gitlab.com/my-project/test-repo.git. - CONNECTION_NAME: o nome da conexão.
- REGION: a região da conexão.
O Developer Connect cria os links do repositório.
Para listar repositórios vinculados, execute o
comando developer-connect connections git-repository-links list.
Se você estiver configurando o Gemini Code Assist, siga as etapas em Configurar e usar a personalização de código do Gemini Code Assist.