Usar o padrão de os-release - Amazon Linux 2

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á.

Usar o padrão de os-release

O Amazon Linux está em conformidade com o padrão de os-release para a identificação de distribuições do Linux. Esse arquivo fornece informações legíveis por máquina sobre a identificação do sistema operacional e as informações da versão.

nota

O padrão determina que /etc/os-release seja analisado primeiro, seguido por /usr/lib/os-release. Deve-se tomar cuidado para seguir o padrão em relação aos nomes e caminhos dos arquivos.

Principais diferenças de identificação

O os-release é encontrado em /etc/os-release ou, se não estiver presente, em /usr/lib/os-release. Consulte o padrão de os-release para obter informações completas.

A maneira mais confiável de determinar se uma instância está executando o Amazon Linux é verificar o campo ID em os-release.

A maneira mais confiável de determinar a distinção entre as versões é verificar o campo VERSION_ID em os-release:

  • AMI do Amazon Linux: VERSION_ID contém uma versão baseada em data (por exemplo, 2018.03)

  • AL2: VERSION_ID="2"

  • AL2023: VERSION_ID="2023"

nota

Lembre-se de que VERSION_ID é um campo legível por máquina destinado ao uso programático, enquanto PRETTY_NAME é projetado para exibição aos usuários. Consulte Tipos de campos: legíveis por máquina versus legíveis por humanos para obter mais informações sobre os tipos de campos.

Tipos de campos: legíveis por máquina versus legíveis por humanos

O arquivo /etc/os-release (ou /usr/lib/os-release se /etc/os-release não existir) contém dois tipos de campos: campos legíveis por máquina, destinados ao uso programático, e campos legíveis por humanos, destinados à apresentação aos usuários.

Campos legíveis por máquina

Esses campos usam formatos padronizados e são destinados ao processamento por scripts, gerenciadores de pacotes e outras ferramentas automatizadas. Eles contêm apenas letras minúsculas, números e pontuação limitada (pontos, sublinhados e hifens).

  • ID: identificador do sistema operacional. O Amazon Linux usa amzn em todas as versões, diferenciando-o de outras distribuições, como Debian (debian), Ubuntu (ubuntu) ou Fedora (fedora).

  • VERSION_ID: versão do sistema operacional para uso programático (por exemplo, 2023).

  • ID_LIKE: lista separada por espaços de distribuições relacionadas (por exemplo, fedora).

  • VERSION_CODENAME: codinome de lançamento para scripts (por exemplo, karoo).

  • VARIANT_ID: identificador da variante para decisões programáticas.

  • BUILD_ID: identificador da compilação para imagens do sistema.

  • IMAGE_ID: identificador da imagem para ambientes em contêineres.

  • PLATFORM_ID: identificador da plataforma (por exemplo, platform:al2023).

Campos legíveis por humanos

Esses campos são destinados à exibição para os usuários e podem conter espaços, letras maiúsculas e minúsculas e texto descritivo. Eles devem ser usados ao apresentar informações do sistema operacional nas interfaces de usuário.

  • NAME: nome do sistema operacional para exibição (por exemplo, Amazon Linux).

  • PRETTY_NAME: nome completo do sistema operacional com versão para exibição (por exemplo, Amazon Linux 2023.8.20250721).

  • VERSION: informações da versão adequadas para apresentação ao usuário.

  • VARIANT: nome da variante ou edição para exibição (por exemplo, Server Edition).

Outros campos de informações

Esses campos fornecem metadados adicionais sobre o sistema operacional:

  • HOME_URL: URL da página inicial do projeto.

  • DOCUMENTATION_URL: URL da documentação.

  • SUPPORT_URL: URL de informações de suporte.

  • BUG_REPORT_URL: URL de relatórios de bugs.

  • VENDOR_NAME: nome do fornecedor.

  • VENDOR_URL: URL do fornecedor.

  • SUPPORT_END— End-of-support data em YYYY-MM-DD formato

  • CPE_NAME: identificador de enumeração de plataforma comum.

  • ANSI_COLOR: código de cores ANSI para exibição do terminal.

Ao escrever scripts ou aplicações que precisam identificar o Amazon Linux de forma programática, use os campos legíveis por máquina, como ID e VERSION_ID. Ao exibir informações do sistema operacional aos usuários, use os campos legíveis por humanos, como PRETTY_NAME.

Exemplos da /etc/os-release

O conteúdo do arquivo /etc/os-release varia entre as versões do Amazon Linux:

