Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Acesar o shell administrativo (SSH)

O acesso de SSH permite que você execute os utilitários da linha de comando de GitHub Enterprise Server para solucionar problemas, executar backups e configurar a replicação.

Sobre o acesso ao shell administrativo

Se tiver acesso por SSH ao shell administrativo, você poderá executar os utilitários de linha de comando do GitHub Enterprise Server. O acesso SSH também é útil para solucionar problemas, fazer backups e configurar a replicação. O acesso a SSH administrativa é gerenciado separadamente do acesso SSH do Git e fica acessível apenas pela porta 122.

Habilitar o acesso ao shell administrativo por SSH

Para habilitar o acesso a SSH administrativa, você deve adicionar sua chave pública SSH à lista de chaves autorizadas da instância.

Dica: as alterações nas chaves SSH autorizadas entram em vigor de imediato.

  1. A partir de uma conta administrativa em GitHub Enterprise Server, clique em no canto superior direito de qualquer página. Ícone de foguete para acessar as configurações de administrador do site
  2. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda
  3. Em "SSH access" (Acesso SSH), cole a chave no campo de texto e clique em Add key (Adicionar chave). Caixa de texto e botão para adicionar uma chave SSH
  4. Na barra lateral esquerda, clique Save settings (Salvar configurações). Botão Save settings (Salvar configurações) no Console de gerenciamento
  5. Aguarde a conclusão da execução de suas configurações.

Conectar-se ao shell administrativo por SSH

Depois de adicionar sua chave SSH à lista, conecte-se à instância por SSH como usuário admin na porta 122.

$ ssh -p 122 admin@github.example.com
Last login: Sun Nov 9 07:53:29 2014 from 169.254.1.1
admin@github-example-com:~$ █

Solucionar problemas de conectividade com SSH

Se o erro Permission denied (publickey) (Permissão negada [chave pública]) ocorrer quando você tentar se conectar à sua instância do GitHub Enterprise Server via SSH, confirme se a conexão está sendo feita pela porta 122. Talvez seja necessário especificar explicitamente a chave SSH privada em uso.

Para especificar uma chave SSH privada usando a linha de comando, execute ssh com o argumento -i.

ssh -i /path/to/ghe_private_key -p 122 admin@hostname

Você também pode especificar uma chave SSH privada usando o arquivo de configuração SSH (~/.ssh/config).

Host hostname
  IdentityFile /path/to/ghe_private_key
  User admin
  Port 122

Acesar o shell administrativo usando o console local

Em uma situação de emergência, se o acesso por SSH estiver indisponível, você poderá acessar o shell administrativo localmente. Entre como usuário admin usando a senha definida na configuração inicial do GitHub Enterprise Server.

Limitações de acesso ao shell administrativo

O acesso ao shell administrativo é permitido apenas para solucionar problemas e executar procedimentos de operações documentadas. Modificar arquivos de aplicativos e sistemas, executar programas ou instalar pacotes de software não compatíveis pode anular seu contrato de suporte. Entre em contato com o Suporte do GitHub Enterprise ou Suporte do GitHub Premium em caso de perguntas sobre as atividades permitidas pelo contrato.