Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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 obter mais informações, confira "Como gerar uma nova chave SSH e adicioná-la ao ssh-agent".

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

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Management Console . Guia Management Console na barra lateral esquerda

  3. Em "Acesso SSH", cole a chave na caixa de texto e clique em Adicionar chave. Caixa de texto e botão usados para adicionar uma chave SSH 1. Na barra lateral esquerda, clique em Salvar configurações.

    Captura de tela do botão Salvar configurações no Management Console

    Observação: se você salvar as configurações no Management Console, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  4. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

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 your GitHub Enterprise Server instance 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. Entre em contato com o GitHub Enterprise Support em caso de perguntas sobre as atividades permitidas pelo contrato.