Skip to main content
Skip to content

Problemas conhecidos com atualizações das suas instâncias

Confira uma visão geral das soluções alternativas para problemas que afetam o processo GitHub Enterprise Serverde atualização ou afetam sua instância após a conclusão de uma atualização.

Sobre problemas conhecidos com a GitHub Enterprise Server atualização

GitHub está ciente dos seguintes problemas que podem afetar atualizações para novas versões de GitHub Enterprise Server. Para obter mais informações, consulte "Problemas conhecidos" nas notas de versãoGitHub Enterprise Server.

Se você vir o erro The file provided is not a valid GitHub Enterprise Server package ao tentar uma atualização, talvez seja necessário rotacionar a chave de assinatura GPG na sua instância. Para saber mais, confira Rotação da chave de assinatura para pacotes de atualização.

GitHub recomenda fortemente backups regulares da configuração e dos dados da sua instância. Antes de prosseguir com qualquer atualização, faça o backup da instância e valide-o em um ambiente de preparo. Para saber mais, confira Configurando backups em sua instância com utilitários de backup e Configurar uma instância de testes.

A correspondência de NameID SAML diferencia maiúsculas de minúsculas

Essa alteração se aplica a GitHub Enterprise Server 3.19.16, 3.20.12, 3.21.10 e 3.22.5, lançadas em 17 de novembro de 2026. Ele não se aplica a GitHub Enterprise Cloud ou a GitHub Enterprise Server instâncias com provisionamento SCIM habilitado.

Uma correção de segurança altera a forma como os valores SAML NameID são correspondidos às contas existentes. Diferenças na capitalização, acentos ou espaços à direita são rejeitadas em vez de ignoradas. Isso ajuda a impedir que um login via SAML selecione a conta errada GitHub.

Se o NameID IdP (provedor de identidade) enviado durante a autenticação SAML não corresponder exatamente ao mapeamento GitHub Enterprise ServerSAML armazenado do usuário, a autenticação falhará. Por exemplo, uma entrada NameID de Mona não corresponde mais a um NameID armazenado de mona. O usuário vê o erro Another user already owns the account. Please have your administrator check the authentication log.

Antes de atualizar, verifique se os valores SAML NameID enviados pelo IdP correspondem exatamente aos valores de mapeamento NameID SAML armazenados, incluindo as mesmas letras maiúsculas e minúsculas.

  1. Verifique o SAML NameID armazenado do usuário na guia Segurança no painel do administrador do site. Para saber mais, confira Como atualizar o NameID do SAML de um usuário. Você também pode exportar mapeamentos usando ghe-saml-mapping-csv --dump. Esse utilitário não dá suporte a instâncias usando o provisionamento SCIM.
  2. Verifique o SAML NameID de entrada para o usuário. Habilite temporariamente a depuração saml, reproduza a tentativa de entrada saml do usuário e inspecione a resposta SAML NameID nos logs do journal systemd para github-unicorn. Desabilite a depuração imediatamente depois para evitar o registro em log excessivo e o potencial impacto no desempenho. Para saber mais, confira Solucionando problemas de autenticação SAML.

Se os valores forem diferentes, atualize o mapeamento SAML NameID armazenado do usuário para corresponder ao valor enviado pelo IdP.

Estamos trabalhando para restaurar o comportamento de correspondência SAML NameID que não diferencia maiúsculas de minúsculas anterior. As notas de versão anunciarão quando esta atualização estiver disponível.

Retomar as atualizações para a versão 3.15 ou superior

Pausamos as atualizações para as versões 3.15, 3.16 e 3.17. Agora você pode atualizar para 3.15.12, 3.16.8, 3.17.5 ou posterior. Não recomendamos atualizar para versões anteriores da 3.15, 3.16 ou 3.17. Como uma etapa adicional, é recomendável verificar a capacidade do sistema antes de atualizar. Confira Verificar a capacidade do sistema antes de atualizar.

Estendemos a janela de suporte para as versões 3.14, 3.15, 3.16 e 3.17. A janela de suporte para a versão 3.13 permanece inalterada. A data de encerramento de cada uma das versões, 3.14, 3.15, 3.16 e 3.17, foi atualizada. Para saber mais, confira Lançamentos do GitHub Enterprise Server.

Continuaremos lançando patches para as versões 3.14, 3.15, 3.16 e 3.17 ao longo desta janela de suporte estendido.

