Versão do artigo: Enterprise Server 2.17
Instalar o GitHub Enterprise Server no OpenStack KVM
Para instalar o GitHub Enterprise Server no OpenStack KVM, você deve ter acesso ao OpenStack e baixar a imagem QCOW2 do GitHub Enterprise Server.
Pré-requisitos
- You must have a GitHub Enterprise license file. To download an existing license file or request a trial license, visit enterprise.github.com. For more information, see "Managing your GitHub Enterprise Server 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 requires a persistent data disk separate from the root disk. For more information, see "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). We recommend different hardware configurations based on the number of user licenses used in sua instância do GitHub Enterprise Server. |
User licenses | vCPUs | Memória | Attached storage | Root storage |
---|---|---|---|---|
Trial, demo, or 10 light users | 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 básicas de hardware. Podem ser necessários mais recursos dependendo do uso, como atividade do usuário e integrações selecionadas. When increasing CPU resources, it's recommended to add at least 6.5 GB of memory for each CPU (up to 16 CPUs) added to your GitHub Enterprise Server instance. For more information, see "Increasing CPU or memory resources."
Note: The root disk can be resized by building a new appliance or using an existing appliance. For more information, see "Increasing storage capacity."
Warning: We recommend you use webhooks to fetch repository changes for continuous integration (CI) or similar systems. Regular automatic checks, or polling, will significantly reduce the scalability of your instance. Para obter mais informações, consulte "Sobre webhooks"
Baixar a imagem do GitHub Enterprise Server
- Navigate to the GitHub Enterprise Server download page.
- Para baixar o arquivo de licença, clique em Download license (Baixar licença).
- Click 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
To create the instance, you'll need to import the GitHub Enterprise Server image to your virtual machine and attach an additional storage volume for your instance data. Para obter mais informações, consulte "Considerações de hardware".
-
No OpenStack Horizon, faça upload da imagem do GitHub Enterprise Server que você baixou. Para ver as instruções, consulte a seção "Fazer upload de imagens" no guia "Fazer upload e gerenciar imagens" do OpenStack.
-
Create a new virtual disk to use as an attached storage volume for your instance data, and configure the size based on your user license count. Para ver as instruções, consulte "Criar e gerenciar volumes" no guia do OpenStack.
-
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 over SSH access. Clone, fetch, and push operations to public/private repositories supported. 25 SMTP SMTP with encryption (STARTTLS) support. 80 HTTP Web application access. All requests are redirected to the HTTPS port when SSL is enabled. 122 SSH Instance shell access. The default SSH port (22) is dedicated to application git+ssh network traffic. 161/UDP SNMP Obrigatória para operações de protocolo de monitoramento de rede. 443 HTTPS Web application and Git over HTTPS access. 1194/UDP VPN Secure replication network tunnel in high availability configuration. 8080 HTTP Plain-text web based Console de gerenciamento. Not required unless SSL is disabled manually. 8443 HTTPS Secure web based Console de gerenciamento. Required for basic installation and configuration. 9418 Git Simple Git protocol port. Clone and fetch operations to public repositories only. Unencrypted network communication. -
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.
- At the prompt, upload your license file and set a management console password. For more information, see "Managing your GitHub Enterprise Server license."
- In the Console de gerenciamento, configure and save your desired settings. Para obter mais informações, consulte "Configurar o appliance do GitHub Enterprise Server".
- A instância será reiniciada automaticamente.
- Click Visit your instance.