Gerenciar atualizações de cluster gerenciado do Service Fabric
Um cluster do Azure Service Fabric é um recurso cujo proprietário é você, mas que é parcialmente gerenciado pela Microsoft. Aprenda a gerenciar quando e como a Microsoft atualiza o runtime do cluster gerenciado do Azure Service Fabric.
Definir modo de atualização
Os clusters gerenciados do Azure Service Fabric são definidos por padrão para receber atualizações automáticas do Service Fabric à medida que são liberados pela Microsoft usando uma estratégia de implantação de onda. Como alternativa, é possível configurar upgrades de modo manual nos quais você escolhe em uma lista de versões com suporte no momento. Você pode definir essas configurações por meio do controle das atualizações do Fabric no portal do Azure ou da configuração ClusterUpgradeMode no modelo de implantação de cluster.
Implantação de onda para atualizações automáticas
Com a implantação de onda, você pode criar um pipeline para atualizar seus clusters de teste, preparo e produção em sequência, separados pelo "tempo de preparação" interno para validar versões futuras do Service Fabric antes da atualização dos clusters de produção.
Observação
Por padrão, os clusters serão definidos como Ciclo 0.
Para selecionar uma implantação de onda para atualização automática, primeiro determine qual onda atribuir ao cluster:
- Onda 0 (
Wave0): os clusters são atualizados assim que um novo build do Service Fabric é liberado. - Onda 1 (
Wave1): os clusters são atualizados após a Onda 0 para permitir o tempo de bake. A Onda 1 ocorre após um mínimo de 7 dias após a Onda 0. - Onda 2 (
Wave2): os clusters são atualizados por último para permitir tempo de bake adicional. A Onda 2 ocorre após um mínimo de 14 dias após a Onda 0.
Definir a Onda para o cluster
Você pode definir o cluster para uma das ondas disponíveis por meio do controle de Atualizações do Fabric no portal do Azure ou a configuração ClusterUpgradeMode no modelo de implantação de cluster.
Portal do Azure
Usando o portal do Azure, você escolherá entre as ondas automáticas disponíveis ao criar um cluster do Service Fabric.
Você também pode alternar entre ondas automáticas disponíveis da seção Atualizações da malha de um recurso de cluster existente.
Modelo do Resource Manager
Para alterar o modo de atualização de cluster usando um modelo do Resource Manager, especifique Automático ou Manual para a propriedade ClusterUpgradeMode da definição de recurso Microsoft.ServiceFabric/clusters. Se você escolher atualizações manuais, defina também o clusterCodeVersion para uma versão de malha compatível no momento.
Atualização manual
{
"apiVersion": "2021-05-01",
"type": "Microsoft.ServiceFabric/managedClusters",
"properties": {
"clusterUpgradeMode": "Manual",
"clusterCodeVersion": "8.0.514.9590"
}
}
Após a implantação bem-sucedida do modelo, as alterações no modo de atualização do cluster serão aplicadas. Se o cluster estiver no modo manual, a atualização do cluster será iniciada automaticamente.
As políticas de integridade do cluster (uma combinação da integridade do nó e da integridade de todos os aplicativos executados no cluster) são cumpridas durante a atualização. Se as políticas de integridade do cluster não forem atendidas, a atualização será revertida.
Em caso de reversão, você precisará corrigir os problemas que resultaram na reversão e iniciar a atualização novamente seguindo as mesmas etapas de antes.
Atualização automática com implantação de onda
Para configurar atualizações Automáticas e a implantação de onda, basta adicionar/validar ClusterUpgradeMode é definido como Automatic e a propriedade clusterUpgradeCadence é definida com um dos valores de onda listados acima em seu modelo do Resource Manager.
{
"apiVersion": "2021-05-01",
"type": "Microsoft.ServiceFabric/managedClusters",
"properties": {
"clusterUpgradeMode": "Automatic",
"clusterUpgradeCadence": "Wave1"
}
}
Depois de implantar o modelo atualizado, o cluster será registrado na onda especificada para upgrades automáticos.
Consulta de versões de cluster compatíveis
Você pode usar a API REST do Azure para listar todas as versões de runtime do Service Fabric (clusterVersions) disponíveis para o local especificado e a sua assinatura.
Você também pode consultar as versões do Service Fabric para obter mais detalhes sobre versões e sistemas operacionais compatíveis.
GET https://<endpoint>/subscriptions/{{subscriptionId}}/providers/Microsoft.ServiceFabric/locations/{{location}}/managedclusterVersions?api-version=2021-05-01
"value": [
{
"id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/7.2.477.9590",
"name": "7.2.477.9590",
"type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
"properties": {
"supportExpiryUtc": "2021-11-30T00:00:00",
"osType": "Windows",
"clusterCodeVersion": "7.2.477.9590"
}
},
{
"id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/8.0.514.9590",
"name": "8.0.514.9590",
"type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
"properties": {
"supportExpiryUtc": "9999-12-31T23:59:59.9999999",
"osType": "Windows",
"clusterCodeVersion": "8.0.514.9590"
}
}
]
O supportExpiryUtc na saída relata quando uma determinada versão está expirando ou expirou. A versão mais recente não tem uma data válida, ela tem um valor de 9999-12-31T23:59:59.9999999, que significa apenas que a data de vencimento ainda não foi definida.