Sincronização de recursos

A sincronização de recursos permite criar, atualizar ou excluir recursos diretamente no cluster do Kubernetes usando APIs do Kubernetes no modo de conexão direta. Além disso, permite sincronizar automaticamente essas alterações no Azure. Este artigo explica a sincronização de recursos.

Observação

Como uma versão prévia do recurso, a tecnologia apresentada neste artigo está sujeita aos Termos de uso complementares para versões prévias do Microsoft Azure.

As atualizações mais recentes estão disponíveis nas notas sobre a versão.

Quando você implanta serviços de dados habilitados para o Azure Arc no modo de conexão direta, a implantação cria uma regra de sincronização de recursos. Essa regra de sincronização de recursos garante que os recursos do Arc, como a instância gerenciada de SQL, criados ou atualizados chamando diretamente as APIs de Kubernetes, sejam atualizados adequadamente nos recursos mapeados no Azure e os metadados de recurso sejam continuamente sincronizados no Azure. Essa regra é criada no mesmo grupo de recursos que o controlador de dados.

Observação

A regra de sincronização de recursos é criada por padrão, durante a implantação do controlador de dados do Azure Arc e só é aplicável no modo de conexão direta.

Sem a regra de sincronização de recursos, a instância gerenciada de SQL é criada usando o seguinte comando:

az sql mi-arc create --name <name> --resource-group <group>  --location <Azure location> -–subscription <subscription>  --custom-location <custom-location> --storage-class-backups <RWX capable storageclass>

Nesse cenário, primeiro as APIs ARM do Azure são chamadas e o recurso mapeado do Azure é criado. Depois que esse recurso mapeado é criado com êxito, a API do Kubernetes é chamada para criar a instância gerenciada de SQL no cluster do Kubernetes.

Um fluxograma demonstrando a sincronização de recursos do Azure Data Studio ou a CLI do Azure passando informações para a API do Kubernetes. Em seguida, o operador de sincronização de recursos passa as informações para a API ARM do Azure.

Com a regra de sincronização de recursos, você pode usar a API de Kubernetes para criar a instância gerenciada de SQL habilitada para Arc, da seguinte maneira:

az sql mi-arc create --name <name> --k8s-namespace <namespace> --use-k8s --storage-class-backups <RWX capable storageclass>

Nesse cenário, a instância gerenciada de SQL é criada diretamente no cluster do Kubernetes. A regra de sincronização de recursos garante que o recurso equivalente no Azure também seja criado.

Se a regra de sincronização de recursos for excluída acidentalmente, você poderá adicioná-la novamente para restaurar a funcionalidade de sincronização usando a API REST abaixo. Consulte a referência da API REST do Azure para obter diretrizes sobre como executar APIs REST. Não esqueça de usar a assinatura de recursos do controlador de dados do Azure e o grupo de recursos.

https://management.azure.com/subscriptions/{{subscription}}/resourcegroups/{{resource_group}}/providers/microsoft.extendedlocation/customlocations/{{custom_location_name}}/resourcesyncrules/defaultresourcesyncrule?api-version=2021-08-31-preview
 "location": "{{Azure region}}",
        "properties": {
            "targetResourceGroup": "/subscriptions/{{subscription}}/resourcegroups/{{resource_group_of_ data_controller}}",
            "priority": 100,
            "selector": {
                "matchLabels": {
                    "management.azure.com/resourceProvider": "Microsoft.AzureArcData" //Mandatory 
                }
            }
        }
}

Limitações

  • A regra de sincronização de recursos não projeta o controlador de dados do Azure Arc. O controlador de dados do Azure Arc deve ser implantado por meio da API ARM.
  • A sincronização de recursos só se aplica aos serviços de dados, como a instância gerenciada de SQL habilitada para Arc, após a implantação do controlador de dados.
  • A regra de sincronização de recursos não projeta o PostgreSQL habilitado para Azure Arc
  • A regra de sincronização de recursos não projeta o conector do Active Directory do Azure Arc
  • A regra de sincronização de recursos não projeta os Grupos de Failover da Instância do Azure Arc

Criar o controlador de dados do Azure Arc no modo de conexão direta usando a CLI