Aplicar as políticas de gerenciamento do repositório na sua empresa

Sobre políticas para gerenciamento de repositório na sua empresa

Você pode aplicar políticas para controlar como os integrantes da sua empresa em GitHub Enterprise Server gerenciam os repositórios. Você também pode permitir que os proprietários da organização gerenciem as políticas para o gerenciamento do repositório. Para obter mais informações, confira "Criando e gerenciando repositórios" e "Documentação de organizações e equipes".

Configurar a visibilidade padrão de novos repositórios

Toda vez que alguém criar um novo repositório na sua empresa, essa pessoa deverá escolher uma visibilidade para o repositório. Ao configurar uma configuração padrão de visibilidade para a empresa, você escolhe qual visibilidade será selecionada por padrão. Para obter mais informações sobre a visibilidade do repositório, confira "Sobre repositórios".

Se um proprietário corporativo impedir que os integrantes criem certos tipos de repositórios, os integrantes não serão capazes de criar esse tipo de repositório, mesmo se a configuração de visibilidade for o padrão para esse tipo. Para obter mais informações, confira "Como impor uma política para criação de repositório".

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Default repository visibility" (Visibilidade padrão do repositório), clique no menu suspenso e selecione uma visibilidade padrão.

   Aviso: se você adicionar um anexo de imagem de um comentário sobre um problema ou uma solicitação de pull, qualquer pessoa poderá ver a URL de imagem anônima sem autenticação, mesmo que a solicitação de pull esteja em um repositório privado ou se o modo privado estiver habilitado. Para impedir o acesso não autorizado às imagens, certifique-se de restringir o acesso à rede aos sistemas que servem as imagens, incluindo o sua instância do GitHub Enterprise Server.

Exigir a política com base nas permissões do repositório

Em todas as organizações pertencentes à sua empresa, é possível definir um nível de permissão de base do repositório (nenhum, leitura, gravação ou administrativo) para integrantes da organização ou permitir que os proprietários administrem a configuração no nível da organização.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Permissões de base", revise as informações sobre como alterar a configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Permissões de base", selecione o menu suspenso e clique em uma política.

Aplicando uma política para a criação do repositório

Em todas as organizações pertencentes à sua empresa, é possível permitir que os integrantes criem repositórios, restringir a criação de repositórios a proprietários da organização ou permitir que os proprietários administrem a configuração no nível da organização.

Se você permitir que os membros criem repositórios em suas organizações, você poderá escolher quais tipos de repositórios (públicos, privados e internos) que os membros podem criar.

Você também poderá impedir que os usuários criem repositórios pertencentes às próprias contas de usuário deles.

Para obter mais informações sobre os repositórios internos, confira "Criar um repositório".

Os proprietários da organização sempre podem criar qualquer tipo de repositório e os colaboradores externos nunca podem criar qualquer tipo de repositório. Para obter mais informações, confira "Sobre repositórios".

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Repository creation" (Criação de repositório), revise as informações sobre como alterar a configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Repository creation" (Criação de repositório), selecione uma política.

6. Se você tiver marcado Integrantes podem criar repositórios, selecione um ou mais tipos de repositório.

7. Opcionalmente, para impedir que membros corporativos criem repositórios pertencentes às respectivas contas de usuário, selecione Bloquear a criação de repositórios de namespace do usuário.

Aplicar uma política para a bifurcação de repositórios internos ou privados

Em todas as organizações pertencentes à sua empresa, é possível permitir que pessoas com acesso a um repositório privado o bifurquem, nunca permitir a bifurcação de repositórios privados ou permitir que os proprietários administrem a configuração no nível da organização.

Pessoas com permissões de administrador podem definir uma política de bifurcação mais granular. Para obter mais informações, confira "Gerenciar a política de bifurcação da sua organização".

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Bifurcação de repositório", revise as informações sobre como alterar a configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Bifurcação de repositório", selecione o menu suspenso e clique em uma política.

6. Se a criação de fork estiver habilitada, selecione uma política para o local em que os usuários têm permissão para criar fork de repositórios.

Aplicando uma política para convidar externos para repositórios

Em todas as organizações pertencentes à sua empresa, você pode permitir que os membros convidem externos para repositórios, restringir externos aos proprietários da organização, restringir externos aos proprietários da organização, ou permitir que os proprietários da organização administrem a configuração no nível da organização.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Repositório convites", revise as informações sobre a alteração da configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Convites do repositório", selecione o menu suspenso e clique em uma política.

Aplicando uma política para o nome padrão do branch

