Como o plug-in usa esse arquivo Exemplo mínimo completo Referência do elemento Integridade referencial

SupportInfo Estrutura XML

Esta página documenta o esquema XML v1.0 usado para definir ciclos de vida, cronogramas e classificações de suporte a pacotes para distribuições Linux. O esquema é independente do DNF e não é específico para nenhuma distribuição única. Você pode consumi-lo diretamente de qualquer ferramenta. O dnf supportinfo plugin é um desses consumidores.

Definição de esquema (XSD): https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd
Dados de suporte (XML): https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Para analisar esse XML diretamente, use a amazon-linux-supportinfo biblioteca de código aberto, que implementa o esquema descrito nesta página, em vez de escrever um analisador personalizado.

Como o plug-in usa esse arquivo

A partir desse arquivo, o plug-in relata:

Em qual nível de suporte um pacote se encontra (esses valores preenchem as opções de --show filtro)
Quando as fases do ciclo de vida mudam (exibidas na --pkg saída e na linha do tempo)
Prioridade de patches e cobertura de severidade para cada nível de suporte
De onde vem a embalagem (origem e classificação)

Exemplo mínimo completo

Este exemplo mostra a estrutura mínima com todas as seções necessárias e um pacote:


<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">
  <lifecycles>
    <lifecycle name="default_lc"
               display_name="AL2023 Standard Lifecycle"
               description="Standard support lifecycle for Amazon Linux 2023 packages">
      <phase name="full_support"
             support_level="default"
             start_milestone="AL2023_GA"
             display_name="Full Support"/>
      <phase name="end_of_support"
             support_level="eos"
             start_milestone="AL2023_EOS"
             display_name="End of Support"/>
    </lifecycle>
  </lifecycles>

  <support_milestones>
    <milestone name="AL2023_GA" date="2023-03-15"
               display_name="AL2023 General Availability"
               description="Amazon Linux 2023 general availability date"/>
    <milestone name="AL2023_EOS" date="2029-06-30"
               display_name="AL2023 End of Support"
               description="End of all support for Amazon Linux 2023"/>
  </support_milestones>

  <support_levels>
    <support_level name="default"
                   severities="Low,Medium,Important,Critical"
                   description="Full security and bug fix support for all severities"
                   display_name="Default Support" />
    <support_level name="eos"
                   severities=""
                   description="End of support - no further updates"
                   display_name="End of Support" />
  </support_levels>

  <packages>
    <package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
  </packages>

  <package_classes>
    <package_class name="default">
      <summary>Default class for Amazon Linux packages</summary>
      <text></text>
    </package_class>
  </package_classes>

  <package_origins>
    <package_origin name="al2023_core"
                    repo_id="amazonlinux"
                    dist="amzn2023"
                    vendor="amazonlinux"
                    display_name="Amazon Linux 2023 Core"
                    description="Core Amazon Linux 2023 repository" />
  </package_origins>

  <notes>
    <note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>
  </notes>
</package_support>

Referência do elemento

`package_support` (elemento raiz)

O elemento raiz que contém todos os metadados de suporte.

Atributo	Obrigatório	Descrição
`schema_version`	Sim	Versão do formato do esquema (atualmente`1.0`)
`current_as`	Sim	Carimbo de data/hora ISO quando os dados de suporte foram gerados pela última vez


<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

O current_as carimbo de data/hora aparece na saída para indicar a atualização dos dados.

`ciclo de vida`

Define uma sequência de fases pelas quais um pacote passa ao longo do tempo.

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador exclusivo referenciado por `package@lifecycle`
`note`	Não	Referencia `note@name` a para contexto adicional
`display_name`	Não	Customer-facing rótulo
`description`	Não	Human-readable descrição


<lifecycle name="redis6_lc" note="eol_redis6"
           display_name="Redis 6 Lifecycle"
           description="Support lifecycle for Redis 6 packages">
  <phase .../>
</lifecycle>

O plug-in percorre as fases em ordem, encontra a que está ativa no momento e relata o nível de suporte dessa fase na saída.

`phase`

Define um estágio dentro de um ciclo de vida. Cada fase continua até o início da próxima fase (ou indefinidamente, se for a última fase).

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador de fase (exclusivo em seu ciclo de vida)
`support_level`	Sim	Referências a `support_level@name`
`start_date`	Condicional	Data ISO fixa (`YYYY-MM-DD`). Use isso ou `start_milestone`
`start_milestone`	Condicional	Referências `milestone@name` a. Use isso ou `start_date`
`display_name`	Não	Customer-facing rótulo

nota

Especifique exatamente um dos dois start_date ou start_milestone não ambos.


<phase name="limited_support"
       support_level="limited"
       start_milestone="AL2023_6months"
       display_name="Limited Support"/>

Cada fase está ativa desde a data de início até o início da próxima fase. A última fase de um ciclo de vida permanece ativa indefinidamente.

`marco`

