Esta versão do GitHub Enterprise foi descontinuada em 2021-09-23. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Introdução ao GitHub Enterprise Server

Comece a configurar e gerenciar sua instância do GitHub Enterprise Server.

Este guia irá ajudar você a configurar e gerenciar sua instância do GitHub Enterprise Server como administrador da empresa.

GitHub oferece duas maneiras de implantar 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 uma visão geral de como GitHub Enterprise Server funciona, consulte "Visão geral do sistema".

Parte 1: Instalar GitHub Enterprise Server

Para começar com GitHub Enterprise Server, você deverá criar a conta corporativa, instalar a instância, usar o Console de Gerenciamento para configuração inicial, configurar a sua instância e gerenciar a cobrança.

1. Criando a sua conta corporativa

Antes de instalar GitHub Enterprise Server, você pode criar uma conta corporativa em GitHub.com entrando em contato com a equipe de vendas de GitHub. Uma conta corporativa em GitHub.com é útil para a cobrança e para recursos compartilhados com o GitHub.com via GitHub Connect. Para obter mais informações, consulte "Sobre contas corporativas".

2. Instalar o GitHub Enterprise Server

Para começar com GitHub Enterprise Server, você deverá instalar o dispositivo em uma plataforma de virtualização de sua escolha. Para obter mais informações, consulte "Configurar instância do GitHub Enterprise Server".

3. Usando o Console de Gerenciamento

Você usará o Console de Gerenciamento para apresentar o processo de configuração inicial ao iniciar sua instância do GitHub Enterprise Server. 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 obter mais informações, consulte "Acessando o console de gerenciamento".

4. Configurar o sua instância do GitHub Enterprise Server;

Além do console de gerenciamento, você pode usar o painel de administração do site e o shell administrativo (SSH) para gerenciar 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 obter mais informações, consulte "Configurando sua empresa".

Você pode usar as configurações de rede padrão usadas por GitHub Enterprise Server por meio do protocolo de configuração do host dinâmico (DHCP) ou você também pode definir as configurações de rede usando o console de máquina virtual. Você também pode configurar um servidor proxy ou regras de firewall. Para obter mais informações, consulte "Definindo as configurações de rede".

5. Configurar alta disponibilidade

Você pode configurar sua instância do GitHub Enterprise Server para alta disponibilidade a fim de minimizar o impacto de falhas de hardware e falhas de rede. Para obter mais informações, consulte "Configurando alta disponibilidade".

6. Configurar uma instância de preparo

Você pode configurar uma instância de preparo para testar modificações, planejar a recuperação de desastres e testar atualizações antes de aplicá-las a sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Configurar instância de preparo".

7. Designando backups e recuperação de desastres

Para proteger seus dados de produção, você pode configurar backups automatizados de sua instância do GitHub Enterprise Server com GitHub Enterprise Server Backup Utilities. Para obter mais informações, consulte "Configurar backups no appliance".

8. Gerenciar a cobrança para a sua empresa

A cobrança para todas as organizações e instâncias de GitHub Enterprise Server conectadas à sua conta corporativa é agregada em uma única taxa de cobrança para todos os seus serviços pagos de 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 obter mais informações, consulte "Gerenciando a cobrança da sua empresa".

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. Gerenciando integrantes de sua instância do GitHub Enterprise Server

You can manage settings and audit activity for the members of sua instância do GitHub Enterprise Server. You can promote an enterprise member to be a site administrator, manage dormant users, view the audit log for user activity, and customize messages that enterprise members will see. For more information, see "Managing users in your enterprise."

2. Criar organizações

You can create new organizations in sua instância do GitHub Enterprise Server to reflect your company or group's structure. Para obter mais informações, consulte "Criar uma nova organização do zero".

3. Adicionando integrantes a organizações

You can add members to organizations in sua instância do GitHub Enterprise Server as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see "Adding people to your organization" and "Configuring visibility for organization membership."

4. Criar equipes

Teams are groups of organization members that can be granted permissions to specific repositories as a group. You can create individual teams or multiple levels of nested teams in each of your organizations. For more information, see "Creating teams" and "Adding people to teams."

5. Definindo níveis de permissões para a organização e para o repositório

We recommend giving a limited number of members in each organization an organization owner role, which provides complete administrative access for that organization. Para obter mais informações, consulte "Níveis de permissão para uma organização".

For organizations where you have admin permissions, you can also customize access to each repository with granular permission levels. For more information, see "Repository permissions levels for an organization."

6. Aplicando políticas de gerenciamento do repositório

As an enterprise owner, you can set repository management policies for all organizations in sua instância do GitHub Enterprise Server, or allow policies to be set separately in each organization. Para obter mais informações, consulte "Aplicar políticas de gerenciamento do repositório na sua empresa".

Parte 3: Criando com segurança

