Ciclo de vida de suporte da CLI do Azure
Todo produto da Microsoft tem um ciclo de vida. Ele começa quando o produto é lançado e termina quando ele não tem mais suporte. Conhecer datas importantes desse ciclo de vida ajuda você a tomar decisões informadas sobre quando atualizar ou fazer outras alterações no software.
O ciclo de vida de suporte da CLI do Azure foi projetado para fornecer clareza e previsibilidade para os clientes em relação ao suporte para cada versão. O tempo e o grau de suporte variam com base em algumas qualificações. O ciclo de vida de suporte da CLI do Azure segue a política de ciclo de vida moderna da Microsoft, a menos que especificado de outra forma neste artigo.
Tipos de referência
Há dois tipos de referência da CLI do Azure.
Núcleo: as referências da CLI do Azure publicadas como parte permanente da CLI são chamadas de referências "principais". Todas as referências principais são instaladas com a CLI do Azure e não é possível escolher um subconjunto de referências. Se você executar a CLI por meio do Azure Cloud Shell, as referências principais estarão sempre atualizadas.
Extensões: as extensões não são enviadas como parte da CLI, mas são executadas como comandos da CLI. Algumas extensões são uma parte permanente da CLI do Azure, mas muitas vezes, uma extensão fornece acesso a mais recursos e recursos de visualização.
Um único grupo de referência pode ter comandos core e extension. Por exemplo, no grupo de referência az vm, az vm nic add é um comando de referência principal, enquanto az vm repair create é uma extensão.
Para saber mais sobre as extensões da CLI do Azure, confira Usar e gerenciar extensões da CLI do Azure.
Controle de versão
Núcleo
A versão principal da CLI do Azure é composta por três números: major.minor.patch.
- Versões principais: grandes alterações, incluindo alterações arquitetônicas e fundamentais de design. Fornecemos correções de segurança críticas para a última versão secundária da versão principal anterior por três anos.
- Versões secundárias: atualizadas para atualizações de recursos e cobertura de serviço aprimorada do Azure.
- Versões de patch: correções compatíveis com versões anteriores sem novos recursos ou alterações de funcionalidade.
Extensões
As extensões da CLI do Azure seguem o Controle de Versão Semântico para numeração de versão. O controle de versão semântico é um sistema que usa um formato de número de três partes: major.minor.patch.
- Versões principais: alterações significativas, geralmente devido a uma alteração de API incompatível.
- Versões secundárias: atualizações de recursos compatíveis com versões anteriores ou funcionalidade adicionada.
- Versões de patch: correções compatíveis com versões anteriores sem novos recursos ou alterações de funcionalidade.
Cadência de versão
A cadência de lançamento da CLI do Azure foi projetada para fornecer aos clientes datas de lançamento previsíveis, capacitando empresas, desenvolvedores e a comunidade a tomar decisões estratégicas ao planejar seus roteiros.
O Azure CLI Core é atualizado mensalmente com um máximo de duas versões que introduzem alterações significativas. As versões de alteração interruptiva ocorrem durante o segundo e quarto trimestres de cada ano.
As extensões da CLI do Azure não têm uma cadência de versão específica e precisam ser atualizadas manualmente.
As alterações significativas podem não afetar os scripts existentes, mas é uma boa prática verificar seus scripts em um ambiente de teste antes de executar uma atualização.
Observação
A cadência de lançamento pode ser ligeiramente ajustada para estar alinhada com os principais anúncios relevantes para o Azure.
Versões de suporte de prazo padrão (STS)
As versões STS do núcleo da CLI do Azure fornecem os recursos mais recentes. As versões do STS não apresentam alterações significativas por seis meses. As alterações significativas são lançadas no segundo e quarto trimestres do ano civil e geralmente se alinham com o Microsoft Build e o Microsoft Ignite.
As versões STS têm as seguintes características:
- As versões do STS são lançadas mensalmente e recebem atualizações de recursos, correções de bugs e correções de segurança.
- Para que uma versão do STS seja suportada, você precisa estar na versão secundária mais recente da versão do STS.
- As versões do STS não têm um marcador específico ao executar o
az versioncomando. Isso garante a compatibilidade com ferramentas ou scripts que podem utilizar as informações.
Versões de suporte de longo prazo (LTS)
As versões LTS do Azure CLI Core fornecem um período de "manutenção" de 12 meses após o período "atual". Durante esse tempo, a versão LTS não apresenta alterações significativas , a menos que seja exigido por uma correção de segurança.
As versões LTS são baseadas em versões da CLI do Azure que introduzem grandes alterações durante o segundo trimestre do ano civil. Isso geralmente se alinha com o Microsoft Build.
As versões LTS têm as seguintes características:
- Durante os primeiros seis meses, as versões LTS são lançadas mensalmente e recebem atualizações de recursos, correções de bugs e correções de segurança.
- Durante os 12 meses seguintes, as versões LTS são lançadas quando necessário e recebem apenas correções de bugs e correções de segurança.
- Para que uma versão LTS seja suportada, você precisa estar na versão mais recente da versão LTS.
Encontre facilmente a data de lançamento do LTS executando o az version comando. Observe a azure-cli-support linha que indica a data LTS.
{
"azure-cli": "2.48.0",
"azure-cli-core": "2.48.0",
"azure-cli-support": "LTS-20240521",
"azure-cli-telemetry": "1.0.8",
"extensions": {
}
}
A imagem a seguir ilustra a cadência de lançamento e o ciclo de vida de suporte da CLI do Azure para versões STS e LTS.
A tabela a seguir fornece exemplos de como a cadência da versão se correlaciona com o ciclo de vida de suporte:
Observação
As datas na tabela a seguir são apenas para fins de exemplo. As datas de lançamento reais variam.
| Número da versão | Agenda de lançamentos | Alterações da falha | Tipo de Versão | Tipo de suporte | Com suporte até a versão | Versão LTS |
|---|---|---|---|---|---|---|
| 2.61.0 | Maio de 2024 | Yes | Principal | STS | 2.62.0 | |
| 2.62.0 | Junho de 2024 | Secundária | STS | 2.63.0 | ||
| 2.63.0 | Julho de 2024 | Secundária | STS | 2.64.0 | ||
| 2.64.0 | Agosto de 2024 | Secundária | STS | 2.65.0 | ||
| 2.65.0 | Setembro de 2024 | Secundária | STS | 2.66.0 | ||
| 2.66.0 | Outubro de 2024 | Secundária | LTS | 2.79.0 | 2.66.0 | |
| 2.67.0 | Novembro de 2024 | Yes | Principal | STS | 2.68.0 | 2.66.x |
| 2.68.0 | Dezembro de 2024 | Secundária | STS | 2.69.0 | 2.66.x | |
| 2.69.0 | Janeiro de 2025 | Secundária | STS | 2.70.0 | 2.66.x | |
| 2.70.0 | Fevereiro de 2025 | Secundária | STS | 2.71.0 | 2.66.x | |
| 2.71.0 | Março de 2025 | Secundária | STS | 2.72.0 | 2.66.x | |
| 2.72.0 | Abril de 2025 | Secundária | STS | 2.73.0 | 2.66.x | |
| 2.73.0 | Maio de 2025 | Yes | Principal | STS | 2.74.0 | 2.66.x |
| 2.74.0 | Junho de 2025 | Secundária | STS | 2.75.0 | 2.66.x | |
| 2.75.0 | Julho de 2025 | Secundária | STS | 2.76.0 | 2.66.x | |
| 2.76.0 | Julho 2025 | Secundária | STS | 2.77.0 | 2.66.x | |
| 2.77.0 | Setembro de 2025 | Secundária | STS | 2.78.0 | 2.66.x | |
| 2.78.0 | Outubro de 2025 | Secundária | STS | 2.79.0 | 2.66.x | |
| 2.79.0 | Novembro de 2025 | Sim | Principal | LTS | 2.91.0 | 2.79.0 |
| 2.80.0 | Dezembro de 2025 | Sim | Secundária | STS | 2.81.0 | 2.79.x |
Exemplos:
- Para se qualificar para o suporte, você deve atualizar para 2.63.0 quando lançado se tiver a CLI do Azure 2.62.0 instalada.
- Se a CLI do Azure 2.66.0 for a última versão da CLI do Azure antes de interromper a alteração no quarto trimestre do ano civil, ela terá suporte até o lançamento da CLI do Azure 2.79.0.
Alterações da falha
As versões principais da CLI do Azure introduzem alterações significativas e ocorrem até duas vezes por ano. Alterações significativas podem ocorrer a qualquer momento para extensões de visualização. As extensões não GA não precisam aderir às políticas de alteração significativa.
Para obter informações detalhadas sobre alterações significativas na CLI do Azure, consulte Notas de versão.
Ambientes com suporte
A CLI do Azure é executada em vários sistemas operacionais (SO) e arquiteturas. Para obter uma lista completa, consulte Instalar a CLI. Para ter suporte da Microsoft, os seguintes critérios devem ser atendidos:
- Há suporte para a versão da CLI do Azure.
- A versão do sistema operacional está atualmente em suporte principal pelo editor do sistema operacional.
- As dependências exigidas pela versão atual da CLI do Azure têm suporte no sistema operacional.
A CLI do Azure encerra o suporte para uma plataforma quando uma das seguintes condições é atendida:
- O sistema operacional chega ao fim de sua vida útil, conforme definido pelo proprietário da plataforma.
- A versão do Python exigida pela CLI do Azure chega ao fim da vida útil, não tem mais suporte no sistema operacional ou tem um problema de segurança crítico não corrigido.
A CLI do Azure anuncia o fim do suporte de um sistema operacional ou de uma de suas dependências dentro de três meses após o anúncio público da desativação.
Dependência do Python
A CLI do Azure depende do Python versão 3.8 ou superior. A tabela a seguir resume o fim esperado do suporte para cada versão do Python:
| Versão do Python | Data de fim do suporte |
|---|---|
| 3.8 | Outubro de 2024 |
| 3.9 | Outubro de 2025 |
| 3.10 | Outubro de 2026 |
| 3.11 | Outubro de 2027 |
A CLI do Azure só pode ter suporte em sistemas operacionais em que há suporte para as versões acima do Python.
- Windows: as versões atualmente suportadas do cliente e do servidor do Windows atendem aos requisitos de versão do Python.
- macOS: a versão atualmente compatível do macOS 12 e superior atende aos requisitos de versão do Python.
- Linux:
Cada sistema operacional suportado tem um ciclo de vida definido por sua organização patrocinadora.
O suporte é normalmente removido quando um sistema operacional sai do suporte principal, momento em que paramos de testá-lo e apoiá-lo.
Aqui estão os sistemas operacionais Linux com suporte para a CLI do Azure:
Sistema operacional Versão Fim do suporte Ubuntu 20.04 LTS Abril de 2025 22.04 LTS Abril de 2027 24.04 LTS Junho de 2029 Debian 11 12 Alpine 3,17 22 de novembro de 2024 RHEL 8 31 de maio de 2029 9 31 de maio de 2032 CentOS Stream 9 Estimativa de 2027 Mariner 2,0 Observação
No RHEL 7, há suporte apenas para a CLI do Azure 2.38. A Microsoft não está mais fornecendo atualizações ou correções de bugs para esta distribuição.
