Gerir atualizações de clusters geridos do Service Fabric
Um cluster do Azure Service Fabric é um recurso do qual é proprietário, mas é parcialmente gerido pela Microsoft. Eis como gerir quando e como a Microsoft atualiza o runtime do cluster gerido do Azure Service Fabric.
Definir modo de atualização
Os clusters geridos do Azure Service Fabric são predefinidos para receber atualizações automáticas do Service Fabric à medida que são lançados pela Microsoft através de uma estratégia de implementação de ondas . Como alternativa, pode configurar atualizações de modo manual nas quais pode escolher a partir de uma lista de versões atualmente suportadas. Pode configurar estas definições através do controlo Atualizações de recursos de infraestrutura no portal do Azure ou da ClusterUpgradeMode definição no modelo de implementação do cluster.
Implementação faseada para atualizações automáticas
Com a implementação de ondas, pode criar um pipeline para atualizar os clusters de teste, fase e produção em sequência, separados por "tempo de cozimento" incorporado para validar as próximas versões do Service Fabric antes de os clusters de produção serem atualizados.
Nota
Por predefinição, os clusters serão definidos como Wave 0.
Para selecionar uma implementação de ondas para a atualização automática, determine primeiro qual a onda a atribuir ao cluster:
- Wave 0 (
Wave0): os clusters são atualizados assim que é lançada uma nova compilação do Service Fabric. - Onda 1 (
Wave1): os clusters são atualizados após a Onda 0 para permitir o tempo de cozedura. 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 em último lugar para permitir mais tempo de cozedura. A onda 2 ocorre após um mínimo de 14 dias após a Onda 0.
Definir o Wave para o seu cluster
Pode definir o cluster para uma das ondas disponíveis através do controlo Atualizações de recursos de infraestrutura no portal do Azure ou da ClusterUpgradeMode definição no modelo de implementação do cluster.
Portal do Azure
Ao utilizar portal do Azure, irá escolher entre as ondas automáticas disponíveis ao criar um novo cluster do Service Fabric.
Também pode alternar entre as ondas automáticas disponíveis na secção Atualizações de recursos de infraestrutura de um recurso de cluster existente.
Modelo do Resource Manager
Para alterar o modo de atualização do cluster com um modelo de Resource Manager, especifique Automático ou Manual para a ClusterUpgradeMode propriedade da definição de recurso Microsoft.ServiceFabric/clusters. Se escolher atualizações manuais, defina também para clusterCodeVersion uma versão de recursos de infraestrutura atualmente suportada.
Atualização manual
{
"apiVersion": "2021-05-01",
"type": "Microsoft.ServiceFabric/managedClusters",
"properties": {
"clusterUpgradeMode": "Manual",
"clusterCodeVersion": "8.0.514.9590"
}
}
Após a implementação bem-sucedida do modelo, serão aplicadas alterações ao modo de atualização do cluster. Se o cluster estiver no modo manual, a atualização do cluster será iniciada automaticamente.
As políticas de estado de funcionamento do cluster (uma combinação do estado de funcionamento do nó e do estado de funcionamento de todas as aplicações em execução no cluster) são cumpridas durante a atualização. Se as políticas de estado de funcionamento do cluster não forem cumpridas, a atualização será revertida.
Se ocorrer uma reversão, terá de corrigir os problemas que resultaram na reversão e iniciar novamente a atualização ao seguir os mesmos passos anteriores.
Atualização automática com implementação de ondas
Para configurar as Atualizações automáticas e a implementação de ondas, basta adicionar/validar ClusterUpgradeMode está definida como Automatic e a clusterUpgradeCadence propriedade é definida com um dos valores de onda listados acima no modelo de Resource Manager.
{
"apiVersion": "2021-05-01",
"type": "Microsoft.ServiceFabric/managedClusters",
"properties": {
"clusterUpgradeMode": "Automatic",
"clusterUpgradeCadence": "Wave1"
}
}
Depois de implementar o modelo atualizado, o cluster será inscrito na fase especificada para atualizações automáticas.
Consulta para versões de cluster suportadas
Pode utilizar a API REST do Azure para listar todas as versões de runtime do Service Fabric disponíveis (clusterVersions) disponíveis para a localização especificada e a sua subscrição.
Também pode referenciar as versões do Service Fabric para obter mais detalhes sobre as versões suportadas e os sistemas operativos.
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 no resultado comunica quando uma determinada versão está a expirar ou expirou. As versões mais recentes não terão uma data válida, mas sim um valor de 9999-12-31T23:59:59.9999999, o que significa apenas que a data de expiração ainda não está definida.