Para aumentar a segurança de sua instância do GitHub Enterprise Server, você pode configurar a autenticação para integrantes da empresa, usar ferramentas e registro de auditoria para manter a conformidade, configurar recursos de segurança e análise para as suas organizações e, opcionalmente, habilitar Segurança Avançada GitHub.

1. Efetuando a autenticação dos integrantes da empresa

Você pode usar o método de autenticação interno do GitHub Enterprise Server ou você pode escolher entre um provedor de autenticação estabelecido como o CAS, LDAP, ou SAML, para integrar suas contas existentes e gerenciar centralmente o acesso do usuário a sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Autenticando usuários para sua instância do GitHub Enterprise Server".

Você também pode exigir autenticação de dois fatores para cada uma de suas organizações. Para obter mais informações, consulte "Exigindo a autenticação de dois fatores para uma organização".

2. 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 obter mais informações, consulte "Aplicando a política com hooks pre-receive" e "Log de auditoria".

3. Habilitar funcionalidades de Segurança Avançada GitHub

Você pode atualizar sua licença do GitHub Enterprise Server para incluir Segurança Avançada GitHub. Isso fornece funcionalidades extras que ajudam os usuários a encontrar e corrigir problemas de segurança no seu código como, por exemplo, digitalização de código e segredo. Para obter mais informações, consulte "Segurança Avançada GitHub para a sua empresa "".

Parte 4: Personalizando e automatizando o trabalho da sua empresa em GitHub

Você pode personalizar e automatizar o trabalho em organizações da sua empresa com GitHub e Aplicativos OAuth, GitHub API, GitHub Actions, GitHub Package Registry e GitHub Pages.

1. Criando Aplicativos do GitHub e Aplicativos OAuth

Você pode criar integrações com a API do GitHub, como, por exemplo, Aplicativos do GitHub ou Aplicativos OAuth, para usar em organizações da sua empresa para complementar e ampliar seus fluxos de trabalho. Para obter mais informações, consulte "Sobre os aplicativos".

2. Usando a API de GitHub

There are two versions of the GitHub API: the REST API and the GraphQL API. You can use the GitHub APIs to automate common tasks, back up your data, or create integrations that extend GitHub Enterprise Server. For more information, see "About GitHub's APIs."

3. Criando GitHub Actions

With GitHub Actions, you can automate and customize sua instância do GitHub Enterprise Server's development workflow on GitHub Enterprise Server. Você pode criar as suas próprias ações e usar e personalizar ações compartilhadas pela comunidade GitHub. Para obter mais informações, consulte "Aprenda GitHub Actions".

Para obter mais informações sobre como ativar e configurar GitHub Actions em GitHub Enterprise Server, consulte "Primeiros passos com GitHub Actions para GitHub Enterprise Server".

4. Publicando e gerenciando GitHub Package Registry

GitHub Package Registry é 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. For more information, see “Introduction to GitHub Package Registry."

Para obter mais informações sobre como habilitar e configurar GitHub Package Registry para sua instância do GitHub Enterprise Server, consulte "Primeiros passos com GitHub Package Registry para a sua empresa".

5. Usar GitHub Pages

GitHub Pages is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository and publishes a website. You can enable or disable GitHub Pages for your enterprise members at the organization level. For more information, see "Configuring GitHub Pages for your enterprise" and "About GitHub Pages."

Parte 5: Conectando com outros recursos de GitHub

Você pode usar GitHub Connect para compartilhar recursos.

Se você for o proprietário de uma instância de GitHub Enterprise Server e uma organização ou conta corporativa de GitHub Enterprise Cloud, você poderá habilitar GitHub Connect. GitHub Connect permite que você compartilhe fluxos de trabalho específicos e recursos entre sua instância do GitHub Enterprise Server e GitHub Enterprise Cloud, como pesquisa unificada e contribuições. Para obter mais informações, consulte "Conectar o GitHub Enterprise Server ao GitHub Enterprise Cloud".

Parte 6: Usando o aprendizado de GitHub e o suporte recursos

Os membros da sua empresa podem aprender mais sobre o Git e GitHub com os nossos recursos de aprendizagem. e você pode obter o suporte de que precisa ao configurar e gerenciar sua instância do GitHub Enterprise Server com o suporte do enterprise de GitHub.

1. Aprendendo com GitHub Learning Lab

Your enterprise members can learn new skills by completing fun, realistic projects in their very own GitHub repository with GitHub Learning Lab. Each course is a hands-on lesson created by the GitHub community and taught by the friendly Learning Lab bot.

For more information, see “Git and GitHub learning resources."

2. Trabalhando com o Suporte do Enterprise de GitHub

GitHub Enterprise Server includes access to Suporte do GitHub Enterprise. Suporte do GitHub Enterprise can help you troubleshoot issues that come up on GitHub Enterprise Server. You can also choose to sign up for GitHub Premium Support for additional features. For more information, see "About Suporte do GitHub Enterprise."