Skip to main content

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. Para saber mais, confira Gerando uma nova chave SSH e adicionando-a ao agente SSH.

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .
  4. Em "Acesso SSH", cole a chave na caixa de texto "Adicionar nova chave SSH" e clique em Adicionar chave. A alteração entra em vigor imediatamente. Portanto, você não precisa clicar em Salvar configurações.

Conectar-se ao shell administrativo por SSH

Depois de adicionar sua chave SSH à lista, conecte-se à instância via SSH como o 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

Ao encontrar o erro Permission denied (publickey) durante uma tentativa de conexão com o sua instância do GitHub Enterprise Server via SSH, verifique se você está se conectando 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 o usuário admin e use a senha estabelecida durante a 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. Acesse o Suporte do GitHub Enterprise se tiver alguma dúvida sobre as atividades permitidas pelo seu contrato de suporte.