Versão do artigo: Enterprise Server 2.17
Instalar o GitHub Enterprise Server no Hyper-V
Para instalar o GitHub Enterprise Server no Hyper-V, você deve fazer a implantação em uma máquina que execute o Windows Server 2008 através do Windows Server 2016.
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."
- Seu sistema operacional deve estar entre o Windows Server 2008 e o Windows Server 2016, que são compatíveis com o Hyper-V.
- A maioria das ações necessárias para criar sua máquina virtual (VM) também pode ser executada usando o Gerenciador do Hyper-V. No entanto, a configuração inicial é recomendável com o shell de linha de comando do Windows PowerShell. Veja abaixo alguns exemplos com o PowerShell. Para obter mais informações, consulte "Introdução ao Windows PowerShell" no guia da Microsoft.
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 GitHub On-premises e clique em Hyper-V.
- Clique em Download for Hyper-V (Baixar para Hyper-V).
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".
- In PowerShell, create a new Generation 1 virtual machine, configure the size based on your user license count, and attach the GitHub Enterprise Server image you downloaded. Para obter mais informações, consulte "Nova VM" na documentação da Microsoft.
PS C:\> New-VM -Generation 1 -Name VM_NAME -MemoryStartupBytes MEMORY_SIZE -BootDevice VHD -VHDPath PATH_TO_VHD
- 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. Substitua
PATH_TO_DATA_DISK
pelo caminho no local em que você criará o disco. Para obter mais informações, consulte "Novo VHD" na documentação da Microsoft.PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE
- Vincule o disco de dados à sua instância. Para obter mais informações, consulte "Adicionar VMHardDiskDrive" na documentação da Microsoft.
PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK
- Inicie a VM. Para obter mais informações, consulte "Iniciar a VM" na documentação da Microsoft.
PS C:\> Start-VM -Name VM_NAME
- Obtenha o endereço IP da sua VM. Para obter mais informações, consulte "Obter VMNetworkAdapter" na documentação da Microsoft.
PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses
- Copie o endereço IP da VM e cole em um navegador da web.
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.