Esta versão do GitHub Enterprise Server foi descontinuada em 2024-03-26. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Aprimorar os recursos de CPU ou memória

Você pode aprimorar os recursos de CPU ou memória para a máquina virtual (VM) que executa sua instância do GitHub Enterprise Server.

Neste artigo

Sobre aprimorar os recursos de CPU ou memória

Você pode acomodar cargas de trabalho com uso mais intensivo de recursos em sua instância do GitHub Enterprise Server aumentando os recursos de CPU ou memória da VM.

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".

Você pode sempre ajustar sua CPU ou memória redimensionando sua instância. Alterar os recursos disponíveis para sua instância requer tempo de inatividade para seus usuários, portanto, a GitHub recomenda recursos de provisionamento excessivo para levar em conta a escala.

Adicionar recursos de CPU ou memória para AWS

Para adicionar recursos de CPU ou memória para uma instância na AWS, você precisa alterar o tipo da instância. Você precisa ter acesso à infraestrutura da AWS da sua empresa e deve estar familiarizado com o uso do console de gerenciamento da AWS ou da interface de linha de comando do aws ec2 para gerenciar instâncias do EC2. Para obter mais informações, confira Alterar o tipo de instância na documentação da AWS.

Você pode revisar as considerações de redimensionamento, ver os tipos de instância compatíveis e aprender a redimensionar uma instância na AWS.

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, a GitHub recomenda 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 com suporte na AWS

É necessário determinar o tipo de instância para a qual você pretende atualizar com base nas especificações de CPU e memória.

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.

Redimensionamento de uma instância na AWS

Para aumentar os recursos disponíveis para uma instância GitHub Enterprise Server na AWS, você deve desligar a instância, alterar o tipo da instância e reiniciar a instância.

  1. Se as suas instâncias forem executadas no EC2-Classic, anote o endereço IP Elástico associado à instância e a ID da instância.

  2. Comunique o próximo tempo de inatividade aos usuários e habilite o modo de manutenção. Para obter mais informações, consulte os seguintes artigos.

  3. Para parar a instância, use o SSH na instância e execute o comando a seguir. Para obter mais informações, confira "Acesar o shell administrativo (SSH)".

    sudo poweroff

  4. Na AWS, altere o tipo de instância.

  5. Inicie a instância.

  6. Se sua instância for executada no EC2-Classic, depois de reiniciar a instância, associe novamente o endereço IP elástico.

  7. Depois que a instância for totalmente reiniciada e você possa alcançá-la, verifique se a nova configuração de recurso é reconhecida. Use o SSH na instância e execute o comando a seguir.

    ghe-system-info

  8. Opcionalmente, para validar as alterações configurando uma lista de exceções de IP para permitir o acesso a endereços IP especificados. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".

  9. Se você configurou uma mensagem de usuário, remova a mensagem.

  10. Desabilite o modo de manutenção.

Adicionar recursos de CPU ou memória ao Microsoft Azure

Para adicionar recursos de CPU ou memória para uma instância no Microsoft Azure, você precisa alterar o tamanho da instância. Você deve ter acesso à infraestrutura do Microsoft Azure da sua empresa e deve estar familiarizado com o Portal do Azure, a CLI do Azure ou o PowerShell do Azure para gerenciar instâncias do Azure. Para obter mais informações, consulte Alterar o tamanho de uma máquina virtual no Microsoft Learn.

Você pode revisar as considerações de redimensionamento, ver os tipos de instância compatíveis e aprender a redimensionar uma instância no Microsoft Azure.

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, a GitHub recomenda 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.

Tipos de instância compatíveis no Microsoft Azure

É necessário determinar o tipo de instância para a qual você pretende atualizar com base nas especificações de CPU e memória.

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 de uma instância no Microsoft Azure

