Visão geral do plano de upgrade

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura
  • Acelere seus upgrades usando o plano de upgrade que automatiza a instalação de aplicações durante upgrades, proporcionando uma experiência de upgrade perfeita. Ele ajuda a definir aplicações e versões de destino a serem instaladas em sua instância.

    Navegar até Tudo > Central de upgrades > Plano de upgrade.

    Você precisará das seguintes instâncias para usar o plano de upgrade.
    • Instância do construtor: Crie seu plano de upgrade
    • Instância do consumidor: Implemente o plano de upgrade criado
    Nota:
    Certifique-se de ter atualizado sua instância para a versão mais recente disponível para criar o plano de upgrade. É recomendável configurar sua instância de desenvolvimento como sua instância do construtor. Você deve instalar o plano de upgrade antes de fazer upgrade da instância do consumidor. Consulte Propriedades do plano de upgrade para obter mais detalhes.
    Quando você faz upgrade de uma instância, as resoluções são ignoradas e as personalizações geralmente são carregadas após o upgrade. Isso causa o detalhamento temporário dos recursos até que sejam totalmente carregados. Tarefas como confirmar conjuntos de atualizações, instalar novos plug-ins e aplicações e várias atualizações também são demoradas. Use o recurso Plano de upgrade para automatizar essas tarefas pós-upgrade rastreando suas ações e repita as etapas em todas as instâncias necessárias. Você não precisa aplicar manualmente tarefas pós-upgrade, o que ajuda a reduzir o tempo de inatividade.
    Nota:
    Após atualizar para a versão mais recente, você verá alguns registros ignorados. Alguns desses registros já serão marcados como revisados e alguns deles precisarão ser revisados.
    A partir da versão Yokohama, personalizações e registros ignorados não fazem parte do Plano de upgrade, por padrão. Você pode optar por incluir as personalizações e os registros ignorados junto com as instalações do app no plano de upgrade habilitando a propriedade glide.upgrade.plan.include.skips. Esta propriedade controla quando ignorados e personalizações são incluídos quando você cria ou atualiza um plano de upgrade.
    • Quando a propriedade glide.upgrade.plan.include.skips é VERDADEIRO , Ignorados e personalizações são incluídos quando um Plano de upgrade é criado ou atualizado
    • Quando a propriedade glide.upgrade.plan.include.skips é FALSO , Ignorados e personalizações não são incluídos quando um Plano de upgrade é criado ou atualizado. Esta propriedade foi definida como falsa por padrão.
    Você verá uma das seguintes mensagens modais, dependendo do cenário:
    • Usuário pela primeira vez: Quando você está criando seu plano de upgrade pela primeira vez (a propriedade está desabilitada por padrão)

      Captura de tela mostrando o usuário pela primeira vez do plano de upgrade

    • Criando o plano de upgrade com a propriedade habilitada

      Captura de tela mostrando a criação do plano de upgrade com a propriedade habilitada

    • Atualizar o plano de upgrade com a propriedade desabilitada (padrão)

      Captura de tela mostrando a atualização do plano de upgrade com a propriedade desabilitada

    • Atualizando o plano de upgrade com a propriedade habilitada

      Captura de tela mostrando a atualização do plano de upgrade com a propriedade habilitada

    Vantagens do plano de upgrade em relação aos conjuntos de atualizações

    Você pode fazer o seguinte usando os planos de upgrade:
    • Junto com a resolução de registro ignorada, você também pode rastrear a instalação do app e do plug-in
      Nota:
      Você não terá permissão para escolher os registros ignorados que são capturados pelo plano de upgrade. O plano de upgrade captura todos os registros ignorados, independentemente de serem revisados ou não e modificados ou não. Se as personalizações forem provenientes de instâncias diferentes, os registros ignorados deverão ser revisados.
    • A otimização da tabela muda usando a inicialização em lote
    • Gerencie suas personalizações usando o Repositório de aplicações
    Nota:
    É recomendável criar um plano de upgrade para cada upgrade de instância. Quando você cria um plano de upgrade em uma instância do construtor, ele é criado exatamente da mesma forma que a versão da instância do construtor (incluindo patches e hotfixes). Você não pode usar o plano de upgrade criado anteriormente para o upgrade da nova instância. No caso de instâncias do consumidor, quando você instala o plano de upgrade, sua versão deve corresponder exatamente à versão da instância do consumidor.

    Persona

    Se você estiver usando o repositório de apps para desenvolvimento de aplicações ativas, use o Plano de upgrade para acelerar seus upgrades.
    Nota:
    No momento, você estiver usando os Conjuntos de atualizações e quiser catapultar seu processo de upgrade, use o recurso Plano de upgrade.

    Considerações de design

    A seguir estão as considerações importantes ao trabalhar com o Plano de upgrade:
    • Cada novo upgrade de instância requer seu próprio plano de upgrade. Ele não pode ser compartilhado entre upgrades.
    • É compatível com apenas uma instância do construtor para criar o plano de upgrade
    • O plano de upgrade não pode ser desinstalado em uma instância do consumidor. Você pode reverter todo o upgrade, mas não parcialmente.
    • O escopo dos arquivos movidos para Personalizações globais - Plano de upgrade a aplicação por plano de upgrade ainda é global
    • Durante um upgrade, somente os itens do plano de upgrade com Pronto e. Verdadeiro são instalados nas instâncias do consumidor. O restante dos itens é ignorado.
    • Os conjuntos de upgrade não podem ser incluídos no plano de upgrade
    • Plug-ins somente de manutenção não são permitidos no plano de upgrade
    • Configure sua instância como uma instância do construtor antes de instalar novas aplicações e plug-ins ou durante ignorar resoluções. Caso contrário, as ações não serão capturadas pelo plano de upgrade.
    • Você não pode exibir a lista de personalizações na exibição Itens do plano de upgrade. Você pode navegar até as respectivas tabelas para garantir se a personalização foi capturada.

    Consulte KB1271313 para obter mais informações.

    Operações em segundo plano do plano de upgrade

    Durante a criação do plano de upgrade, as seguintes operações são feitas em segundo plano:
    • Os registros ignorados são empacotados e carregados no Repositório de aplicações na forma de personalização global de aplicações e aplicações. A seguir estão os 3 tipos de apps criados pelo plano de upgrade na sua instância e no repositório de apps.
      Nota:
      Depois que a embalagem estiver concluída, você poderá escolher os itens do Plano de upgrade. Um Plano de upgrade funciona no nível do escopo, portanto, ele captura tudo e o publica no repositório.
      • Os registros globais são empacotados no app do plano de upgrade de personalização global e publicados no repositório de apps
      • Os registros ignorados com escopo são empacotados nos respectivos pacotes de personalização do app
      • Quando o plano de upgrade é publicado, uma aplicação global é criada, por exemplo, Plano de upgrade - Nome da versão
    • Os recursos da ServiceNow existentes, como Aplicação global e Personalização de aplicações, são usados como contêineres de aplicações que podem ser instalados em todas as instâncias necessárias. Para obter mais informações, consulte e Application scope.
    • Se você instalar quaisquer aplicações ou plug-ins, eles também serão capturados no plano de upgrade. Mas, como são itens do ciclo de vida da aplicação, eles nunca são enviados para o repositório de aplicações.
    Durante o consumo do plano de upgrade, as seguintes operações são feitas em segundo plano:
    • No início, o plano de upgrade é validado e, em seguida, a origem do repositório de apps é baixada
    • Quando a origem é baixada, o app é movido para o estado pronto
      Nota:
      Somente os itens do plano de upgrade com Pronto e. Verdadeiro são instalados nas instâncias do consumidor. O restante dos itens é ignorado.
    • Visualização automática do plano de upgrade