Este guia abordará a instalação, a configuração e o gerenciamento do sua instância do GitHub Enterprise Server como um administrador de empresa.
O GitHub oferece duas maneiras de implantar o GitHub Enterprise.
- GitHub Enterprise Cloud
-
**GitHub Enterprise Server**
GitHub hospeda GitHub Enterprise Cloud. Você pode implantar e hospedar GitHub Enterprise Server no seu próprio centro de dados ou em um provedor da nuvem compatível.
Para obter mais informações sobre o GitHub Enterprise Server, confira Sobre o GitHub Enterprise Server.
Parte 1: Instalar GitHub Enterprise Server
Para começar, você deverá criar a conta corporativa, instalar a instância, usar o Console de Gerenciamento para a configuração inicial, configurar a sua instância e gerenciar a cobrança.
1. Como criar sua conta corporativa
Antes de instalar o GitHub Enterprise Server, você pode criar uma conta corporativa no GitHub.com entrando em contato com a equipe de vendas do GitHub. Uma conta corporativa em GitHub.com é útil para a cobrança e para recursos compartilhados com o GitHub.com via GitHub Connect. Para saber mais, confira Contas empresariais.
2. Instalar o GitHub Enterprise Server
Para começar, você precisará instalar o dispositivo em uma plataforma de virtualização de sua escolha. Para saber mais, confira Configurando uma instância do GitHub Enterprise Server.
3. Como usar o Console de Gerenciamento
Ao iniciar o Console de Gerenciamento pela primeira vez, você usará o sua instância do GitHub Enterprise Server para percorrer o processo de configuração inicial. Você também pode usar o Console de Gerenciamento para gerenciar configurações de instância, como licença, domínio, autenticação e TLS. Para saber mais, confira Administrar sua instância por meio da interface do usuário da Web.
4. Configurar o sua instância do GitHub Enterprise Server
Além do Console de Gerenciamento, é possível usar o painel de administração de site e o SSH (shell administrativo) para gerenciar o sua instância do GitHub Enterprise Server. Por exemplo, você pode configurar aplicativos e limites de taxa, ver relatórios, usar utilitários de linha de comando. Para saber mais, confira Configurando GitHub Enterprise.
Você pode usar as configurações de rede padrão usadas pelo GitHub Enterprise Server por meio do protocolo DHCP ou você também pode definir as configurações de rede usando o console da máquina virtual. Você também pode configurar um servidor proxy ou regras de firewall. Para saber mais, confira Definindo as configurações de rede.
5. Como configurar a alta disponibilidade
É possível configurar o sua instância do GitHub Enterprise Server para alta disponibilidade a fim de minimizar o impacto de falhas de hardware e interrupções de rede. Para saber mais, confira Como configurar a alta disponibilidade.
6. Como configurar uma instância de preparo
É possível configurar uma instância de preparo para testar modificações, planejar a recuperação de desastre e testar atualizações antes de aplicá-las ao sua instância do GitHub Enterprise Server. Para saber mais, confira Configurar uma instância de testes.
7. Como designar backups e recuperação de desastre
Para proteger seus dados de produção, você pode configurar backups automatizados do sua instância do GitHub Enterprise Server com o GitHub Enterprise Server Backup Utilities. Para saber mais, confira Como configurar backups em sua instância usando Utilitários de Backup.
8. Como gerenciar a cobrança para sua empresa
A cobrança de todas as organizações e instâncias GitHub Enterprise Server conectadas à sua conta empresarial é agregada em uma única cobrança para todos os seus serviços pagos GitHub.com. Proprietários corporativos e gerentes de cobrança podem acessar e gerenciar as configurações de cobrança relativas a contas corporativas. Para saber mais, confira Cobrança do GitHub Enterprise.
Parte 2: Organização e gerenciamento da sua equipe
Como proprietário corporativo ou administrador, você pode gerenciar configurações em níveis de usuário, repositório, equipe e organização. É possível gerenciar os integrantes da sua empresa, criar e gerenciar organizações, definir políticas para a gestão do repositório e criar e gerenciar as equipes.
1. Gerenciar os membros do sua instância do GitHub Enterprise Server
É possível gerenciar as configurações e a atividade de auditoria dos membros do sua instância do GitHub Enterprise Server. Você pode promover um membro da empresa para ser um administrador do site, gerenciar usuários inativos, ver o log de auditoria para a atividade do usuário e personalizar as mensagens que serão vistas pelos membros da empresa. Para saber mais, confira Gerenciar usuários na sua empresa.
2. Como criar organizações
É possível criar organizações no sua instância do GitHub Enterprise Server para refletir a estrutura da sua empresa ou grupo. Para saber mais, confira Criar uma organização do início.
3. Como adicionar membros a organizações
É possível adicionar membros a organizações no sua instância do GitHub Enterprise Server desde que você seja proprietário das organizações que deseja gerenciar. Você também pode configurar a visibilidade da associação à organização. Para saber mais, confira Adicionar pessoas à organização e Configurar a visibilidade dos integrantes da organização.
4. Como criar equipes
Equipes são grupos de membros da organização que podem receber permissões em repositórios específicos como um grupo. Você pode criar equipes individuais ou vários níveis de equipes aninhadas em cada uma das suas organizações. Para saber mais, confira Como criar uma equipe da organização e Adicionar integrantes da organização a uma equipe.
5. Como definir níveis de permissões para a organização e para o repositório
Recomendamos fornecer uma função de proprietário da organização a um número limitado de membros em cada organização, que fornece acesso administrativo completo para essa organização. Para saber mais, confira Funções em uma organização.
Para as organizações em que você tem permissões de administrador, você também pode personalizar o acesso a cada repositório com níveis de permissão granulares. Para saber mais, confira Funções de repositório para uma organização.
6. Como impor políticas de gerenciamento do repositório
Como proprietário de uma empresa, você pode definir políticas de gerenciamento de repositório para todas as organizações do sua instância do GitHub Enterprise Server ou permitir que as políticas sejam definidas separadamente em cada organização. Para saber mais, confira Aplicar as políticas de gerenciamento do repositório na sua empresa.
7. Criar um README para a empresa
Para ajudar as pessoas a entender o que está acontecendo em sua empresa, você deve criar um LEIAME. Por exemplo, é possível usar um LEIAME para ajudar os membros a aprender sobre diferentes organizações na empresa, para compartilhar links para recursos importantes ou para comunicar informações sobre as configurações e políticas da sua empresa. Para obter mais informações, consulte Criar um README para uma organização.
Parte 3: Criando com segurança
Para aumentar a segurança do sua instância do GitHub Enterprise Server, configure a autenticação de membros corporativos, use ferramentas e o registro em log de auditoria para manter a conformidade, defina recursos de segurança e análise para suas organizações e, opcionalmente, habilite recursos do GitHub Advanced Security.
1. Como autenticar os membros da empresa
Você pode usar o método de autenticação interno do GitHub Enterprise Server ou escolher entre um provedor de autenticação externo, como CAS, LDAP ou SAML, para integrar as contas existentes e gerenciar centralmente o acesso dos usuários ao sua instância do GitHub Enterprise Server. Para saber mais, confira Conceitos básicos de gerenciamento de identidade e acesso.
Você também pode exigir autenticação de dois fatores para cada uma de suas organizações. Para saber mais, confira Exigir autenticação de dois fatores na organização.
2. Como manter a conformidade
Você pode implementar verificações de status necessárias e realizar verificações de commit para fazer cumprir os padrões de conformidade da sua organização e automatizar os fluxos de trabalho de conformidade. Você também pode usar o log de auditoria para sua organização revisar as ações executadas pela sua equipe. Para saber mais, confira Aplicar política com hooks pre-receive e Log de auditoria para uma empresa.
3. Como configurar os recursos de segurança para suas organizações
Para manter as organizações em sua instância do GitHub Enterprise Server seguras, você pode usar uma variedade de recursos de segurança, incluindo políticas de segurança GitHub, grafos de dependência, varredura de segredos e atualizações de segurança e de versão do Dependabot. Para obter mais informações, consulte Configurando recursos de segurança em sua organização.
4. Habilitar recursos do GitHub Advanced Security
Você pode atualizar a licença do GitHub Enterprise Server para incluir GitHub Code Security ou GitHub Secret Protection. A atualização fornecerá funcionalidades extras que ajudarão os usuários a encontrar e corrigir problemas de segurança no seu código como, por exemplo, verificação de código e segredo. Para saber mais, confira Habilitando GitHub Advanced Securityprodutos para sua empresa.
Parte 4: personalizar e automatizar o trabalho da sua empresa no GitHub
Você pode personalizar e automatizar o trabalho nas organizações da sua empresa com GitHub e OAuth apps, GitHub Enterprise Server API, GitHub Actions, GitHub Packages e GitHub Pages.
1. Como criar GitHub Apps e OAuth apps
Você pode criar integrações com a API do GitHub Enterprise Server, como, por exemplo, GitHub Apps ou OAuth apps, para usar em organizações da sua empresa para complementar e ampliar seus fluxos de trabalho. Para saber mais, confira Sobre a criação de aplicativos GitHub.
2. Usando a API do GitHub Enterprise Server
Há duas versões da API do GitHub: a API REST e a API do GraphQL. Você pode usar as APIs do GitHub para automatizar tarefas comuns, fazer backup dos seus dados ou criar integrações que estendem o GitHub. Para saber mais, confira Comparando a API REST do GitHub e a API do GraphQL.
3. Como criar GitHub Actions
Com o GitHub Actions, você pode automatizar e personalizar o fluxo de trabalho de desenvolvimento da sua empresa no GitHub. Você pode criar suas ações, além de usar e personalizar ações compartilhadas pela comunidade do GitHub. Para saber mais, confira Escrevendo fluxos de trabalho.
Para saber mais sobre como habilitar e configurar GitHub Actions no GitHub Enterprise Server, confira Introdução ao GitHub Actions do GitHub Enterprise Server.
4. Como publicar e gerenciar GitHub Packages
GitHub Packages é um serviço de hospedagem de pacotes de software que permite que você hospede os seus pacotes de software de forma privada ou pública e que você use os pacotes como dependências nos seus projetos. Para saber mais, confira Introdução ao GitHub Packages.
Para saber mais sobre como habilitar e configurar o GitHub Packages para sua instância do GitHub Enterprise Server, confira Introdução aos pacotes de GitHub para sua empresa.
5. Como usar o GitHub Pages
O GitHub Pages é um serviço de hospedagem de site estático que usa arquivos HTML, CSS e JavaScript diretamente de um repositório e publica um site. Você pode habilitar ou desabilitar o GitHub Pages para os membros corporativos no nível da organização. Para saber mais, confira Configurando páginas de GitHub para sua empresa e O que é GitHub Pages?.
Parte 5: Conexão com outros recursos do GitHub
Você pode usar GitHub Connect para compartilhar recursos.
Se você for o proprietário de uma instância do GitHub Enterprise Server ou de uma organização ou conta corporativa GitHub Enterprise Cloud, você poderá habilitar o GitHub Connect. O GitHub Connect permite compartilhar fluxos de trabalho e recursos específicos entre o sua instância do GitHub Enterprise Server e o GitHub Enterprise Cloud, como contribuições e pesquisas unificadas. Para saber mais, confira Habilitando o GitHub Connect para GitHub.com.
Parte 6: usar recursos de aprendizado e suporte do GitHub
Os membros da sua empresa podem aprender mais sobre o Git e o GitHub com nossos recursos de aprendizado e você pode obter o suporte necessário ao configurar e gerenciar o sua instância do GitHub Enterprise Server com o Suporte empresarial do GitHub.
1. Leitura sobre o GitHub Enterprise Server no GitHub Docs
Você pode ler a documentação que reflete as funcionalidades disponíveis com GitHub Enterprise Server. Para saber mais, confira Sobre versões do GitHub Docs.
Para saber como sua empresa pode usar o GitHub com mais eficiência, confira Práticas recomendadas para organizar o trabalho em sua empresa.
2. Aprendizagem com o GitHub Skills
Os membros da sua empresa podem aprender novas habilidades realizando projetos divertidos e realistas em um repositório próprio do GitHub com o GitHub Skills. Cada curso é uma lição prática criada pela comunidade do GitHub e ensinada por um bot amigável.
Para saber mais, confira Recursos de aprendizagem do Git e do GitHub.
Colaborando com o Suporte Empresarial do GitHub
O GitHub Enterprise inclui o acesso ao Suporte do GitHub Enterprise. O Suporte do GitHub Enterprise pode ajudar você a solucionar problemas. Você também pode optar por se inscrever no Suporte Premium do GitHub para ter recursos adicionais. Para obter mais informações, confira Sobre GitHub suporte.