Pré-requisitos Conceitos básicos Pacotes de consulta Pacotes de filtro Saída estruturada Gerenciar o cache Non-root Uso Referência da configuração Referência de campos de saída Schema Migração do plug-in legado Solução de problemas Recursos adicionais

Usar o informações de suporte do dnf Plug-in

O dnf-plugin-support-info pacote fornece o dnf supportinfo comando para AL2023. Use esse comando para consultar informações de suporte e ciclo de vida para pacotes: descubra se um pacote é suportado atualmente, quais níveis de gravidade recebem patches e quando o status do suporte muda.

Para obter uma visão resumida de todas as declarações de suporte do pacote, consulte as Declarações de suporte do AL2023 nas notas de lançamento do AL2023.

Importante

O plugin v2 vem com legacy = 1 in/etc/dnf/plugins/supportinfo.conf. Nesse modo, a saída usa os nomes e o formato dos campos v1. Em uma futura versão trimestral do AL2023, o padrão muda paralegacy = 0, mudando para o formato de saída v2 documentado nesta página. Para começar a usar a saída v2 agora, defina legacy = 0 em sua configuração. Para obter detalhes sobre o que muda, consulteMigrar a partir de dnf-plugin-support-info v1 para v2.

Pré-requisitos

Instância AL2023
O dnf-plugin-support-info pacote (disponível nos repositórios AL2023 padrão)
Não são necessários privilégios de root (exceto --sync no modo Migração do plug-in legado legado)

Conceitos básicos

Instale o plug-in .


sudo dnf install dnf-plugin-support-info

Consulte um pacote para verificar a instalação.


dnf supportinfo --pkg glibc

A saída mostra o status e o cronograma de suporte do pacote:


Name                         : glibc
Version                      : 2.34-231.amzn2023.0.4
State                        : installed
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

Pacotes de consulta

Passe --pkg com um ou mais nomes de pacotes para exibir suas informações de suporte.


dnf supportinfo --pkg PACKAGE [PACKAGE ...]

Para consultar um pacote específico

O dnf supportinfo exemplo a seguir consulta um pacote que chegou ao fim da vida útil:


dnf supportinfo --pkg php8.1


Name                         : php8.1
Version                      : 8.1.34-1.amzn2023.0.1
State                        : available
Current Status               : End of Life
Patch Priority               : End of Support
Support Level Description    : End of support - no further updates
Origin                       : Amazon Linux 2023 Core
Support Timeline             : from 2023-03-15     : supported
                             : from 2025-12-31     : unsupported
Package Note                 : Upstream end-of-life for PHP 8.1 (php8.1) is 2025-12-31

Para consultar vários pacotes


dnf supportinfo --pkg glibc bash openssl

Pacotes de filtro

O --show sinalizador filtra pacotes por estado, nível de suporte ou ambos.


dnf supportinfo --show FILTER [FILTER ...]

Tipos de filtro

Categoria	Valores	Fonte
Filtros de estado (fixos)	`installed`, `available`, `unavailable`, `all`	Construído no plugin
Filtros de nível de suporte (dinâmicos)	Varia. Por exemplo`full_support`, `eos`	Carregado a partir de `<support_level>` entradas no XML de informações de suporte

nota

Os filtros de nível de suporte são dinâmicos. Eles vêm diretamente dos dados XML de informações de suporte definidos pelo fornecedor do sistema operacional. Os valores disponíveis dependem do que o AL2023 define atualmente. Execute --list-filters para ver o conjunto atual de valores de filtro válidos. Para obter informações sobre como esses níveis são declarados, consulteSupportInfo Estrutura XML.

Lógica do filtro

Vários filtros de estado combinam com OR: --show installed available corresponde aos pacotes que estão instalados OU disponíveis.
Vários filtros de nível de suporte se combinam com OR: --show full_support eos combina pacotes no nível de eos suporte full_support OR.
Quando você combina os dois tipos, eles se combinam com AND: --show installed eos combina pacotes que estão instalados AND no nível de eos suporte.

