Aviso: o processo usado para alocar novos recursos do sistema varia de acordo com a plataforma de virtualização e o tipo de recurso. Você deve sempre configurar o monitoramento e alerta de recursos chave do sistema. Para obter mais informações, confira "Monitorar sua instância".
Observação: antes de aumentar os recursos de CPU ou memória, coloque sua instância no modo de manutenção. Você pode validar as alterações configurando uma lista de exceções de IP para permitir o acesso de endereços IP especificados. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".
Adicionar recursos de CPU ou memória para AWS
Observação: para adicionar recursos de CPU ou memória à AWS, você deve saber usar o console de gerenciamento da AWS ou a interface da linha de comando da aws ec2
para gerenciar instâncias do EC2. Para obter informações e detalhes sobre como usar as ferramentas da AWS de sua preferência para executar o redimensionamento, consulte a documentação da AWS sobre o redimensionamento de uma instância com backup do Amazon EBS.
Considerações sobre redimensionamento para a AWS
Antes de aumentar os recursos de CPU ou de memória do sua instância do GitHub Enterprise Server, analise as recomendações a seguir.
- Escale sua memória com CPUs. Quando você aumenta os recursos da CPU, recomendamos adicionar pelo menos 6.5 GB de memória para cada vCPU (até 16 vCPUs) que você fornecer para a instância. Ao usar mais de 16 vCPUs, você não precisa adicionar 6.5 GB de memória para cada vCPU, mas você deve monitorar sua instância para garantir que ela tenha memória suficiente.
- Atribua um endereço IP Elástico à instância. Se não houver IP elástica atribuída, você terá que ajustar os registros DNS A do seu host do GitHub Enterprise Server após o reinício para explicar a alteração no endereço IP público. Depois que a instância for reiniciada, a IP elástica (EIP) será automaticamente mantida se a instância for iniciada em uma VPC. Se a instância for iniciada no EC2-Classic, a IP elástica deverá ser associada outra vez manualmente.
Tipos de instância do AWS compatíveis
É necessário determinar o tipo de instância para a qual você pretende atualizar com base nas especificações de CPU/memória.
Observação: você pode sempre ajustar sua CPU ou memória redimensionando sua instância. No entanto, como o redimensionamento da sua CPU ou memória requer tempo de inatividade para os usuários, recomendamos o fornecimento excessivo de recursos para contas em escala.
GitHub recomenda uma instância otimizada para a memória para GitHub Enterprise Server. Para obter mais informações, confira Tipos de Instância do Amazon EC2 no site do Amazon EC2.
Redimensionar para o AWS
Observação: para instâncias iniciadas no EC2-Classic, anote o endereço IP Elástico associado à instância e a ID da instância. Depois de reiniciar a instância, reassocie o endereço IP elástico.
Não é possível adicionar recursos de CPU ou memória a uma instância atual do AWS/EC2. Faça o seguinte:
- Pare a instância;
- Altere o tipo de instância.
- Inicie a instância.
- Uma vez que a instância tenha sido totalmente reiniciada e você possa alcançá-la, use o shell administrativo SSH para verificar se a nova configuração de recurso é reconhecida:
ssh -p 122 admin@HOSTNAME
ghe-system-info
Adicionar recursos de CPU ou memória ao Microsoft Azure
Observação: para adicionar recursos de CPU ou memória no Microsoft Azure, você deve estar familiarizado com o uso do Portal Azure, da Azure CLI ou do Azure Powershell para gerenciar as instâncias de VM. Para obter informações e detalhes sobre como usar as ferramentas do Azure de sua preferência para executar o redimensionamento, confira a documentação do Azure sobre como alterar o tamanho de uma máquina virtual.
Considerações sobre redimensionamento para o Microsoft Azure
Antes de aumentar os recursos de CPU ou de memória do sua instância do GitHub Enterprise Server, analise as recomendações a seguir.
- Escale sua memória com CPUs. Quando você aumenta os recursos da CPU, recomendamos adicionar pelo menos 6.5 GB de memória para cada vCPU (até 16 vCPUs) que você fornecer para a instância. Ao usar mais de 16 vCPUs, você não precisa adicionar 6.5 GB de memória para cada vCPU, mas você deve monitorar sua instância para garantir que ela tenha memória suficiente.
- Atribua um endereço IP estático à instância. Se você não atribuiu um IP estático à instância, você deve ter que ajustar os registros DNS A para o seu host de GitHub Enterprise Server após a reinicialização da conta para alterar o endereço IP.
Tamanhos compatíveis da instância do Microsoft Azure
É necessário determinar tamanho da instância para a qual você pretende atualizar com base nas especificações de CPU/memória.
Observação: você pode sempre ajustar sua CPU ou memória redimensionando sua instância. No entanto, como o redimensionamento da sua CPU ou memória requer tempo de inatividade para os usuários, recomendamos o fornecimento excessivo de recursos para contas em escala.
O appliance do GitHub Enterprise Server requer um disco de dados de armazenamento premium e é compatível com qualquer VM do Azure que tenha suporte ao armazenamento premium. Os tipos de VMs do Azure com o sufixo s
dão suporte ao armazenamento premium. Para obter mais informações, confira "Quais tipos de discos estão disponíveis no Azure?" e "Armazenamento premium do Azure: design para alto desempenho" na documentação do Azure.
GitHub recomenda uma VM com memória otimizada para GitHub Enterprise Server. Para obter mais informações, confira "Tamanhos de máquina virtual otimizados para memória" na documentação do Azure.
O GitHub Enterprise Server dá suporte a qualquer região compatível com o seu tipo de VM. Para obter mais informações sobre as regiões com suporte para cada VM, confira "Produtos disponíveis por região" do Azure.
Redimensionamento para o Microsoft Azure
Você pode dimensionar a VM alterando o tamanho da VM. Alterar o tamanho dele fará com que ele seja reiniciado. Em alguns casos, você deverá desalocar a VM primeiro. Isso pode acontecer se o novo tamanho não estiver disponível no cluster de hardware que hospeda atualmente a VM.
- Consulte a documentação do Azure sobre como alterar o tamanho de uma máquina virtual para as etapas necessárias.
- Uma vez que a instância tenha sido totalmente reiniciada e você possa alcançá-la, use o shell administrativo SSH para verificar se a nova configuração de recurso é reconhecida:
ssh -p 122 admin@HOSTNAME
ghe-system-info
Adicionar recursos de CPU ou memória para OpenStack KVM
Não é possível adicionar recursos de CPU ou memória a uma instância atual do OpenStack KVM. Faça o seguinte:
- Tire um instantâneo da instância atual;
- Pare a instância;
- Selecione um novo tipo de instância que tenha os recursos de CPU e/ou memória desejados.
Adicionar recursos de memória ou CPU para VMware
Quando você aumenta os recursos da CPU, recomendamos adicionar pelo menos 6.5 GB de memória para cada vCPU (até 16 vCPUs) que você fornecer para a instância. Ao usar mais de 16 vCPUs, você não precisa adicionar 6.5 GB de memória para cada vCPU, mas você deve monitorar sua instância para garantir que ela tenha memória suficiente.
- Use o cliente vSphere para conexão com o host VMware ESXi.
- Desligue o sua instância do GitHub Enterprise Server.
- Selecione a máquina virtual e clique em Editar Configurações.
- Em "Hardware", ajuste a CPU e/ou os recursos de memória alocados à máquina virtual, conforme necessário.
- Para iniciar a máquina virtual, clique em OK.
- Uma vez que a instância tenha sido totalmente reiniciada e você possa alcançá-la, use o shell administrativo SSH para verificar se a nova configuração de recurso é reconhecida:
ssh -p 122 admin@HOSTNAME
ghe-system-info