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.
- Seu computador
- Repositório Git
- 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.
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.
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.
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.
- Confira as chaves existentes com
ls -la ~/.ssh. Consulte o administrador antes de substituir uma chave autorizada. - Para uma chave nova, execute o exemplo com seu e-mail. Nunca sobrescreva arquivos existentes.
- Escolha um caminho novo se o padrão estiver ocupado. Adicione uma frase de proteção.
- 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_ed2551902 · Registre somente a chave pública
- Exiba
cat ~/.ssh/id_ed25519.pub. A terminação .pub é essencial. - No GitHub abra perfil → Settings → SSH and GPG keys → New SSH key.
- Identifique o computador no título, escolha chave de autenticação e cole a chave pública completa.
- Selecione Add SSH key e conclua a autenticação solicitada.
É registrada no GitHub.
Permanece protegida no computador. Nunca cole no GitHub, e-mails ou manuais.
- 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.
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- 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.
Permission denied (publickey)

01A autenticação falhou. Confira usuário remoto, chave carregada e chave pública registrada. Resolva o acesso antes de repetir push.
04 · Abra o repositório correto
- Abra o repositório da organização no GitHub. Se criar um novo, deixe-o privado e siga as regras da empresa.
- Em Code → Local → SSH, copie o endereço.
- Em uma pasta autorizada execute
git clone ENDERECO_SSH, substituindo o marcador. Entre na pasta criada comcd NOME_DA_PASTA. - Se já houver uma cópia local, use-a; não clone por cima nem inicialize novamente.
- Confira
git remote -vegit branch --show-current. O endereço SSH normalmente começa comgit@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.
- 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.
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.
- Copie somente módulos autorizados e compatíveis com sua versão Odoo.
- Se necessário, configure a identidade neste repositório:
git config user.name "Seu nome"egit config user.email "usuario@example.com". - Revise
git statusegit diff. - Prepare somente caminhos aprovados. O exemplo adiciona addons; adicione requirements.txt explicitamente se alterado.
- 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 mainO 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.
- 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.
addons

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 ↗