Digite pelo menos duas letras para buscar em todas as páginas da documentação.

↑ ↓ para navegar ↵ para abrir esc para fechar

Usando o rdev

Acesso ao Git

O seu servidor clona e faz push dos seus repositórios por conta própria, então precisa do próprio caminho para o GitHub, o GitLab, o Bitbucket ou o seu próprio servidor Git. Os repositórios públicos não precisam de nada. Para os privados, dê ao servidor uma chave ou um token uma única vez; todo projeto depois disso simplesmente funciona.

As chaves e os tokens ficam no seu servidor. O rdev.cloud só vê chaves públicas, e um token que você digita no painel é criptografado no seu navegador para o seu servidor antes de ser enviado.

Três formas de entrar

Forma Alcança Melhor para
Chave do servidor Todos os repositórios que a sua conta Git consegue abrir Uma conta pessoal
Contas Os repositórios dos proprietários que você listar, cada um com a própria chave SSH ou token Várias contas, de trabalho e pessoais, outros hosts
Deploy key Um único repositório O acesso mais restrito, repositórios de clientes

Quando o servidor clona, ele escolhe a primeira que servir: a deploy key do projeto, depois uma conta cujo host e proprietário correspondam à URL, depois a chave do servidor. Se um clone por SSH for recusado e o repositório for público, ele recorre ao HTTPS. Cada clone lembra como foi aberto, então o git pull e o git push continuam funcionando.

A chave do servidor

Abra o servidor em Servidores, vá para a aba Acesso e encontre Acesso ao Git. Escolha Gerar chave na primeira vez, copie a chave e adicione-a à sua conta: o GitHub, o GitLab e o Bitbucket têm um botão cada um que abre a página certa. A mesma chave funciona para pushes, então o seu agente de IA também pode fazer push.

No terminal do servidor:

rdev git key            # print the key (made on first use)
rdev git key --rotate   # make a new one; remove the old one from your hosts

Contas

Adicione quantas contas quiser: duas contas do GitHub, um GitLab da empresa, o Bitbucket e um Gitea próprio lado a lado. Cada conta tem:

  • Nome: curto, como work ou personal.
  • Host: github.com, gitlab.com, bitbucket.org ou o seu próprio, com :port quando o SSH não está na 22.
  • Proprietários: usuários ou organizações, opcional. Os repositórios sob eles usam esta conta; sem proprietários, todos os repositórios do host a usam.
  • Chave SSH ou token: uma conta SSH recebe a própria chave para adicionar no host. Uma conta com token clona por HTTPS com um token de acesso pessoal (token refinado do GitHub, token pessoal ou de projeto do GitLab, token de API do Bitbucket, PAT do Azure DevOps). O GitLab espera o nome de usuário oauth2, o Bitbucket o seu e-mail.

No painel, escolha Adicionar conta. No app para laptop, a mesma lista fica na aba Integrações. No terminal:

rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab

Deploy keys

Uma deploy key abre um repositório. Em Deploy keys, digite o nome do projeto (um projeto existente ou o que você está prestes a adicionar) e escolha Gerar deploy key, depois adicione a chave às deploy keys do repositório, com acesso de escrita se o agente deve fazer push. Ao adicionar o projeto, marque Usar a deploy key do projeto, ou execute:

rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key

Confiando em um host

O servidor já conhece as chaves do GitHub, do GitLab e do Bitbucket. Na primeira vez que encontra outro host, ele não se conecta às cegas: o host aparece em Hosts aguardando confiança com a impressão digital. Compare-a com a que o seu host Git publica e escolha Confiar, ou execute rdev git trust git.example.com --fingerprint SHA256:….

Testando o acesso

Antes de adicionar um projeto, cole a URL dele em Testar acesso. O servidor tenta lê-lo e, se você marcar Verificar também se ele pode fazer push, fazer push sem alterar nada. A resposta diz qual chave ou token ele usou, ou o que fazer em seguida. No terminal: rdev git test <url> [--write].