AL2023
[ec2-user ~]$ cat /etc/os-release
NAME="Amazon Linux"
VERSION="2023"
ID="amzn"
ID_LIKE="fedora"
VERSION_ID="2023"
PLATFORM_ID="platform:al2023"
PRETTY_NAME="Amazon Linux 2023.8.20250721"
ANSI_COLOR="0;33"
CPE_NAME="cpe:2.3:o:amazon:amazon_linux:2023"
HOME_URL="https://aws.amazon.com/linux/amazon-linux-2023/"
DOCUMENTATION_URL="https://docs.aws.amazon.com/linux/"
SUPPORT_URL="https://aws.amazon.com/premiumsupport/"
BUG_REPORT_URL="https://github.com/amazonlinux/amazon-linux-2023"
VENDOR_NAME="AWS"
VENDOR_URL="https://aws.amazon.com/"
SUPPORT_END="2029-06-30"
AL2
[ec2-user ~]$ cat /etc/os-release
NAME="Amazon Linux"
VERSION="2"
ID="amzn"
ID_LIKE="centos rhel fedora"
VERSION_ID="2"
PRETTY_NAME="Amazon Linux 2"
ANSI_COLOR="0;33"
CPE_NAME="cpe:2.3:o:amazon:amazon_linux:2"
HOME_URL="https://amazonlinux.com/"
SUPPORT_END="2026-06-30"
Amazon Linux AMI
[ec2-user ~]$ cat /etc/os-release
NAME="Amazon Linux AMI"
VERSION="2018.03"
ID="amzn"
ID_LIKE="rhel fedora"
VERSION_ID="2018.03"
PRETTY_NAME="Amazon Linux AMI 2018.03"
ANSI_COLOR="0;33"
CPE_NAME="cpe:/o:amazon:linux:2018.03:ga"
HOME_URL="http://aws.amazon.com/amazon-linux-ami/"

Comparação com outras distribuições

Para entender como o Amazon Linux se encaixa no ecossistema mais amplo do Linux, compare o formato de /etc/os-release com outras distribuições principais:

Fedora
[ec2-user ~]$ cat /etc/os-release
NAME="Fedora Linux"
VERSION="42 (Container Image)"
RELEASE_TYPE=stable
ID=fedora
VERSION_ID=42
VERSION_CODENAME=""
PLATFORM_ID="platform:f42"
PRETTY_NAME="Fedora Linux 42 (Container Image)"
ANSI_COLOR="0;38;2;60;110;180"
LOGO=fedora-logo-icon
CPE_NAME="cpe:/o:fedoraproject:fedora:42"
DEFAULT_HOSTNAME="fedora"
HOME_URL="https://fedoraproject.org/"
DOCUMENTATION_URL="https://docs.fedoraproject.org/en-US/fedora/f42/system-administrators-guide/"
SUPPORT_URL="https://ask.fedoraproject.org/"
BUG_REPORT_URL="https://bugzilla.redhat.com/"
REDHAT_BUGZILLA_PRODUCT="Fedora"
REDHAT_BUGZILLA_PRODUCT_VERSION=42
REDHAT_SUPPORT_PRODUCT="Fedora"
REDHAT_SUPPORT_PRODUCT_VERSION=42
SUPPORT_END=2026-05-13
VARIANT="Container Image"
VARIANT_ID=container
Debian
[ec2-user ~]$ cat /etc/os-release
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"
Ubuntu
[ec2-user ~]$ cat /etc/os-release
PRETTY_NAME="Ubuntu 24.04.2 LTS"
NAME="Ubuntu"
VERSION_ID="24.04"
VERSION="24.04.2 LTS (Noble Numbat)"
VERSION_CODENAME=noble
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=noble
LOGO=ubuntu-logo

Observe como os campos legíveis por máquina fornecem identificação consistente em todas as distribuições:

  • ID: identifica o sistema operacional de maneira exclusiva (amzn para Amazon Linux, fedora para Fedora, debian para Debian, ubuntu para Ubuntu).

  • ID_LIKE— Mostra relações de distribuição: Amazon Linux usa fedora (AL2023) ou centos rhel fedora (AL2), enquanto o Ubuntu mostra debian para indicar sua herança Debian

  • VERSION_ID— Fornece informações de versão analisáveis por máquina: 2023 para AL2 023, para Fedora, 42 para Debian, para Ubuntu 12 24.04

Por outro lado, os campos legíveis por humanos foram projetados para serem exibidos aos usuários:

  • NAME: nome amigável do sistema operacional (Amazon Linux, Fedora Linux, Debian GNU/Linux, Ubuntu).

  • PRETTY_NAME: nome de exibição completo com a versão (Amazon Linux 2023.8.20250721, Fedora Linux 42 (Container Image), Debian GNU/Linux 12 (bookworm), Ubuntu 24.04.2 LTS).

  • VERSION: versão legível por humanos com contexto adicional, como codinomes ou tipos de lançamento.

Ao escrever scripts multiplataforma, sempre use os campos legíveis por máquina (ID, VERSION_ID, ID_LIKE) para lógica e decisões, e use os campos legíveis por humanos (PRETTY_NAME, NAME) somente para exibir informações aos usuários.