nota

Se existir um nome de filtro nas categorias de estado e de nível de suporte, o plug-in corresponderá a ambas. Use a sintaxe do prefixo para desambiguar: ou. state:NAME support:NAME

Para listar os filtros disponíveis

Execute --list-filters para ver todos os valores de filtro válidos agrupados por categoria:


dnf supportinfo --list-filters

Resultado do exemplo:


State filters:
  all                  - All packages (installed, available, and unavailable)
  available            - Packages available in repositories but not installed
  installed            - Packages currently installed on the system
  unavailable          - Packages in support info but not in any repository

Support level filters:
  eos                  - End of support - no further updates
  full_support         - Full security and bug fix support for all severities

Para filtrar pacotes instalados


dnf supportinfo --show installed

A saída lista cada pacote em uma tabela com seu nível de suporte e status atual:


Package                          Version                            State        Support Level    Current Status         Until (Next Phase)           Note
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
bash                             5.2.15-1.amzn2023.0.2              installed    Full Support     Supported              2029-06-30 (unsupported)
glibc                            2.34-231.amzn2023.0.1              installed    Full Support     Supported              2029-06-30 (unsupported)
...

Para filtrar pacotes instalados em um nível de suporte específico


dnf supportinfo --show installed eos

Para usar a sintaxe do prefixo para desambiguação


dnf supportinfo --show state:installed support:full_support

Saída estruturada

Para criação de scripts e automação, além de --showxml produzir --showjson resultados legíveis por máquina.

Para obter a saída JSON


dnf supportinfo --pkg nodejs20 --showjson

A saída contém a fase atual, a origem e o cronograma completo do pacote, com detalhes do nível de suporte:


{
  "name": "nodejs20",
  "version": "20.20.2-1.amzn2023.0.2",
  "state": "available",
  "current_phase": "unsupported",
  "origin": "Amazon Linux 2023 Core",
  "phases": [
    {
      "name": "supported",
      "start_date": "2023-10-24",
      "patch_priority": "Full Support",
      "support_level_description": "Full security and bug fix support for all severities",
      "covered_severities": "Low, Medium, Important, Critical"
    },
    {
      "name": "unsupported",
      "start_date": "2026-04-30",
      "patch_priority": "End of Support",
      "support_level_description": "End of support - no further updates"
    }
  ],
  "note": "Upstream end-of-life for Node.js 20 (nodejs20) is 2026-04-30"
}

Para obter a saída XML


dnf supportinfo --pkg nodejs20 --showxml

A saída é um documento XML com uma <package_support> raiz contendo um <statement> elemento por ciclo de vida, cada um com suas fases, datas de início e detalhes do nível de suporte. Para obter a referência completa do esquema, consulteSupportInfo Estrutura XML.

Gerenciar o cache

O plug-in armazena em cache o XML das informações de suporte localmente para reduzir as solicitações de rede.

Comportamento do cache

Quando o cache expirar:

O plug-in verifica se o arquivo remoto foi alterado (usando HTTP ETag).
Se inalterado, ele estende o cache sem precisar baixar novamente.
Se alterado, ele baixa o arquivo atualizado.
Em caso de erros de rede, ele volta para o arquivo em cache, se houver.

Para sincronizar o cache

Baixe e armazene em cache os dados de informações de suporte mais recentes:


dnf supportinfo --sync

Use isso para automação e cron jobs que precisam de dados de suporte atualizados sem executar uma consulta completa.

Para limpar o cache


dnf supportinfo --clean-cache

Non-root Uso

Todos os comandos funcionam sem privilégios de root. Quando executado como root, o cache é armazenado em/var/cache/dnf/support-info/. Quando executado como um usuário não root, o cache vai para/var/tmp/dnf-username-*/support-info/. Isso segue a convenção padrão do DNF para diretórios temporários por usuário.

