Pré-requisitos
- Você deve ter um GitHub Enterprise arquivo de licença. Para baixar um arquivo de licença existente ou solicitar uma licença de teste, visite enterprise.github.com. Para obter mais informações, consulte "Managing your GitHub Enterprise license."
- Você deve ter acesso a uma instalação do OpenStack Horizon, a interface de usuário baseada na web para os serviços do OpenStack. Para obter mais informações, consulte a Documentação do Horizon.
Considerações de hardware
GitHub Enterprise Server requer um disco de dados persistente separado do disco raiz. Para obter mais informações, consulte "System overview." Para seu dispositivos de armazenamento, recomendamos um SSD de alto desempenho seja anexado diretamente ou de uma rede de área de armazenamento (SAN). Recomendamos diferentes configurações de hardware com base no número de licenças de usuário usadas em sua instância do GitHub Enterprise Server. |
| Licenças de usuário | vCPUs | Memória | Armazenamento anexado | Armazenamento raiz |
|---|---|---|---|---|
| Teste, demonstração ou 10 usuários leves | 2 | 16 GB | 100 GB | 200 GB |
| 10-3000 | 4 | 32 GB | 250 GB | 200 GB |
| 3000-5000 | 8 | 64 GB | 500 GB | 200 GB |
| 5000-8000 | 12 | 96 GB | 750 GB | 200 GB |
| 8000-10000+ | 16 | 128 GB | 1000 GB | 200 GB |
Essas são as recomendações mínimas. Podem ser necessários mais recursos, dependendo do seu uso, como atividade do usuário e integrações selecionadas. Ao aumentar os recursos da CPU, é recomendado adicionar pelo menos 6.5 GB de memória para cada CPU (até 16 CPUs) adicionado à sua instância do GitHub Enterprise Server. Para obter mais informações, consulte "Increasing CPU or memory resources."
Nota: O disco raiz pode ser redimensionado construindo um novo appliance ou usando um appliance existente. Para obter mais informações, consulte "Increasing storage capacity."
Aviso: Recomendamos que você use webhooks para buscar alterações de repositório para integração contínua (CI) ou sistemas similares. Verificações automáticas regulares, ou polling, reduzirão significativamente a escalabilidade de sua instância. Para obter mais informações, consulte "Sobre webhooks"
Baixar a imagem do GitHub Enterprise Server
- Navegue até the GitHub Enterprise Server download page.
- Para baixar o arquivo de licença, clique em Download license (Baixar licença).
- Clique em Get the latest release of GitHub Enterprise Server.
- Selecione o GitHub On-premises e clique em OpenStack KVM (QCOW2).
- Clique em Download for OpenStack KVM (QCOW2) (Baixar para OpenStack KVM [QCOW2]).
Criar a instância do GitHub Enterprise Server
Para criar a instância, você precisará importar a imagem GitHub Enterprise Server para sua máquina virtual e anexar um volume de armazenamento adicional para os dados de sua instância. Para obter mais informações, consulte "Hardware considerations."
-
No OpenStack Horizon, faça upload da imagem do GitHub Enterprise Server que você baixou. Para obter instruções, consulte a seção "Fazer upload de uma imagem" do guia OpenStack "Fazer upload e gerenciar imagens".
-
Crie um novo disco virtual para usar como um volume de armazenamento conectado para os dados da sua instância e configure o tamanho com base na contagem de licenças do usuário. Para obter instruções, consulte o guia OpenStack "Criar e gerenciar volumes".
-
Crie um grupo de segurança e adicione uma nova regra de grupo de segurança para cada porta na tabela abaixo. Para ver as instruções, consulte o guia do OpenStack "Configurar o acesso e a segurança nas instâncias".
Porta Serviço Descrição 22 SSH Git sobre acesso via SSH. Clone, buscar e fazer push de operações para repositórios público/privado suportados. 25 SMTP Suporte a SMTP com criptografia (STARTTLS). 80 HTTP Acesso ao aplicativo web. Todas as solicitações são redirecionadas para a porta HTTPS quando o SSL estiver habilitado. 122 SSH Exemplo de acesso a shell. A porta SSH padrão (22) é dedicada ao tráfego de rede git+ssh. 161/UDP SNMP Obrigatória para operações de protocolo de monitoramento de rede. 443 HTTPS Aplicativo web e Git sobre acesso HTTPS. 1194/UDP VPN Túnel de rede de réplica segura na configuração de alta disponibilidade. 8080 HTTP Baseado em web de texto simples Console de gerenciamento. Não é necessário, a menos que o SSL seja desativado manualmente. 8443 HTTPS Base segura na web Console de gerenciamento. Necessário para instalação básica e configuração. 9418 Git Porta de protocolo Simples Git. Clonar e buscar somente as operações para repositórios públicos. Comunicação sem criptografia de rede. -
Você também pode associar um IP flutuante à instância. Dependendo da sua configuração do OpenStack, talvez seja necessário alocar um IP flutuante para o projeto e associá-lo à instância. Entre em contato com o administrador do sistema para determinar se esse é o seu caso. Para obter mais informações, consulte "Alocar endereço IP flutuante a uma instância" na documentação do OpenStack.
-
Inicie a sua instância do GitHub Enterprise Server usando a imagem, o volume de dados e o grupo de segurança criados nas etapas anteriores. Para ver as instruções, consulte "Iniciar e gerenciar instâncias" no guia do OpenStack.
Configurar a instância do GitHub Enterprise Server
- Copie o nome DNS público da máquina virtual e cole-o em um navegador.
- No prompt, carregue seu arquivo de licença e defina uma senha de gerenciamento do console. Para obter mais informações, consulte "Managing your GitHub Enterprise license."
- No Console de gerenciamento, configure e salve as configurações desejadas. Para obter mais informações, consulte "Configurar o appliance do GitHub Enterprise Server".
- A instância será reiniciada automaticamente.
- Clique Visit your instance (Visite sua instância).