View a markdown version of this page

Migrar a partir de dnf-plugin-support-info v1 para v2 - Amazon Linux 2023
Visão geral doAlterações significativas que exigem açãoO que não mudaPeríodo de transição

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Migrar a partir de dnf-plugin-support-info v1 para v2

O dnf-plugin-support-info pacote tem uma nova versão principal (v2) com um formato de saída redesenhado. Este guia ajuda você a atualizar quaisquer scripts ou ferramentas que dnf supportinfo analisam a saída.

Durante o período de transição, o plug-in v2 vem com legacy = 1 in/etc/dnf/plugins/supportinfo.conf, o que preserva a saída compatível com v1. Depois de atualizar seus scripts, legacy = 0 defina para alternar para a saída v2.

Visão geral do

Linha do tempo

Event Prazo
plugin v2 (dnf-plugin-support-info 2.0) disponível Agora
O plug-in vem com legacy = 1 (saída compatível com v1) Versão inicial da v2
Alterações padrão em legacy = 0 Uma futura versão trimestral do AL2023
formato v1 não é mais mantido Após o período de transição

O que você precisa fazer

Se você tiver scripts que analisam a saída do console, a saída XML ou leem o arquivo XML do disco, atualize-os para lidar com os novos nomes de campo, estrutura e caminhos de arquivo. Se você usar--showjson, seus scripts não precisarão de alterações, pois a saída JSON é idêntica entre v1 e v2. Se você ler o arquivo XML diretamente do disco, mude para o download do XML do configurado baseurl ou usadodnf supportinfo --show installed --showxml.

Alterações significativas que exigem ação

Se você analisar a saída do console

Campos de detalhes

O plug-in alterou os rótulos de campo exibidos quando você consulta um pacote específico:

rótulo v1 rótulo v2 Observações
Status do suporte Status atual Renomeado
Período de suporte Cronograma de suporte Renomeado, movido para o final da saída
Declaração de suporte (removido) Não é mais exibido
Link Link Inalterado (mostrado quando disponível)
Outras informações Outras informações Inalterado (mostrado quando disponível)
(não presente) Prioridade do patch Novo campo
(não presente) Descrição do nível de suporte Novo campo
(não presente) Gravidades cobertas Novo campo
(não presente) Origem Novo campo

A coluna do rótulo do campo agora tem 28 caracteres de largura (anteriormente 20).

v1: dnf supportinfo --pkg apr

Name                 : apr
Version              : 1.7.5-1.amzn2023.0.4
State                : available
Support Status       : supported
Support Periods      : from 2023-03-15      : supported
                     : from 2029-06-30      : unsupported
Support Statement    : Amazon Linux 2023 end-of-life
Link                 : https://aws.amazon.com/amazon-linux-ami/faqs/
Other Info           : This is the support statement for AL2023. The end-of-life
                     : of Amazon Linux 2023 is June 2029. From this point, the
                     : Amazon Linux 2023 packages will no longer receive any
                     : updates from AWS.

v2: dnf supportinfo --pkg apr

Name                         : apr
Version                      : 1.7.5-1.amzn2023.0.4
State                        : available
Current Status               : Supported
Patch Priority               : Full Support
Support Level Description    : Full security and bug fix support for all severities
Covered Severities           : Low, Medium, Important, Critical
Origin                       : Amazon Linux 2023 Core
Support Timeline             : from 2023-03-15     : supported
                             : from 2029-06-30     : unsupported

Colunas da tabela

A tabela de resumo foi alterada de 6 colunas para 7. A tabela v2 também exibe uma linha de cabeçalho (v1 não):

coluna v1 coluna v2 Alteração
Nome Pacote Renomeado
Versão Versão Inalterado
Estado Estado Inalterado
Status do suporte Status atual Renomeado
(não presente) Nível de suporte Nova coluna
Data (como2029-06-30) Até (próxima fase) (como2029-06-30 (end_of_support)) Renomeado, formato alterado
Observação Observação Inalterado
Importante

A coluna de data agora inclui o nome da próxima fase entre parênteses. Se você analisar esse campo, atualize sua lógica regex ou delimitadora.

v1: dnf supportinfo --show installed

iproute              6.10.0-319.amzn2023.0.1    installed    supported    2029-06-30    Kernel6.18 has security support until June 2029
kernel6.12           6.12.90-120.164.amzn2023   installed    supported    2029-06-30    Kernel6.12 has security support until June 2029

v2: dnf supportinfo --show installed

Package                          Version                            State        Support Level    Current Status         Until (Next Phase)           Note
alternatives                     1.15-2.amzn2023.0.2                installed    Full Support     Supported              2029-06-30 (unsupported)
amazon-linux-repo-cdn            2023.12.20260611-0.amzn2023        installed    Full Support     Supported              2029-06-30 (unsupported)
redis6                           6.2.20-2.amzn2023.0.1              installed    End of Support   End of Life                                         Upstream end-of-life for Redis 6 (redis6) is 2026-01-31

Se você analisar a saída --showxml

A --showxml saída v2 usa uma estrutura XML diferente da v1. O <package_support> elemento raiz é o mesmo, mas os elementos secundários, os atributos e a hierarquia foram alterados.