nota

Se você ativar o modo legado, execute sudo dnf supportinfo --sync uma vez para criar o arquivo legado. Depois disso, as consultas não raiz funcionam normalmente.

Referência da configuração

O plug-in lê a configuração de/etc/dnf/plugins/supportinfo.conf. O exemplo a seguir mostra a configuração recomendada com o modo legado desativado:


[main]
# Required: URL to support info XML (DNF variables like $awsregion are resolved)
baseurl = https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

# Optional: XSD schema for validation
templateurl = https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd

# Optional: Cache duration in seconds (default: 1800 = 30 minutes)
metadata_expire = 1800

# Legacy mode (default: 1). Set to 0 to use v2 format.
legacy = 0

Opção	Description	Padrão
`baseurl`	URL para o arquivo XML de informações de suporte. Suporta variáveis DNF, como`$awsregion`.	Obrigatório
`templateurl`	URL do esquema XSD para validação.	Nenhum
`metadata_expire`	Duração do cache em segundos. Use `-1` para infinito, `0` para sempre verificar.	`1800`
`legacy`	Ative a saída compatível com v1. Definido como `1` ou`0`. Consulte Migração do plug-in legado.	`1`

Referência de campos de saída

Campo	Description
Nome	Nome do pacote
Versão	Versão instalada ou disponível
Estado	`installed`, `available` ou `unavailable`
Status atual	Fase atual do ciclo de vida, como ou `Supported` `End of Life`
Prioridade do patch	Nome do nível de suporte
Descrição do nível de suporte	Human-readable descrição do nível de suporte
Gravidades cobertas	Níveis de severidade de segurança que recebem patches
Origem	Repositório que fornece o pacote
Cronograma de suporte	Lista cronológica das fases do ciclo de vida com datas
Nota de embalagem	Contexto adicional, como datas de EOL anteriores

Schema

O formato de dados de informações de suporte é definido por um esquema XSD. Use esse esquema para validar ferramentas personalizadas que consomem diretamente o XML das informações de suporte:


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

Migração do plug-in legado

Se você já usou uma versão anterior do dnf-plugin-support-info pacote, o novo plug-in v2 é fornecido legacy = 1 por padrão para manter a compatibilidade com versões anteriores. Em uma futura versão trimestral do AL2023, as alterações padrão legacy = 0 e a saída mudarão para o formato v2 documentado nesta página.

Se você tiver scripts ou ferramentas que analisam a saída do plug-in ou leem diretamente o arquivo XML legado, consulte Migrar a partir de dnf-plugin-support-info v1 para v2 uma lista completa de diferenças, before/after exemplos e uma lista de verificação de migração passo a passo.

Para manter o comportamento legado após a transição, legacy = 1 prepare-se/etc/dnf/plugins/supportinfo.conf. Essa é uma medida temporária. O modo legado requer privilégios de root --sync e será removido em uma versão futura.

Solução de problemas

Dados de cache obsoletos

Sintoma: os resultados da consulta mostram informações de suporte desatualizadas.

Resolução: sincronize o cache manualmente:


dnf supportinfo --sync

Se o problema persistir, limpe e sincronize novamente:


dnf supportinfo --clean-cache
dnf supportinfo --sync

Arquivo legado não encontrado

Sintoma: Scripts lidos /usr/lib/python*/site-packages/dnf-plugins/support_info.xml falham com “arquivo não encontrado”.

Resolução: o plug-in cria o arquivo legado somente quando você define legacy = 1 e executa pelo --sync menos uma vez:


sudo dnf supportinfo --sync

Selegacy = 0, o arquivo não é mais mantido. Em vez disso, migre seus scripts para usar --showjson ou --showxml produzir. Para ver as etapas de migração, consulteMigrar a partir de dnf-plugin-support-info v1 para v2.

Recursos adicionais

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

Plugin de informações de suporte

Migrando v1 para v2