Manuais do usuárioServiços de TI na ColômbiaAjuda e recursos eCloud

ECLOUD / 07

Conecte GitHub por SSH e prepare seus módulos

Organize o código, configure o acesso e confira se as alterações chegaram ao repositório correto.

Versão 4.0 · proposta para revisão · 28/10/2026

Manuais eCloud
  1. Seu computador
  2. Repositório Git
  3. AppCloud em testes

As setas indicam controles reais. Amplie qualquer detalhe. Nomes e opções podem variar conforme versão e permissões da conta.

01

Entenda o que você vai conectar

Git registra alterações no código. GitHub hospeda o repositório, uma pasta de projeto com esse histórico. SSH autentica seu computador com uma chave privada e uma pública.

Este procedimento é para o responsável autorizado pelo código, não para quem apenas usa Odoo. Você precisa de Git, OpenSSH, conta GitHub e permissão no repositório.

A tentativa SSH retorna Permission denied (publickey); depois utiliza GitHub CLI por HTTPS.

Primeiro autentique seu computador com SSH e verifique o acesso. Depois envie o código. Configure o acesso do AppCloud ao repositório separadamente.

02

01 · Prepare uma chave sem substituir outras

Exemplo no Terminal Linux; no Windows use Git Bash. Confira git --version e ssh -V. Se faltarem, peça a instalação por canais oficiais.

  1. Confira as chaves existentes com ls -la ~/.ssh. Consulte o administrador antes de substituir uma chave autorizada.
  2. Para uma chave nova, execute o exemplo com seu e-mail. Nunca sobrescreva arquivos existentes.
  3. Escolha um caminho novo se o padrão estiver ocupado. Adicione uma frase de proteção.
  4. Carregue a chave privada no agente, ajustando o caminho caso tenha escolhido outro nome.
ssh-keygen -t ed25519 -C "usuario@example.com"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
03

02 · Registre somente a chave pública

  1. Exiba cat ~/.ssh/id_ed25519.pub. A terminação .pub é essencial.
  2. No GitHub abra perfil → Settings → SSH and GPG keys → New SSH key.
  3. Identifique o computador no título, escolha chave de autenticação e cole a chave pública completa.
  4. Selecione Add SSH key e conclua a autenticação solicitada.
Chave pública · .pub

É registrada no GitHub.

Chave privada · sem .pub

Permanece protegida no computador. Nunca cole no GitHub, e-mails ou manuais.

Ilustração explicativa · dados fictícios
GitHub → Settings → SSH and GPG keys
Ação
New SSH key
Title
portatil-demo
Key type
Authentication Key
Key
Cole somente o conteúdo completo de id_ed25519.pub.

Add SSH key salva a chave pública. A privada permanece no equipamento.

04

03 · Verifique SSH antes de enviar arquivos

Execute ssh -T git@github.com. Na primeira conexão, compare a impressão digital com as impressões oficiais do GitHub antes de aceitar.

Resultado esperado: GitHub reconhece seu usuário e informa autenticação bem-sucedida sem acesso shell. É normal: você conecta Git, não uma área de trabalho ou shell remoto.

Para Permission denied (publickey), confira ssh-add -l, a chave pública registrada e a conta autorizada. Resolva antes do envio. Organizações com SSO podem exigir autorização da chave.

ssh -T git@github.com
Ilustração explicativa · dados fictícios
Verificação de identidade
Antes de aceitar
Compare a impressão digital com a documentação oficial.
Resposta correta
GitHub reconhece SEU usuário e informa que não oferece shell.
Se falhar
ssh-add -l lista as chaves carregadas; confira conta e chave pública.
Captura de referência · interface em espanhol

Permission denied (publickey)

Permission denied (publickey)
Selecione 1 para destacar a indicação.

01A autenticação falhou. Confira usuário remoto, chave carregada e chave pública registrada. Resolva o acesso antes de repetir push.

05

04 · Abra o repositório correto

  1. Abra o repositório da organização no GitHub. Se criar um novo, deixe-o privado e siga as regras da empresa.
  2. Em Code → Local → SSH, copie o endereço.
  3. Em uma pasta autorizada execute git clone ENDERECO_SSH, substituindo o marcador. Entre na pasta criada com cd NOME_DA_PASTA.
  4. Se já houver uma cópia local, use-a; não clone por cima nem inicialize novamente.
  5. Confira git remote -v e git branch --show-current. O endereço SSH normalmente começa com git@github.com:. Confirme a branch antes de editar.

SSH local e formulário AppCloud são diferentes: a construção no eCloud solicita URL HTTPS e, quando necessário, token de leitura.

Ilustração explicativa · dados fictícios
GitHub → Code → Local → SSH
SSH
git@github.com:empresa-demo/odoo-addons.git
HTTPS
https://github.com/empresa-demo/odoo-addons.git

Endereços fictícios: copie os do seu repositório. SSH autentica seu computador; AppCloud usa acesso de leitura independente.

06

05 · Organize, revise e envie alterações

AppCloud espera addons/nome_tecnico/__manifest__.py. Cada módulo deve estar descompactado na sua pasta. requirements.txt é opcional para dependências necessárias. Nunca envie bancos de dados, perfis VPN, chaves privadas ou tokens.

  1. Copie somente módulos autorizados e compatíveis com sua versão Odoo.
  2. Se necessário, configure a identidade neste repositório: git config user.name "Seu nome" e git config user.email "usuario@example.com".
  3. Revise git status e git diff.
  4. Prepare somente caminhos aprovados. O exemplo adiciona addons; adicione requirements.txt explicitamente se alterado.
  5. Revise antes de criar o commit (registro da alteração). Envie somente para a branch aprovada.
git add addons/
git diff --cached --stat
git diff --cached --check
git commit -m "Update approved modules"
git push -u origin main

O exemplo usa main; adapte à sua branch. Se houver rejeição, revise regras ou alterações remotas com o responsável; não use --force. No GitHub confira commit e pastas. Enviar código não o publica em produção.

Ilustração explicativa · dados fictícios
O que cada comando faz
git status / git diff
Mostra arquivos alterados e alterações antes de prepará-los.
git add addons/
Prepara esses arquivos para o próximo commit.
git diff --cached --stat / --check
Resume alterações preparadas e detecta problemas de espaços.
git commit
Registra a alteração local; ainda não envia.
git push
Envia para a branch remota. Confira o commit no GitHub.
Captura de referência · interface em espanhol

addons

addons
Selecione 1 para destacar a indicação.

01Confira a raiz do repositório com pwd e ls. requirements.txt é opcional e fica na raiz quando há dependências adicionais.

Ajuda e referências

As opções disponíveis dependem do serviço, da versão e das permissões da sua conta.

Solicitar suporte ↗

GitHub · SSH ↗

GitHub · Fingerprints ↗