Em todas as organizações pertencentes à sua empresa, você pode definir o nome padrão da branch para quaisquer novos repositórios que os integrantes criarem. Você pode optar por aplicar esse nome do branch-padrão em todas as organizações ou permitir que as organizações individuais definam um nome diferente.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Nome do branch padrão", insira o nome do branch padrão que deve ser usado pelos novos repositórios.

5. Opcionalmente, para impor o nome do branch padrão a todas as organizações da empresa, selecione Impor em toda a empresa.

6. Clique em Atualizar.

Aplicando uma política de alterações à visibilidade do repositório

Em todas as organizações pertencentes à sua empresa, é possível permitir que integrantes com acesso administrativo alterem a visibilidade de um repositório, restringir alterações na visibilidade do repositório a proprietários da organização ou permitir que os proprietários administrem a configuração no nível da organização. Quando você impede que os integrantes alterem a visibilidade do repositório, somente os proprietários corporativos podem alterar a visibilidade de um repositório.

Se um proprietário corporativo tiver restringido a criação de repositório apenas para os proprietários da organização, os integrantes não poderão alterar a visibilidade do repositório. Se um proprietário corporativo restringir a criação do repositório de integrantes apenas para repositórios privados, os integrantes só poderão alterar a visibilidade de um repositório para privado. Para obter mais informações, confira "Como impor uma política para criação de repositório".

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Repository visibility change" (Alteração da visibilidade do repositório), revise as informações sobre a alteração da configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Alteração de visibilidade do repositório", selecione o menu suspenso e clique em uma política.

Aplicando uma política de exclusão e transferência de repositório

Em todas as organizações pertencentes à sua empresa, é possível permitir que integrantes com permissões administrativas excluam ou transfiram um repositório, restringir exclusões e transferências de repositórios a proprietários da organização ou permitir que os proprietários administrem a configuração no nível da organização.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em " Políticas", clique em Repositórios.

4. Em "Repository deletion and transfer" (Exclusão e transferência de repositórios), revise as informações sobre como alterar as configurações. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

5. Em "Exclusão e transferência do repositório", selecione o menu suspenso e clique em uma política.

Aplicando uma política para excluir problemas

Em todas as organizações pertencentes à sua empresa, é possível permitir que integrantes com acesso administrativo excluam problemas em um repositório, restringir a exclusão de problemas a proprietários da organização ou permitir que os proprietários administrem a configuração no nível da organização.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Na guia Políticas do repositório, em "Exclusão de problemas do repositório", revise as informações sobre como alterar a configuração. Opcionalmente, para ver a configuração atual de todas as organizações na conta corporativa antes de alterar a configuração, clique em Exibir as configurações atuais das suas organizações.

   

4. Em "Exclusão de problemas do repositório", selecione o menu suspenso e clique em uma política.

Aplicando uma política para limites de push do Git

Para manter o tamanho do repositório gerenciável e evitar problemas de desempenho, você pode configurar um limite de tamanho de arquivo para os repositórios na sua empresa.

Por padrão, quando você impõe os limites de upload do repositório, as pessoas não podem adicionar ou atualizar arquivos maiores que 100 MB.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Repository upload limit" (Limite de upload de repositório), use o menu suspenso e clique para definir o tamanho máximo do objeto.

5. Opcionalmente, para aplicar um limite máximo de upload para todos os repositórios na sua empresa, selecione Impor em todos os repositórios

   

Como impor uma política para a exibição de nomes de membros em seus repositórios

Em todas as organizações pertencentes à sua empresa, você pode permitir que os membros vejam o nome de perfil de um autor de comentário, além do nome de usuário dessa pessoa, em problemas e solicitações de pull para repositórios públicos e internos.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Permitir que os membros vejam o nome de perfil do autor do comentário em repositórios públicos e internos", selecione o menu suspenso e clique em uma política.

5. Opcionalmente, para impor a exibição de nomes de perfil para todos os repositórios em sua empresa, selecione Impor para todos os repositórios na instância.

   

Configurar o editor de conflitos de merge para pull requests entre repositórios

Solicitar que os usuário resolvam conflitos de merge em seus respectivos computadores pode impedir gravações inadvertidas em repositórios upstream a partir de uma bifurcação.

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Editor de conflitos para solicitações de pull entre repositórios", use o menu suspenso e clique em Desabilitado.

Configurar pushes forçados

Cada repositório herda uma configuração de push forçado padrão das configurações da conta de usuário ou organização proprietária do repositório. Cada conta de organização e usuário herda uma configuração padrão de push forçado a partir da configuração de push forçado para a empresa. Se você alterar a configuração de push forçado para a empresa, a política irá aplicar-se a todos os repositórios pertencentes a qualquer usuário ou organização.

