Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2023-01-18. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Painel de administração do site

Você pode usar o painel de administração do site para gerenciar usuários, organizações e repositórios diretamente na sua empresa em GitHub Enterprise Server.

Para acessar o painel, no canto superior direito de qualquer página, clique em . Ícone de foguete usado para acessar as configurações de administrador do site

Pesquisar

Veja esta seção do painel de administração do site para pesquisar usuários e repositórios e consultar o log de auditoria.

Management Console

Neste espaço, é possível iniciar o Management Console para gerenciar configurações do appliance virtual, como domínio, autenticação e SSL.

Explorar

Os dados da página de tendências do GitHub são calculados em períodos diários, semanais e mensais para repositórios e desenvolvedores. Você pode ver quando esses dados foram armazenados em cache pela última vez e colocar na fila novos trabalhos de cálculo de tendências na seção Explorar.

Log de auditoria

O GitHub Enterprise Server mantém um log contínuo das ações auditadas que você pode consultar.

Por padrão, o log de auditoria mostra uma lista de todas as ações auditadas em ordem cronológica inversa. Filtre essa lista inserindo pares chave-valor na caixa de texto Consulta e clicando em Pesquisar, conforme explicado em "Como fazer pesquisas no log de auditoria para sua empresa".

Para obter mais informações sobre o log de auditoria em geral, confira "Sobre o log de auditoria da sua empresa". Para ver uma lista completa das ações auditadas, confira "Eventos de log de auditoria da sua empresa".

Relatórios

Caso você precise obter informações sobre os usuários, as organizações e os repositórios do your GitHub Enterprise Server instance, normalmente, busque dados JSON por meio da API do GitHub. Infelizmente, a API pode não fornecer todos os dados necessários e ainda requer um pouco de conhecimento técnico. O painel de administração do site oferece uma seção Relatórios como alternativa, facilitando o download de relatórios CSV com a maioria das informações de que você provavelmente precisará para usuários, organizações e repositórios.

Especificamente, é possível baixar relatórios CSV que listem o seguinte:

  • todos os usuários;
  • todos os usuários ativos
  • todos os usuários inativos
  • todos os usuários suspensos;
  • todas as organizações;
  • todos os repositórios.

Você também pode acessar esses relatórios de forma programática pela autenticação HTTP padrão com uma conta de administrador do site. Você deve usar um personal access token com o escopo site_admin. Para obter mais informações, confira "Como criar um personal access token".

Por exemplo, veja abaixo uma forma de baixar o relatório "todos os usuários" com um comando curl:

curl -L -u USERNAME:TOKEN http(s)://HOSTNAME/stafftools/reports/all_users.csv

Para acessar os outros relatórios por meio de programação, substitua all_users por active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

Observação: a solicitação curl inicial retornará uma resposta HTTP 202 se não houver relatórios armazenados em cache disponíveis. Um relatório será gerado em segundo plano. Você pode enviar uma segunda solicitação para baixar o relatório. Você pode usar uma senha ou um token OAuth com o escopo site_admin no lugar de uma senha.

Relatórios de usuário

ChaveDescrição
created_atMomento da criação da conta do usuário (carimbo de data/hora ISO 8601)
idID da conta de usuário ou organização
loginNome de login da conta
emailEndereço de e-mail principal da conta
roleConta de administrador ou usuário regular
suspended?Se a conta foi suspensa
last_logged_ipEndereço IP mais recente a fazer login na conta
reposNúmero de repositórios pertencentes à conta
ssh_keysNúmero de chaves SSH registradas na conta
org_membershipsNúmero de organizações às quais a conta pertence
dormant?Se a conta está inativa
last_activeÚltima vez em que a conta ficou ativa (carimbo de data/hora ISO 8601)
raw_loginInformações brutas de login (formato JSON)
2fa_enabled?Se o usuário habilitou a autenticação de dois fatores

Relatórios da organização

ChaveDescrição
idID da organização
created_atMomento de criação da organização
loginNome de login da organização
emailEndereço de e-mail principal da organização
ownersNúmero de proprietários da organização
membersNúmero de integrantes da organização
teamsNúmero de equipes da organização
reposNúmero de repositórios da organização
2fa_required?Se a organização exige autenticação de dois fatores

Relatórios do repositório

ChaveDescrição
created_atMomento de criação do repositório
owner_idID do proprietário do repositório
owner_typeSe o repositório pertence a um usuário ou organização
owner_nameNome do proprietário do repositório
idID do repositório
nameNome do repositório
visibilitySe o repositório é público ou privado
readable_sizeTamanho do repositório em formato legível por humanos
raw_sizeTamanho do repositório como número
collaboratorsNúmero de colaboradores do repositório
fork?Se o repositório é uma bifurcação
deleted?Se o repositório foi excluído

Indexação

Os recursos de pesquisa do GitHub da plataforma Elasticsearch. Esta seção do painel de administração do site mostra o status atual do seu cluster do Elasticsearch e oferece várias ferramentas para controlar o comportamento de pesquisa e do índice.

Para obter mais informações sobre a pesquisa do código, confira "Como pesquisar informações no GitHub". Para obter informações sobre o Elasticsearch, visite o site do Elasticsearch.

Observação: em uso normal, os administradores do site não precisam criar índices ou agendar trabalhos de reparo. Para solução de problemas ou outras finalidades de suporte, o GitHub Support pode instruir você a executar um trabalho de reparo.

Gerenciamento de índice

