Conectar um repositório de código-fonte

Conectar um repositório de código-fonte

Com o Developer Connect, você pode fazer integrações com produtos e serviços que não são do Google para usá-los em produtos compatíveis do Google.

Neste guia de início rápido, mostramos como se conectar ao GitHub usando uma conexão de repositório Git. Esse tipo de conexão é necessário quando você quer usar a personalização de código do Gemini Code Assist.

Para conferir uma lista de todas as integrações compatíveis com o Developer Connect, consulte Visão geral do Developer Connect.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
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 the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Developer Connect and Secret Manager APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Make sure that you have the following role or roles on the project: Developer Connect Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect and Secret Manager APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Make sure that you have the following role or roles on the project: Developer Connect Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.
3. Click Grant access.

4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

5. Click Select a role, then search for the role.
6. To grant additional roles, click Add another role and add each additional role.
7. Click Save.
1. Verifique se você tem uma conta do GitHub e acesso a um repositório hospedado em GitHub.com. Ou siga a documentação do GitHub para criar novas contas:
• Criar uma conta do GitHub
• Crie um repositório em GitHub.com.
2. Se você estiver usando um repositório existente e não for o proprietário, peça a ele para conceder permissões de administrador ao repositório. Se o repositório estiver em uma organização do GitHub, peça permissões de nível de administrador ao proprietário da organização. Para saber mais sobre as organizações do GitHub, consulte Tipos de contas do GitHub.

Iniciar uma conexão

1. Abra a página Developer Connect no console Google Cloud .

   Acessar o Developer Connect

   A página Repositórios Git é aberta, mostrando uma lista de provedores de gerenciamento de código-fonte.

2. Clique em Conectar no card do provedor para selecionar um.

   A página Criar conexão é aberta.

3. Escolha us-central1 como a região.

4. Insira quickstart-connection como o nome.

5. Clique em Continuar.

   A caixa de diálogo Google Developer Connect aparece solicitando autorização para usar seu token OAuth do GitHub.

   Se uma caixa de diálogo não aparecer, desative todos os plug-ins do navegador de bloqueio de pop-up e verifique se as configurações do navegador permitem pop-ups. Por exemplo, no Chrome, siga as instruções para permitir pop-ups.

6. Clique em Entendi e quero continuar.

7. Conclua as etapas de login da conta do GitHub, se solicitado.

8. Clique em Autorizar o Developer Connect se for solicitado. Se essa solicitação não aparecer, a autorização já foi concedida a essa conta.

Configurar a conexão

Conceda permissões na sua conta e nos repositórios do GitHub seguindo estas etapas. Os comandos dependem de se alguém que usa a conta do GitHub já instalou o app Google Developer Connect no GitHub.

• Se você vir uma lista de contas do GitHub:o app ainda não está instalado. Para instalar e configurar, siga estas etapas:

  1. Escolha a conta do GitHub que tem acesso ao repositório que você quer vincular.

  2. Especifique as permissões do repositório do GitHub e instale o app. Para mais informações, consulte as instruções do GitHub sobre instalação de apps.

• Se aparecer uma solicitação para reutilizar uma instalação: escolha onde instalar e configurar o app seguindo estas etapas:

  1. Clique em Conta do GitHub para ver as contas em que o app está instalado. Se a conta que você quer usar aparecer, escolha ela.

     1. Clique em Confirmar.

  2. Se você não encontrar a conta que quer usar, escolha Instalar o app GitHub em outra conta do GitHub.

     1. Clique em Confirmar.

     2. Escolha a conta do GitHub que você quer usar.

     3. Especifique as permissões do repositório do GitHub e instale o app. Para mais informações, consulte as instruções do GitHub sobre instalação de apps.

1. Em Repositórios, escolha o repositório que você quer vincular.

2. Clique em Vincular.

A conexão é adicionada à lista de conexões, e o repositório vinculado é adicionado à lista de repositórios.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

1. No console do Google Cloud , acesse a página Developer Connect.

   Acessar o Developer Connect

2. Na guia Repositórios, na linha que contém o nome do repositório vinculado, clique em Mais opções.

3. Escolha Desvincular.

4. Clique em Confirmar.

5. Clique na guia Conexões.

6. Na linha que contém o nome da sua conexão, clique em Mais opções.

7. Selecione Excluir.

8. Insira o nome da sua conexão.

9. Clique em Confirmar.

Excluir conexões e links não exclui os repositórios em GitHub.com. Se você criou um novo repositório do GitHub para este guia de início rápido e quer excluir o repositório, siga as instruções do GitHub para excluir um repositório.

Se quiser desinstalar o app Google Developer Connect, siga as instruções do GitHub sobre como modificar apps instalados.

A seguir

• Saiba mais sobre a personalização de código do Gemini Code Assist.
• Crie apps no Firebase App Hosting usando repositórios do GitHub.