O tamanho do disco raiz necessário aumentou para 400 GB

Observação

O requisito anterior de tamanho de disco raiz de 400 GB para as versões 3.15.2 e posteriores foi removido. Esse requisito era baseado na análise de pacotes de suporte e tíquetes de suporte. Alguns fatores, como logs, colocavam pressão excessiva no disco raiz, o que causava problemas com o aparelho. Depois de receber comentários de que adquirir um novo hardware seria desafiador para muitos clientes, revertemos o requisito e adotamos uma abordagem gradual. Ainda recomendamos que os clientes, especialmente aqueles que usam topologias autônomas ou autônomas de alta disponibilidade, atualizem o disco raiz para 400 GB. Quando você conseguir atualizar o disco raiz para 400 GB, confira as instruções a seguir.

Para clientes que usam topologias autônomas ou de HA, é recomendável que novas instalações da versão 3.15 ou posteriores ou atualizações para a 3.15 usem o tamanho do disco raiz mínimo de 400 GB. GitHub recomenda fortemente seguir as diretrizes em Aumentar a capacidade de armazenamento.

Registros não criptografados

Se você estiver atualizando da GitHub Enterprise Server 3.11 ou 3.12 para a 3.13 ou da 3.12 para a 3.14, poderá encontrar um problema com registros não criptografados devido à falta de chaves necessárias para descriptografia. A única solução é excluir os registros não criptografados. O tipo de registro afetado por esse problema são registros 2FA, o que significa que talvez seja necessário solicitar aos usuários que habilitem novamente a 2FA (autenticação de dois fatores).

Antes de atualizar

Se você estiver atualizando da GitHub Enterprise Server 3.11 ou 3.12 para a 3.13 ou da 3.12 para a 3.14, poderá executar o script de diagnóstico de criptografia para identificar os registros indescriptografáveis antecipadamente. Este script não modifica nenhum registro, mas permite que você entenda o impacto e possa se planejar.

  1. Baixe o script de diagnóstico de criptografia. Você pode usar um comando como curl -L -O https://gh.io/ghes-encryption-diagnostics para baixar o script.
  2. Salve o script no diretório /data/user/common do dispositivo.
  3. Siga as instruções no início do script e execute-as no dispositivo. Se houver registros não criptografados, eles estarão registrados em /tmp/column_encryption_records_to_be_deleted.log. Os registros que estão aqui não foram descriptografados porque o sistema não conseguiu encontrar as chaves usadas para a criptografia deles.

Esses registros serão excluídos como parte do processo de upgrade. O script avisará você sobre os usuários que precisarão se inscrever novamente na 2FA após a atualização. Os identificadores dos usuários afetados estão registrados em /tmp/column_encryption_users_to_have_2fa_disabled.log. Esses usuários precisarão ser inscritos novamente na 2FA.

Se o script tiver problemas inesperados, você será solicitado a entrar em contato Suporte do GitHub. Os erros relacionados a esses problemas serão registrados em /tmp/column_encryption_unexpected_errors.log. Se você estiver em uma situação crítica e não conseguir que os usuários se reinscrevam na 2FA, entre em contato Suporte do GitHub para obter ajuda.

O script informará: "Sucesso: registros criptografados OK". se conseguisse encontrar as chaves associadas aos registros criptografados. Esses registros serão descriptografados e preservados durante o processo de upgrade e não exigirão intervenção manual.

Durante a atualização

Caso você não tenha tido a oportunidade de executar o script de diagnóstico de criptografia com antecedência, o produto dispõe de mecanismos destinados a fornecer ajuda. As verificações pré-voo durante o processo de atualização detectarão registros não descriptografáveis ​​e os registrarão em /tmp/column_encryption_records_to_be_deleted.log. A sequência avisará você sobre os usuários que precisarão habilitar novamente a 2FA após a atualização. Os registros de usuários afetados são registrados em /tmp/column_encryption_users_to_have_2fa_disabled.log.

Se forem detectados registros não criptografados, você precisará indicar se deseja continuar com a atualização. Se você continuar, o processo de atualização excluirá os registros não criptografados. Caso contrário, o processo de atualização será fechado.

Se você tiver dúvidas durante a atualização, poderá entrar em contato com Suporte do GitHub. Após ter tido o tempo e a oportunidade de entender o impacto, você poderá disparar a atualização novamente.