Nesta página, você verá como o controle de versão do Cloud Composer funciona. Com ele, é possível selecionar uma versão de imagem do Cloud Composer ao criar um ambiente.
Para executar o Apache Airflow com perfeição, o Cloud Composer cria imagens do Docker que combinam versões baunilha do Airflow com outros binários comuns e bibliotecas Python. As imagens incluem modificações do Airflow que são específicas para o Cloud Composer e inadequadas para uso no codebase upstream do Airflow. Os pacotes pré-instalados e as alterações específicas do Airflow do Cloud Composer são chamados coletivamente de composer-addon
. Periodicamente, o Cloud Composer libera imagens que incluem novas versões do Airflow e melhorias do composer-addon
.
Suporte das versões do Airflow
O Airflow segue o esquema semântico do controle de versão de softwares. O Cloud Composer é compatível com as duas últimas versões secundárias estáveis do Airflow e as duas versões de patch mais recentes delas. Por exemplo, se a versão mais recente do Airflow for X.Y.Z, o Cloud Composer será compatível com estas:
- X.Y.Z e X.Y.Z-1: as duas versões de patch mais recentes da secundária X.Y.
- X.Y-1 e X.Y-2: as duas últimas versões secundárias estáveis. Ignoramos o número do patch e supomos que o patch é o último número daquela versão secundária específica.
Esquema de versões
Além das versões baunilha do Airflow, a imagem do Cloud Composer inclui algumas bibliotecas e binários comuns como open-jdk, mysql e google-cloud-storage. O esquema de controle de versões de imagem do Cloud Composer a seguir captura o composer-addon
e as versões do Airflow:
composer-a.b.c-airflow-x.y.z
Em que
composer-a.b.c
é a versão das personalizações gerenciadas pelo Cloud Composer;airflow-x.y.z
é a versão básica do Airflow.
Aliases e sinalizações de versão
No momento, o Cloud Composer é compatível com as versões de imagem do Cloud Composer fixadas com a versão mais recente do composer-addon
. Ao criar um ambiente do Cloud Composer, use a sinalização --image-version
para especificar a versão do ambiente no formato composer-a.b.c-airflow-x.y.z
.
Como alternativa, use a sinalização --airflow-version
para especificar a versão do Airflow no formato airflow-x.y.z
, o que cria o ambiente usando a versão composer-addon
mais recente do Airflow especificada.
O Cloud Composer também é compatível com o uso dos aliases de versão a seguir:
composer-latest-airflow-x.y.z
especifica a versão de imagem do Cloud Composer com a versão docomposer-addon
compatível mais recente.composer-a.b.c-airflow-x.y
especifica uma versão de imagem do Cloud Composer que se expande automaticamente paracomposer-a.b.c-airflow-x.y.z
, em quez
é o número mais recente do patch.composer-latest-airflow-x.y
especifica uma versão de imagem do Cloud Composer com a versãocomposer-addon
compatível mais recente que se expande automaticamente paraairflow-x.y.z
, em quez
é o número mais recente do patch.
A criação de uma versão do ambiente do Cloud Composer com composer-latest-airflow-x.y.z
não faz um upgrade automático da versão.
Em vez disso, o Cloud Composer resolve o alias composer-latest-airflow-x.y.z
para composer-a.b.c-airflow-x.y.z
no momento da criação.
Seleção da versão
Ao criar um novo ambiente, é possível selecionar as versões do Cloud Composer e do Python que serão usadas no ambiente. Se você não selecionar uma, será utilizada a versão padrão do Cloud Composer.
Também é possível fazer upgrade do ambiente para selecionar as versões do Cloud Composer e do Airflow que serão usadas.
Para conhecer as versões disponíveis e a padrão, consulte a Lista de versões.
Compatibilidade e suspensão de uso das versões
As versões do Cloud Composer são compatíveis por um período específico após o lançamento. Durante esse tempo, os ambientes do Cloud Composer que usam essas versões são compatíveis. Depois que o tempo de compatibilidade é encerrado, o uso do Cloud Composer é suspenso. Além disso, os ambientes que executam versões obsoletas não serão mais aceitos. A compatibilidade das versões do Cloud Composer é definida assim:
- 0 a 12 meses a partir da data da versão: os ambientes do Cloud Composer que executam a versão são totalmente compatíveis.
- 12 a 18 meses a partir da data da versão: os ambientes do Cloud Composer que executam a versão não são compatíveis, exceto para notificar os clientes sobre problemas de segurança.
- Mais de 18 meses a partir da data da versão: os ambientes do Cloud Composer que executam a versão se tornam incompatíveis e são totalmente gerenciados pelo usuário.