For the complete documentation index, see llms.txt. This page is also available as Markdown.

Conectando um repositório do GitHub

Visão geral

Este artigo mostra como conectar seu repositório do GitHub ao DevOps para que os metadados do Salesforce gerenciados nos branches do DevOps sejam sincronizados automaticamente com seu repositório do GitHub. Isso garante que seus branches, commits e pull requests sejam totalmente rastreados no seu sistema de controle de versão baseado em Git.

Tokens de acesso pessoal do GitHub

O DevOps se conecta a um repositório do GitHub usando um token de acesso pessoal. Você pode usar um Clássico token ou um Granular token, dependendo dos requisitos da sua empresa. As instruções abaixo cobrem ambos os métodos, mas você só precisa criar um tipo de token.

Pré-requisitos do GitHub

1

Repositório

A integração do DevOps com o GitHub sincroniza todos os branches, commits e pull requests em um único repositório do GitHub. Esse repositório pode ser público ou privado e pode pertencer a uma organização ou a um usuário individual.

A captura de tela abaixo mostra um repositório privado flosum-devops-example que faz parte da Flosum-Example organização.

2

Token de acesso pessoal - Clássico

Um Clássico token se aplica a todos os repositórios aos quais sua conta do GitHub pode acessar e precisa de apenas dois escopos. As instruções a seguir explicam como criar um.

  1. Faça login na sua conta do GitHub.

  2. Clique na sua foto de perfil no canto superior direito para abrir o menu suspenso.

  3. Clique em Configurações.

  4. Acesso Configurações do desenvolvedor > Tokens de acesso pessoal > Tokens (clássicos).

  5. Clique no Gerar novo token menu suspenso.

  6. Clique em Gerar novo token (clássico).

  7. Insira uma descrição do token na Nota caixa de texto.

  8. Clique no Expiração menu suspenso e selecione a data em que você deseja que o token expire.

  9. Selecione o seguinte Escopos:

    1. repo

    2. workflow

  10. Clique em Gerar token na parte inferior da página.

  11. Copie o token e salve-o com segurança. Você precisará deste token ao conectar o DevOps à sua conta do GitHub.

3

Token de acesso pessoal - Granular

Um Granular token é limitado aos repositórios e permissões que você selecionar, então ele concede ao DevOps um acesso mais restrito do que um Clássico token. As instruções a seguir explicam como criar um.

  1. Faça login na sua conta do GitHub.

  2. Clique na sua foto de perfil no canto superior direito para abrir o menu suspenso.

  3. Clique em Configurações.

  4. Acesso Configurações do desenvolvedor > Tokens de acesso pessoal > Tokens granulares.

  5. Clique em Gerar novo token.

  6. Insira um nome para o token na Nome do token caixa de texto.

  7. Clique no Proprietário do recurso menu suspenso e selecione o usuário ou a organização que é proprietária do repositório para o qual este token será usado.

  8. Clique no Expiração menu suspenso e selecione a data em que você deseja que o token expire.

  9. Em Acesso ao repositório, selecione Selecionar apenas repositórios para limitar o escopo deste token apenas aos repositórios que você selecionar.

Você também pode selecionar Todos os repositórios, mas então o token terá acesso a quaisquer novos repositórios adicionados ao Proprietário do recurso.

Não selecione Repositórios públicos. Esta opção concede acesso somente leitura, e a integração do DevOps com o GitHub requer permissões de leitura e gravação.

  1. Clique no Selecionar repositórios menu suspenso e marque todos os repositórios a serem incluídos com este token.

  2. Em Permissões, clique em Adicionar permissões para adicionar cada uma das permissões na tabela abaixo.

  3. Defina o Acesso menu suspenso de cada permissão para corresponder à coluna Acesso na tabela abaixo.

Permissão
Acesso

Administração

Leitura e gravação

Conteúdo

Leitura e gravação

Metadados

Somente leitura

Webhooks

Leitura e gravação

A Metadados permissão é adicionada automaticamente quando outra permissão é adicionada.

  1. Clique em Gerar token.

  2. Revise as configurações do token na caixa de diálogo de confirmação e clique em Gerar token.

  3. Copie o token e salve-o com segurança. Você precisará deste token ao conectar o DevOps à sua conta do GitHub.

Conectar o DevOps ao GitHub

1

Acessar as configurações de integração com Git

  1. Clique em Integração com Git na Configurações seção no menu da barra lateral esquerda.

  2. Clique no Configurações aba.

2

Conectar GitHub

  1. Clique no Tipo de serviço menu suspenso.

  2. Selecione GitHub.

  3. Na Organização caixa de texto, insira o nome da organização do GitHub proprietária do repositório ao qual você está se conectando. Deixe em branco se estiver se conectando a um repositório pertencente à sua conta de usuário do GitHub.

Caminho do repositório

O caminho do repositório do GitHub ao qual a integração tenta se conectar depende de se o Organização campo tem um valor.

Se o Organização campo tiver um valor, o caminho do repositório é:

  • github.com/{Organization}/{Repository name}

Se o Organização campo estiver em branco, o caminho do repositório é:

  • github.com/{Username}/{Repository name}

  1. Na Nome de usuário caixa de texto, insira o nome de usuário do GitHub com o qual você está conectando esta integração.

  2. Na Token caixa de texto, insira o token de acesso pessoal do GitHub que você criou na seção acima.

  3. Na Nome do repositório caixa de texto, insira o nome do repositório do GitHub ao qual você está se conectando.

  4. Clique em Conectar.

  5. Se a integração com Git se conectar com sucesso ao seu repositório do GitHub, uma mensagem de sucesso aparecerá. A GitHub conexão então lista a organização e mostra seu status como Conectado.

3

Sincronização do GitHub

Depois de conectado, todos os branches do DevOps começarão a ser sincronizados com o repositório do GitHub. Você pode verificar o progresso da sincronização na Atividades aba.

4

Repositório do GitHub

A captura de tela abaixo mostra um exemplo de um repositório do GitHub conectado e sincronizado com o DevOps.

Atualizado

Isto foi útil?