GitHub Enterprise Server reconcilia o estado do índice de pesquisa com os dados na instância de maneira automática e regular.

  • Problemas, solicitações de pull, repositórios e usuários no banco de dados
  • Repositórios Git (código-fonte) no disco

Sua instância usa trabalhos de reparo para reconciliar os dados e agenda um trabalho de reparo em segundo plano quando ocorrem os eventos a seguir.

  • Um índice de pesquisa é criado.
  • Dados ausentes precisam ser provisionados.
  • Dados antigos de pesquisa precisam ser atualizados.

Você pode criar um índice ou clicar em um índice existente na lista para gerenciá-lo. É possível executar as operações a seguir em um índice.

  • Torne o índice pesquisável.
  • Torne o índice gravável.
  • Atualize o índice.
  • Excluir o índice
  • Redefina o estado de reparo do índice.
  • Inicie um novo trabalho de reparo de índice.
  • Habilite ou desabilite trabalhos de reparo de índice.

Uma barra de progresso mostra o status atual de um trabalho de reparo em todos os trabalhadores em segundo plano. A barra é a diferença percentual do deslocamento do reparo com o ID de registro mais alto no banco de dados. Você pode ignorar o valor mostrado na barra de progresso após a conclusão de um trabalho de reparo. A barra de progresso mostra a diferença entre o deslocamento de reparo e a ID de registro mais alta no banco de dados, e diminuirá à medida que mais repositórios forem adicionados ao your GitHub Enterprise Server instance, mesmo que esses repositórios estejam realmente indexados.

Para minimizar os efeitos no desempenho de E/S e reduzir as chances de exceder o tempo limite das operações, execute o trabalho de reparo fora dos horários de pico. À medida que o trabalho reconciliar o índice de pesquisa com os dados de banco de dados e repositório Git, uma CPU será usada. Monitore as médias de carga do sistema e o uso da CPU com um utilitário como top. Se você não observar nenhum aumento significativo no consumo de recursos, também deverá ser seguro executar um trabalho de reparo de índice durante o horário de pico.

Os trabalhos de reparo usam um "deslocamento de reparo" a fim de alcançar a paralelização. Trata-se de uma compensação na tabela do banco de dados para o registro a ser reconciliado. Vários trabalhos em segundo plano podem sincronizar tarefas com base nessa compensação.

Pesquisa de código

Esta ação permite habilitar ou desabilitar as operações de pesquisa e índice no código-fonte.

Logins reservados

Certas palavras são reservadas para uso interno em your GitHub Enterprise Server instance, o que significa que essas palavras não podem ser usadas como nomes de usuário.

Por exemplo, as palavras a seguir são reservadas, entre outras:

  • admin
  • enterprise
  • login
  • staff
  • support

Para a lista completa ou palavras reservadas, acesse "Logins reservados" no painel de administração do site.

Advanced Security Committers

Você pode ver o número de commiters ativos que estão atualmente usando estações para o GitHub Advanced Security e pode calcular quantas estações adicionais seriam usadas se você habilitasse o GitHub Advanced Security para mais organizações e repositórios.

Em "Contagem de commiters atualmente ativos", você pode ver o número de commiters ativos em repositórios com o GitHub Advanced Security habilitado. Esse é o número de licenças estações que estão sendo usadas no momento.

Em "Commiters máximos em toda a instância", você pode ver o número de committers ativos em todos os repositórios da sua empresa. Esse é o número de estações que seriam usadas se você habilitasse o GitHub Advanced Security para cada repositório da sua empresa.

Em "Calcular commiters avançados adicionais", você poderá calcular quantas estações adicionais serão usadas se habilitar o GitHub Advanced Security em organizações e repositórios específicos. Em "Organizações e Repositórios", insira ou cole uma lista de organizações e repositórios, com uma organização ou um repositório por linha.

example-org
octo-org/octo-repo

Esse resultado é o número de estações adicionais que seriam usadas se você habilitasse o GitHub Advanced Security para essas organizações e repositórios.

Para obter mais informações sobre cobrança do Advanced Security, confira "Sobre cobrança do Advanced Security".

Todos os usuários

Consulte esta seção do painel de administração do site para gerenciar organizações, pessoas, políticas e configurações.

Repositórios

Esta é uma lista dos repositórios do your GitHub Enterprise Server instance. Você pode clicar no nome de um repositório e acessar suas funções de administração.

todos os usuários

Aqui você pode ver todos os usuários do your GitHub Enterprise Server instance e iniciar uma auditoria de chave SSH.

Administradores do site

Aqui você pode ver todos os administradores do your GitHub Enterprise Server instance e iniciar uma auditoria de chave SSH.

Usuários inativos

Aqui você pode ver e suspender todos os usuários inativos do your GitHub Enterprise Server instance. Uma conta de usuário é considerada inativa quando:

  • Existe há mais tempo do que o limite de inatividade definido para o your GitHub Enterprise Server instance.
  • Não gerou qualquer atividade em seu período de existência;
  • Não é uma conta de administrador do site.

O limite de inatividade é o tempo que um usuário deve ser inativo para ser considerado inativo. O limite padrão de inatividade é de 90 dias, mas você pode personalizar esse limite no your GitHub Enterprise Server instance. Para obter mais informações, confira "Como gerenciar usuários inativos".

Usuários suspensos

Aqui você pode ver todos os usuários que foram suspensos do your GitHub Enterprise Server instance e iniciar uma auditoria de chave SSH.