Para aumentar os recursos disponíveis para uma instância GitHub Enterprise Server no Microsoft Azure, você deve alterar o tamanho da VM. Alterar o tamanho da VM fará com que a VM seja reiniciada. Em alguns casos, você deverá desalocar a VM primeiro. Você pode precisar desalocar a VM se o novo tamanho não estiver disponível no cluster de hardware que está hospedando a VM.

  1. Comunique o próximo tempo de inatividade aos usuários e habilite o modo de manutenção. Para obter mais informações, consulte os seguintes artigos.

  2. Para parar a instância, use o SSH na instância e execute o comando a seguir. Para obter mais informações, confira "Acesar o shell administrativo (SSH)".

    sudo poweroff

  3. No Azure, para redimensionar a VM, siga as instruções em Alterar o tamanho de uma máquina virtual, no Microsoft Learn.

  4. Depois que a instância for totalmente reiniciada e você possa alcançá-la, verifique se a nova configuração de recurso é reconhecida. Use o SSH na instância e execute o comando a seguir.

    ghe-system-info

  5. Opcionalmente, para validar as alterações configurando uma lista de exceções de IP para permitir o acesso a endereços IP especificados. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".

  6. Se você configurou uma mensagem de usuário, remova a mensagem.

  7. Desabilite o modo de manutenção.

Adicionar recursos de CPU ou memória para OpenStack KVM

Para aumentar os recursos disponíveis para uma instância de GitHub Enterprise Server no OpenStack KVM, você deve ter acesso à infraestrutura do OpenStack KVM da sua empresa e deve parar a VM e selecionar uma nova variante de instância.

Quando você aumenta os recursos da CPU, a GitHub recomenda 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.

  1. Usando o OpenStack KVM, tire um instantâneo da instância atual.

  2. Comunique o próximo tempo de inatividade aos usuários e habilite o modo de manutenção. Para obter mais informações, consulte os seguintes artigos.

  3. Para parar a instância, use o SSH na instância e execute o comando a seguir. Para obter mais informações, confira "Acesar o shell administrativo (SSH)".

    sudo poweroff

  4. No OpenStack KVM, selecione um novo tipo de instância que tenha os recursos de CPU ou memória desejados.

  5. Depois que a instância for totalmente reiniciada e você possa alcançá-la, verifique se a nova configuração de recurso é reconhecida. Use o SSH na instância e execute o comando a seguir.

    ghe-system-info

  6. Opcionalmente, para validar as alterações configurando uma lista de exceções de IP para permitir o acesso a endereços IP especificados. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".

  7. Se você configurou uma mensagem de usuário, remova a mensagem.

  8. Desabilite o modo de manutenção.

Adicionar recursos de memória ou CPU para VMware ESXi

Para aumentar os recursos disponíveis para uma instância de GitHub Enterprise Server no VMware, você deve ter acesso à infraestrutura do XMware da sua empresa e deve parar a VM e ajustar os recursos no VMWare ESXi.

Quando você aumenta os recursos da CPU, a GitHub recomenda 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.

  1. Comunique o próximo tempo de inatividade aos usuários e habilite o modo de manutenção. Para obter mais informações, consulte os seguintes artigos.

  2. Para parar a instância, use o SSH na instância e execute o comando a seguir. Para obter mais informações, confira "Acesar o shell administrativo (SSH)".

    sudo poweroff

  3. Para as configurações da VM no host VMware ESXi usando o vSphere Client, selecione a VM e clique em Editar configurações.

  4. Em "Hardware", ajuste os recursos de CPU e/ou memória alocados à máquina virtual, conforme necessário.

  5. Para iniciar a máquina virtual, clique em OK.

  6. Depois que a instância for totalmente reiniciada e você possa alcançá-la, verifique se a nova configuração de recurso é reconhecida. Use o SSH na instância e execute o comando a seguir.

    ghe-system-info

  7. Opcionalmente, para validar as alterações configurando uma lista de exceções de IP para permitir o acesso a endereços IP especificados. Para obter mais informações, confira "Habilitar e programar o modo de manutenção".

  8. Se você configurou uma mensagem de usuário, remova a mensagem.

  9. Desabilite o modo de manutenção.