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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2020-05-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Versão do artigo: Enterprise Server 2.17

Painel de administração do site

O painel de administração do site mostra uma série de ferramentas que ajudam no gerenciamento da sua instância do GitHub Enterprise Server.

Neste artigo

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

Informações de licença e pesquisa

Consulte esta seção do painel de administração do site para verificar sua licença atual do GitHub Enterprise, pesquisar usuários e repositórios e consultar o log de auditoria.

Console de gerenciamento

Neste espaço, é possível iniciar o Console de gerenciamento 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 intervalos diários, semanais e mensais para repositórios e desenvolvedores. Veja qual foi a última vez que os dados ficaram em cache e organize em fila os trabalhos de cálculo de tendências na seção Explorar.

Log de auditoria

O GitHub Enterprise mantém um log de execução das ações auditadas, e essas informações ficam disponíveis para consulta.

Por padrão, o log de auditoria mostra uma lista de todas as ações auditadas em ordem cronológica inversa. Você pode filtrar essa lista inserindo pares chave-valor na caixa de texto Query (Consulta) e clicando em Search (Pesquisar), conforme a explicação em "Pesquisar no log de auditoria".

Para obter mais informações gerais sobre logs de auditoria, consulte "Gerar logs de auditoria". Para ver a lista completa de ações auditadas, consulte "Ações auditadas".

Relatórios

Para obter informações sobre usuários, organizações e repositórios da sua instância do GitHub Enterprise Server, você normalmente faria fetch de dados JSON na 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 Reports (Relatórios) como alternativa, facilitando o download de relatórios CSV com a maioria das informações necessárias 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 no último mês;
  • todos os usuários inativos por um mês (ou mais);
  • 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. You must use a personal access token with the site_admin scope. Para obter mais informações, consulte "Criar um token de acesso pessoal para a linha de comando".

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

curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv

Para acessar os outros relatórios de forma programática, substitua all_users por active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

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

Relatórios de usuário

TeclaDescriçã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
e-mailEndereço de e-mail principal da conta
funçãoConta 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

TeclaDescrição
idID da organização
created_atMomento de criação da organização
loginNome de login da organização
e-mailEndereç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

TeclaDescriçã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
visibilidadeSe 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

Índices

Os recursos de pesquisa de códigos do GitHub têm tecnologia ElasticSearch. Esta seção do painel de administração do site mostra o status atual do cluster do ElasticSearch e oferece várias ferramentas para controlar o comportamento de pesquisa e geração de índices. Essas ferramentas se dividem em três categorias:

Pesquisa de código

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

Reparo de índice de pesquisa de códigos

Esta categoria controla a forma como ocorre o reparo do índice de pesquisa de códigos. Você pode:

  • habilitar ou desabilitar trabalhos de reparo de índice;
  • iniciar um novo trabalho de reparo de índice;
  • redefinir o estado de todo o reparo de índice.

O GitHub Enterprise usa trabalhos de reparo para reconciliar o estado do índice de pesquisa com dados armazenados em bancos de dados (problemas, pull requests, repositórios e usuários) e dados armazenados em repositórios do Git (código-fonte). Isso acontece quando:

  • um novo índice de pesquisa é criado;
  • dados ausentes precisam ser aterrados; ou
  • dados antigos de pesquisa precisam ser atualizados.

Em outras palavras, os trabalhos de reparo são iniciados conforme necessário e executados em segundo plano. Esses trabalhos não são programados pelos administradores do site.

Além disso, trabalhos de reparo usam uma "compensação de reparo" para 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.

Uma barra de progresso mostra o status atual de um trabalho de reparo em todos os trabalhadores relacionados em segundo plano. Trata-se da diferença percentual da compensação do reparo com o ID de registro mais alto no banco de dados. Não se preocupe com o valor mostrado na barra de progresso após a conclusão de um trabalho de reparo; ele mostra a diferença entre a compensação do reparo e o ID de registro mais alto no banco de dados, e diminuirá à medida que mais repositórios forem adicionados à sua instância do GitHub Enterprise Server, mesmo que esses repositórios estejam indexados no momento.

Você pode iniciar um novo trabalho de reparo do índice de pesquisa de código a qualquer momento. Ele usará uma única CPU, pois reconcilia o índice de pesquisa com os dados do banco de dados e do repositório Git. Para minimizar os efeitos no desempenho de E/S e reduzir as chances de tempo limite das operações, tente fazer um trabalho de reparo fora dos horários de pico. Monitore as médias de carga do sistema e o uso da CPU usando um utilitário como top. Se você notar que não houve alterações significativas, isso indica que provavelmente será seguro fazer um trabalho de reparo de índice nos horários de pico.

Reparo de índice de problemas

Esta categoria controla a forma como o índice Problemas é reparado. Você pode:

  • habilitar ou desabilitar trabalhos de reparo de índice;
  • iniciar um novo trabalho de reparo de índice;
  • redefinir o estado de todo o reparo de índice.

Repositórios

Este espaço lista os repositórios da sua instância do GitHub Enterprise Server. Você pode clicar no nome de um repositório e acessar suas funções de administração.

Todos os usuários

Aqui você verá todos os usuários da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.

Administradores do site

Aqui você verá todos os administradores da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.

Usuários inativos

Aqui você pode ver e suspender todos os usuários inativos da sua instância do GitHub Enterprise Server. Uma conta de usuário é considerada inativa quando:

  • Seu tempo de existência supera o limite de inatividade configurado na sua instância do GitHub Enterprise Server;
  • Não gerou qualquer atividade em seu período de existência;
  • Não é uma conta de administrador do site.

The dormancy threshold is the length of time a user must be inactive to be considered dormant. The default dormancy threshold is 90 days, however you can customize the dormancy threshold for sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Gerenciar usuários inativos".

Usuários suspensos

Aqui você verá todos os usuários que foram suspensos da sua instância do GitHub Enterprise Server e poderá iniciar uma auditoria de chave SSH.

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato