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`](https://www.freedesktop.org/software/systemd/man/latest/os-release.html) 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. **Topics** + [Principais diferenças de identificação](#ident-key-differences) + [Tipos de campos: legíveis por máquina versus legíveis por humanos](#ident-os-release-field-types) + [`/etc/os-release`Exemplos da](#ident-os-release-examples) + [Comparação com outras distribuições](#ident-other-distributions-comparison) ## 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`](https://www.freedesktop.org/software/systemd/man/latest/os-release.html) 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](#ident-os-release-field-types) 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`: data do fim do suporte no formato AAAA-MM-DD. + `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`. ## `/etc/os-release`Exemplos da 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 as relações das distribuições (o Amazon Linux usa `fedora` (AL2023) ou `centos rhel fedora` (AL2), enquanto o Ubuntu mostra `debian` para indicar sua herança do Debian). + `VERSION_ID`: fornece informações de versão analisáveis por máquina (`2023` para AL2023, `42` para Fedora, `12` para Debian, `24.04` para Ubuntu). 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.