Bloqueando pushes forçado para todos os repositórios

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Pushes forçados", selecione o menu suspenso e clique em Permitir, Bloquear ou Bloquear no branch padrão.

5. Opcionalmente, para substituir as configurações de nível da organização e do repositório de pushes forçados, selecione Impor em todos os repositórios.

Bloquear pushes forçados para um repositório específico

1. Entre no sua instância do GitHub Enterprise Server em http(s)://HOSTNAME/login.
2. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
3. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
4. Em "Pesquisar usuários, organizações, equipes, repositórios, gists e aplicativos", digite o nome do repositório no campo de texto. Em seguida, à direita do campo, clique em Pesquisar.
5. Em "Resultados da pesquisa – Repositórios", clique no nome do repositório.
6. No canto superior direito da página, clique em Administrador.
7. Em "Push e Pull", à direita de "Pushes forçados", selecione o menu suspenso e clique em Bloquear ou Bloquear no branch padrão.

Bloquear pushes forçados em repositórios pertencentes a uma organização ou conta de usuário

Os repositórios herdam as configurações de push forçado da conta do usuário ou da organização à qual pertencem. As contas de usuários e organizações herdam as configurações de push forçado a partir das configurações de push forçado para a empresa.

Você pode substituir as configurações padrão herdadas definindo as configurações da conta de usuário ou da organização.

1. Entre no sua instância do GitHub Enterprise Server em http(s)://HOSTNAME/login.

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

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

4. Em "Pesquisar usuários, organizações, equipes, repositórios, gists e aplicativos", digite o nome do usuário ou da organização no campo de texto. Em seguida, à direita do campo, clique em Pesquisar.

5. Nos resultados da pesquisa, clique no nome do usuário ou organização.

6. No canto superior direito da página, clique em Administrador.

7. Em "Configurações padrão do repositório" na seção "Pushes forçados", selecione uma política.

   • Para bloquear os pushes forçados em todos os branches, escolha Bloquear.
   • Para bloquear os pushes forçados apenas no branch padrão, escolha Bloquear no branch padrão.

8. Opcionalmente, para substituir as configurações específicas do repositório, selecione Impor em todos os repositórios. Observe que isso não substituirá uma política de toda a empresa.

   

Configurar o acesso de leitura anônimo do Git

Se você tiver o modo privado habilitado para sua instância do GitHub Enterprise Server, você pode permitir que os administradores do repositório habilitem o acesso de leitura Git anônimo a repositórios públicos.

Habilitar o acesso de leitura anônimo do Git permite que os usuários ignorem a autenticação para ferramentas personalizadas na sua empresa. Quando você ou um administrador do repositório habilitar essa configuração de acesso em um repositório, as operações não autenticadas do Git (e qualquer pessoa com acesso de rede ao GitHub Enterprise Server) terão acesso de leitura sem autenticação ao repositório.

O acesso de leitura anônimo do Git está desabilitado por padrão.

Se necessário, você pode impedir que os administradores do repositório alterem configurações anônimas de acesso do Git para repositórios, bloqueando as configurações de acesso do repositório. Após o bloqueio, somente um administrador de site poderá alterar a configuração do acesso de leitura anônimo do Git.

Para ver os repositórios com acesso de leitura Git anônimo habilitado, filtre a lista de repositórios no painel do administrador do site.

Definir o acesso de leitura anônimo do Git para todos os repositórios

1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

   

2. Na barra lateral da empresa, clique em Políticas.

3. Em Políticas, clique em Opções.

4. Em "Acesso de leitura anônimo do Git", use o menu suspenso e clique em Habilitado.

5. Opcionalmente, para impedir que os administradores do repositório alterem as configurações de acesso de leitura anônimo do Git em todos os repositórios da sua empresa, selecione Impedir que os administradores do repositório alterem o acesso de leitura anônimo do Git.

Definir acesso de leitura anônimo do Git para um repositório específico

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. Em "Pesquisar usuários, organizações, equipes, repositórios, gists e aplicativos", digite o nome do repositório no campo de texto. Em seguida, à direita do campo, clique em Pesquisar.

4. Em "Resultados da pesquisa – Repositórios", clique no nome do repositório.

5. No canto superior direito da página, clique em Administrador.

6. Em "Zona de Perigo", ao lado de "Habilitar Acesso de leitura anônimo do Git", clique em Habilitar.

   

7. Revise as alterações. Para confirmar isso, clique em Sim, permitir acesso de leitura anônimo ao Git.

8. Opcionalmente, para impedir que os administradores do repositório alterem a configuração desse repositório, selecione Impedir que os administradores do repositório desabilitem o acesso de leitura anônimo do Git.