Esta página explica como conectar um repositório do GitHub Enterprise ao Cloud Build. Para saber mais sobre os repositórios do Cloud Build, consulte Repositórios do Cloud Build.
Antes de começar
Ative as APIs Cloud Build e Secret Manager.
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (
roles/serviceusage.serviceUsageAdmin), que contém a permissãoserviceusage.services.enable. Saiba como conceder papéis.
- Siga as instruções para conectar um host do GitHub Enterprise.
- Verifique se você tem acesso de administrador nos repositórios para os quais quer ativar os gatilhos do GitHub Enterprise.
Conectar a um repositório do GitHub Enterprise
Console
Para conectar um repositório do GitHub Enterprise a uma conexão de host, siga estas etapas:
Abra a página Repositórios no Google Cloud console.
A página Repositórios aparece.
Na parte de cima da página, selecione a guia 2ª geração.
Clique em Vincular repositório para vincular repositórios da conexão.
O painel Vincular repositórios aparece.
No painel Vincular repositórios, insira as seguintes informações:
- Conexão: selecione uma conexão no menu suspenso.
Repositório: selecione um repositório para vincular à conexão.
Nome do repositório: insira um nome para o repositório.
- Gerado: selecione essa opção para que o Cloud Build gere automaticamente nomes de repositórios em seu nome para os repositórios selecionados.
Manual: selecione essa opção para especificar manualmente os nomes dos seus repositórios selecionados.
Se você selecionar Manual, poderá modificar os nomes dos repositórios selecionados na seção Nomes de repositórios.
Clique em Vincular para vincular o repositório à conexão.
Você vinculou o repositório do GitHub Enterprise à conexão.
gcloud
Para adicionar um repositório do GitHub Enterprise à conexão, insira o seguinte comando:
gcloud builds repositories create REPO_NAME \
--remote-uri=REPO_URI \
--connection=CONNECTION_NAME --region=REGION
Em que:
- REPO_NAME é o nome do repositório.
- REPO_URI é o link para o repositório do GitHub.
- CONNECTION_NAME é o nome da conexão de host do GitHub Enterprise criada no Cloud Build em Conectar a um host do GitHub Enterprise.
- REGION é a região da conexão.
Terraform
Para adicionar um repositório do GitHub Enterprise à conexão, adicione o seguinte snippet de código à configuração do Terraform:
resource "google_cloudbuildv2_repository" "my-repository" {
project = "PROJECT_ID"
name = "REPO_NAME"
location = :REGION"
parent_connection = google_cloudbuildv2_connection.my-connection.name
remote_uri = "REMOTE_URI'
}
Em que:
- PROJECT_ID é o ID do Google Cloud projeto.
- REPO_NAME é o nome do repositório do GitHub.
- REGION é a região da conexão.
- URI é o URI remoto do repositório. Por exemplo,
https://github.com/myuser/myrepo.git.
Próximas etapas
- Saiba como criar repositórios do GitHub Enterprise.
- Saiba como criar repositórios do GitHub Enterprise em uma rede particular.
- Saiba como realizar implantações azul-verde no Compute Engine.
- Saiba como especificar outros repositórios como dependências do build.