Define um marcador de data reutilizável ao qual as fases do ciclo de vida fazem referência.

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador exclusivo referenciado por `phase@start_milestone`
`date`	Sim	Data ISO (`YYYY-MM-DD`)
`display_name`	Não	Customer-facing rótulo
`description`	Não	Human-readable descrição


<milestone name="AL2023_GA" date="2023-03-15"
           display_name="AL2023 General Availability"
           description="Amazon Linux 2023 general availability date"/>

Os marcos permitem que as fases compartilhem datas. Quando a data de um marco é alterada, todas as fases que fazem referência a ele são atualizadas automaticamente.

`nível_de_suporte`

Define um nível de suporte e as severidades que ele cobre. Cada um name se torna um valor --show de filtro válido.

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador exclusivo. Usado como valor do `--show` filtro
`severities`	Sim	Comma-separated níveis de severidade cobertos (string vazia = sem patches)
`description`	Sim	Human-readable descrição mostrada na `--list-filters` saída
`display_name`	Não	Customer-facing rótulo


<support_level name="limited"
               severities="Important,Critical"
               description="Security fixes for Important and Critical severities only"
               display_name="Limited Support" />

A execução dnf supportinfo --show limited lista todos os pacotes atualmente nesse nível de suporte. O --list-filters comando exibe o name e. de cada níveldescription.

`pacote`

Mapeia o nome de um pacote RPM de acordo com seu ciclo de vida, origem e classe.

Atributo	Obrigatório	Descrição
`name`	Sim	Nome do pacote RPM
`lifecycle`	Sim	Referências a `lifecycle@name`
`origin`	Sim	Referências a `package_origin@name`
`package_class`	Não	Referências a `package_class@name`


<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>

nota

Um pacote pode aparecer várias vezes com origin valores diferentes (por exemplo, o mesmo pacote em repositórios principais e SPAL). A combinação de name + origin deve ser exclusiva.

Cada RPM instalado é comparado a essa lista para determinar seu ciclo de vida e o status atual do suporte.

`classe_pacote`

Categoriza os pacotes por sua função no sistema. O nome e o resumo da classe aparecem na saída do plug-in.

Attribute/Element	Obrigatório	Descrição
`@name`	Sim	Identificador exclusivo referenciado por `package@package_class`
`summary`(criança)	Sim	Breve descrição da categoria
`text`(criança)	Sim	Descrição estendida. O elemento deve estar presente, mas pode estar vazio


<package_class name="os_dependency">
  <summary>Packages supported only as dependencies of the operating system</summary>
  <text></text>
</package_class>

O nome da classe aparece na saída para indicar a função de um pacote no sistema.

`origem_do_pacote`

Identifica a origem do repositório de um pacote. O origin valor aparece na dnf supportinfo --pkg saída.

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador exclusivo referenciado por `package@origin`
`repo_id`	Sim	ID do repositório DNF
`dist`	Sim	Identificador de distribuição
`vendor`	Sim	Fornecedor de pacotes
`signing_key`	Não	Identificador de chave de assinatura GPG
`display_name`	Não	Customer-facing rótulo
`description`	Não	Human-readable descrição


<package_origin name="al2023_core"
                repo_id="amazonlinux"
                dist="amzn2023"
                vendor="amazonlinux"
                display_name="Amazon Linux 2023 Core"
                description="Core Amazon Linux 2023 repository" />

O display_name aparece como o campo “Origem” na --pkg saída.

`note`

Fornece texto de formato livre que um ciclo de vida pode referenciar para contexto adicional.

Atributo	Obrigatório	Descrição
`name`	Sim	Identificador exclusivo referenciado por `lifecycle@note`

O conteúdo do texto do elemento contém a mensagem da nota.


<note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>

Quando o ciclo de vida de um pacote faz referência a uma nota, o texto da nota aparece como “Nota do pacote” na --pkg saída.

Integridade referencial

O esquema vincula elementos por meio de name referências. Cada atributo de origem deve corresponder ao name de um elemento de destino existente:

Atributo de origem	Referências
`package@lifecycle`	`lifecycle@name`
`package@origin`	`package_origin@name`
`package@package_class`	`package_class@name`
`phase@support_level`	`support_level@name`
`phase@start_milestone`	`milestone@name`
`lifecycle@note`	`note@name`

Além disso, a combinação de package@name e package@origin deve ser exclusiva em todos os package elementos.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Migrando v1 para v2

Linguagens de programação e tempos de execução

SupportInfo Estrutura XML

Tópicos

Como o plug-in usa esse arquivo

Exemplo mínimo completo

Referência do elemento

package_support (elemento raiz)

ciclo de vida

phase

nota

marco

nível_de_suporte

pacote

nota

classe_pacote

origem_do_pacote

note

Integridade referencial

`package_support` (elemento raiz)

`ciclo de vida`

`phase`

`marco`

`nível_de_suporte`

`pacote`

`classe_pacote`

`origem_do_pacote`

`note`