v1: dnf supportinfo --pkg apr --showxml

<?xml version="1.0" ?>
<package_support current_as="2026-06-18">
  <statements>
    <statement id="eol" marker="supported" start_date="2023-03-15" end_date="2029-06-30">
      <summary>Amazon Linux 2023 end-of-life</summary>
      <text>This is the support statement for AL2023. The end-of-life of Amazon
Linux 2023 is June 2029. From this point, the Amazon Linux 2023 packages will
no longer receive any updates from AWS.</text>
      <link>https://aws.amazon.com/amazon-linux-ami/faqs/</link>
      <packages>
        <package name="apr" nevra="1.7.5-1.amzn2023.0.4"/>
      </packages>
    </statement>
  </statements>
</package_support>

v2: dnf supportinfo --pkg apr --showxml

<?xml version='1.0' encoding='utf-8'?>
<package_support current_as="2026-06-18">
  <statements>
    <statement id="eol_lc" current_phase="supported">
      <phases>
        <phase name="supported" start_date="2023-03-15">
          <patch_priority>Full Support</patch_priority>
          <support_level_description>Full security and bug fix support for all severities</support_level_description>
          <covered_severities>Low, Medium, Important, Critical</covered_severities>
        </phase>
        <phase name="unsupported" start_date="2029-06-30">
          <patch_priority>End of Support</patch_priority>
          <support_level_description>End of support - no further updates</support_level_description>
        </phase>
      </phases>
      <packages>
        <package name="apr" nevra="1.7.5-1.amzn2023.0.4" state="available" origin="Amazon Linux 2023 Core"/>
      </packages>
    </statement>
  </statements>
</package_support>

Principais diferenças estruturais:

  • v1 usamarker,start_date, end_date atributos em <statement> com<summary>,<text>, children <link>

  • A v2 usa current_phase atributos e <phases> elementos aninhados com detalhes do nível de suporte

  • v2 omite <covered_severities> inteiramente quando vazia (em vez de um elemento vazio)

  • Os elementos do pacote v2 incluem state e atributos origin

  • v2 não inclui <summary> nem elementos <text> <link>

Se você ler o arquivo XML diretamente do disco

O plug-in v1 empacotou seu arquivo de dados em:

/usr/lib/python*/site-packages/dnf-plugins/support_info.xml
Atenção

Esse arquivo não é mais atualizado quando legacy = 0 entra em vigor. Não confie nesse caminho para obter dados atuais.

O plug-in v2 armazena dados em cache /var/cache/dnf/support-info/ quando executado como root. Quando executado como um usuário não root, ele usa/var/tmp/dnf-username-*/support-info/, seguindo a convenção padrão do DNF para diretórios temporários por usuário. Os arquivos nesses diretórios usam nomes de arquivo endereçados ao conteúdo e não são estáveis. Não os analise diretamente.

Alternativas recomendadas:

  1. Baixe o XML diretamente do URL configurado:

    https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

  2. Use a CLI para obter saída estruturada para pacotes instalados:

    dnf supportinfo --show installed --showxml

Se você filtrar com --show

Os valores aceitos pelo --show filtro foram alterados:

valores de filtro v1 valores de filtro v2
supported full_support
unsupported eos

Os filtros v1 são nomes de fase (supported,unsupported). Os filtros v2 são nomes de nível de suporte (full_support,eos, etc.).

Execute --list-filters para descobrir os valores de filtro disponíveis em seu sistema:

dnf supportinfo --list-filters

O que não muda

Depois de instalar a dnf-plugin-support-info v2, o seguinte permanece o mesmo, independentemente da legacy configuração:

  • --showjsonsaída. A saída JSON é idêntica, legacy seja ela 0 ou1, porque o plug-in se normaliza para a estrutura interna da v2 antes da formatação.

  • Argumentos da CLI. Todos os sinalizadores (--pkg--show,--showxml,--showjson,--clean-cache,--list-filters,--sync) funcionam nos dois modos.

  • Nome do comando. Você ainda corrednf supportinfo.

nota

Os --sync sinalizadores --showjson --clean-cache--list-filters,, e são novos na v2 e não estão disponíveis na v1.

Período de transição

O plugin v2 vem com legacy = 1 in/etc/dnf/plugins/supportinfo.conf. Durante esse período:

  1. O plug-in baixa os dados da v2 do URL configurado.

  2. A saída do console, a saída XML e os valores do filtro continuam se comportando como v1.

  3. O arquivo XML no formato v1 permanece disponível no caminho antigo para que os scripts existentes continuem funcionando.

Em uma futura versão trimestral do AL2023, o padrão muda para. legacy = 0 Nesse ponto:

  • A saída do console usa nomes e estrutura de campo v2.

  • --showxmlproduz o novo formato baseado em fases.

  • --showos valores do filtro são alterados para oferecer suporte aos nomes dos níveis.

  • O arquivo XML v1 no caminho antigo não é mais atualizado.

Para manter temporariamente a saída compatível com v1, legacy = 1 defina: /etc/dnf/plugins/supportinfo.conf

[main]
legacy = 1
Importante

A legacy = 1 opção é uma ponte temporária. Planeje migrar suas ferramentas para a saída v2 em vez de confiar nessa configuração indefinidamente.