Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use o CLI do Azure para implantar Operações do Azure IoT em um cluster Kubernetes já habilitado para Azure Arc. Neste artigo, você cria ou seleciona as dependências do Azure, inicializa o cluster, implanta uma instância e verifica a implantação.
A instância básica suporta testes e avaliação. Para cargas de trabalho de produção, também complete a opção Habilitar configurações seguras para produção. Para configurar a implantação no portal Azure, consulte Implantar Operações do Azure IoT em um cluster de produção.
Pré-requisitos
- Uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma gratuitamente antes de começar.
O CLI do Azure instalado em seu computador de desenvolvimento. Verifique as extensões disponíveis do CLI do Azure para a versão mínima exigida para usar a extensão azure-iot-ops. Use
az --versionpara verificar sua versão eaz upgradepara atualizar, se necessário. Para obter mais informações, consulte Instale o CLI do Azure.A extensão Operações do Azure IoT do CLI do Azure. Use o seguinte comando para adicionar a extensão ou atualizá-la à versão mais recente:
az extension add --upgrade --name azure-iot-ops
- Um cluster Kubernetes habilitado para Azure Arc que atende aos requisitos de ambiente suportados. Complete Prepare seu cluster Kubernetes habilitado para Azure Arc, incluindo registro de provedor de recursos, suporte de localização personalizada e configuração de identidade da carga de trabalho.
- As permissões Azure necessárias, incluindo Microsoft. Autorização/roleAtribuições/escrita para atribuições de funções de registro de esquemas.
- Acesso local
kubectlao cluster de destino. Executekubectl config current-contextekubectl get nodesconfirme que você está conectado ao cluster pretendido. - Para produção, configure suas configurações de emissor de certificado e de confiança antes da inicialização e criação. Para mais informações, consulte Traga seu próprio emissor.
Para implantar no Azure Governamental, execute az cloud set --name AzureUSGovernment antes de fazer login. Para outras diferenças, veja Operações do Azure IoT in Azure Governamental.
Faça login de forma interativa, mesmo que você tenha feito login anteriormente:
az login
Execute os comandos na mesma sessão Bash ou PowerShell. Resolva qualquer falha de comando antes de continuar.
Definir valores de implantação
Substitua os espaços reservados no bloco variável.
RESOURCE_GROUP é o grupo de recursos do cluster habilitado para Arc, onde você implanta a instância. O registro de esquema e o namespace do Registro de Dispositivos podem estar em grupos de recursos diferentes. Especifique seus grupos reais separadamente.
Escolha nomes para uma nova instância e local personalizado.
--custom-location Aceita um nome de localização personalizado. Se você omitir esse parâmetro opcional de create, a CLI gera um nome no formulário location-{hash(5)}.
Para novas dependências, use uma região suportada, um nome de conta de armazenamento globalmente único (3-24 letras minúsculas e números) e um namespace de registro de esquema que seja exclusivo dentro do seu locatário. O namespace do registro de esquemas é distinto do namespace Azure Device Registry e do namespace Kubernetes.
SUBSCRIPTION_ID="<SUBSCRIPTION_ID>"
RESOURCE_GROUP="<CLUSTER_RESOURCE_GROUP>"
CLUSTER_NAME="<ARC_ENABLED_CLUSTER_NAME>"
AIO_INSTANCE_NAME="<NEW_AIO_INSTANCE_NAME>"
CUSTOM_LOCATION_NAME="<NEW_CUSTOM_LOCATION_NAME>"
LOCATION="<SUPPORTED_AZURE_REGION>"
SCHEMA_RESOURCE_GROUP="<SCHEMA_REGISTRY_RESOURCE_GROUP>"
NAMESPACE_RESOURCE_GROUP="<DEVICE_REGISTRY_NAMESPACE_RESOURCE_GROUP>"
STORAGE_ACCOUNT_NAME="<STORAGE_ACCOUNT_NAME>"
SCHEMA_REGISTRY_NAME="<SCHEMA_REGISTRY_NAME>"
SCHEMA_REGISTRY_NAMESPACE="<SCHEMA_REGISTRY_NAMESPACE>"
DEVICE_REGISTRY_NAMESPACE_NAME="<DEVICE_REGISTRY_NAMESPACE_NAME>"
az account set --subscription "$SUBSCRIPTION_ID"
Criar ou selecionar dependências
Operações do Azure IoT requer um namespace do Azure Device Registry e um registro de esquemas respaldado por uma conta de armazenamento Azure. Para reutilizar dependências existentes, defina seus nomes e grupos de recursos no bloco variável e ignore seus comandos de criação. Você também pode criar uma dependência e reutilizar a outra.
Criar o registro de esquema atribui seu acesso de identidade à conta de armazenamento e requer Microsoft. Autorização/função Permissão de atribuição/escrita. Para obter mais informações, veja az iot ops schema registry create.
az group create --name "$SCHEMA_RESOURCE_GROUP" --location "$LOCATION"
az group create --name "$NAMESPACE_RESOURCE_GROUP" --location "$LOCATION"
az storage account create \
--name "$STORAGE_ACCOUNT_NAME" \
--resource-group "$SCHEMA_RESOURCE_GROUP" \
--location "$LOCATION" \
--enable-hierarchical-namespace
STORAGE_ACCOUNT_RESOURCE_ID=$(az storage account show \
--name "$STORAGE_ACCOUNT_NAME" \
--resource-group "$SCHEMA_RESOURCE_GROUP" \
--query id --output tsv)
az iot ops schema registry create \
--name "$SCHEMA_REGISTRY_NAME" \
--resource-group "$SCHEMA_RESOURCE_GROUP" \
--location "$LOCATION" \
--registry-namespace "$SCHEMA_REGISTRY_NAMESPACE" \
--sa-resource-id "$STORAGE_ACCOUNT_RESOURCE_ID"
az iot ops ns create \
--name "$DEVICE_REGISTRY_NAMESPACE_NAME" \
--resource-group "$NAMESPACE_RESOURCE_GROUP" \
--location "$LOCATION"
Selecione o tempo de execução
Os exemplos de implantação utilizam o runtime de disponibilidade geral (GA) incluído na extensão. Para implantar uma instância de pré-visualização, adicione --use-preview ao comando az iot ops create antes de executá-la. Esta opção seleciona o runtime de pré-visualização incluído com a extensão instalada.
A seleção de pré-visualização requer uma versão da extensão que suporte --use-preview. Verifique a versão instalada e a ajuda de comandos:
az version
az extension show --name azure-iot-ops --query version --output tsv
az iot ops create --help
Confirme que a ajuda está listada --use-preview antes de adicionar o flag. Se isso não acontecer, execute az extension add --upgrade --name azure-iot-ops e verifique novamente. Se a flag ainda estiver ausente, use o procedimento estável ou instale uma versão de extensão de suporte antes de continuar.
Important
O uso de --use-preview constitui a aceitação dos Termos Suplementares de Uso para versões prévias do Microsoft Azure. Revise as notas de versão do runtime de pré-visualização e os requisitos do cluster e de armazenamento antes da implantação.
Inicialize o cluster e implante uma instância
Os comandos a seguir recuperam os IDs completos dos recursos Azure das dependências, inicializam a fundação do cluster e implantam uma instância. Cada consulta de dependência deve ser bem-sucedida e retornar um ID não vazio antes de executar create.
-
--sr-resource-idrequer um ID no formato/subscriptions/<subscription-id>/resourceGroups/<schema-resource-group>/providers/Microsoft.DeviceRegistry/schemaRegistries/<schema-registry-name>. -
--ns-resource-idrequer um ID no formulário/subscriptions/<subscription-id>/resourceGroups/<namespace-resource-group>/providers/Microsoft.DeviceRegistry/namespaces/<namespace-name>.
Esses valores são IDs de recursos do Azure, e não nomes de recursos ou nomes de namespace Kubernetes. Os exemplos selecionam dependências em SUBSCRIPTION_ID. Para uma dependência em outra assinatura, adicione --subscription <DEPENDENCY_SUBSCRIPTION_ID> ao comando dela show para recuperar seu ID completo.
Execute init uma vez para uma base de cluster que suporte sua versão de destino. Se você estiver reutilizando um cluster inicializado compatível após excluir uma instância sem --include-deps, pule init. Para uma atualização de versão, siga Atualizar Operações do Azure IoT.
Note
Esses exemplos utilizam o pacote de confiança autoassinado fornecido pelo sistema. Para usar seu próprio emissor, siga Traga seu próprio emissor, inclusive --user-trust durante a inicialização e --trust-settings durante a criação.
SCHEMA_REGISTRY_RESOURCE_ID=$(az iot ops schema registry show \
--name "$SCHEMA_REGISTRY_NAME" \
--resource-group "$SCHEMA_RESOURCE_GROUP" \
--query id --output tsv)
DEVICE_REGISTRY_NAMESPACE_RESOURCE_ID=$(az iot ops ns show \
--name "$DEVICE_REGISTRY_NAMESPACE_NAME" \
--resource-group "$NAMESPACE_RESOURCE_GROUP" \
--query id --output tsv)
az iot ops init \
--subscription "$SUBSCRIPTION_ID" \
--resource-group "$RESOURCE_GROUP" \
--cluster "$CLUSTER_NAME"
az iot ops create \
--subscription "$SUBSCRIPTION_ID" \
--resource-group "$RESOURCE_GROUP" \
--cluster "$CLUSTER_NAME" \
--name "$AIO_INSTANCE_NAME" \
--custom-location "$CUSTOM_LOCATION_NAME" \
--sr-resource-id "$SCHEMA_REGISTRY_RESOURCE_ID" \
--ns-resource-id "$DEVICE_REGISTRY_NAMESPACE_RESOURCE_ID"
Espere até init ter sucesso antes de executar create. Ambos os comandos podem levar vários minutos.
Verificar a implantação
Use show para visualizar a configuração da instância do Azure e check para avaliar os serviços no cluster selecionado pelo seu contexto atual de kubeconfig:
az iot ops show --name "$AIO_INSTANCE_NAME" --resource-group "$RESOURCE_GROUP"
az iot ops check
Para mais informações sobre as verificações, consulte Verificar a implantação.
Habilitar configurações seguras para produção
Depois que você executa init e create, a instância básica está pronta para teste. Antes de usar a instância para cargas de trabalho de produção, complete o procedimento CLI em Habilitar configurações seguras:
- Crie ou selecione um Azure Key Vault com RBAC habilitado e uma identidade gerenciada atribuída pelo usuário para segredos. Conceda permissão à sua conta de usuário para gerenciar segredos.
- Execute
az iot ops secretsync enablecom os IDs de recurso completos do Key Vault e da identidade de segredos para configurar a sincronização de segredos. - Use uma identidade gerenciada separada atribuída pelo usuário para conexões na nuvem. Execute
az iot ops identity assigne conceda a essa identidade acesso aos recursos de nuvem necessários. Para gráficos de fluxo de dados, configure também o uso da identidadewasm-graph. - Reinicie os pods de registro de esquema conforme indicado no procedimento de configurações seguras e em seguida execute
az iot ops checknovamente.
O procedimento de configurações seguras fornece comandos Bash e PowerShell para essas etapas. Mantenha o emissor do certificado e a configuração de confiança que você selecionou antes da inicialização.
Limpar os recursos
Para limpar ou reimplantar, siga as instruções em Desinstalar. O az iot ops delete comando remove a implantação da instância e mantém a base preparada por init. O az iot ops delete --include-deps comando também remove as dependências de inicialização. Verifique a árvore de exclusão antes de confirmar. Gerencie separadamente recursos criados separadamente ou compartilhados, como o registro de esquemas, a conta de armazenamento e o namespace do Registro de Dispositivos.
Se um cluster desconectado bloquear a desinstalação, consulte Recuperar uma desinstalação bloqueada para obter orientações sobre --force e a limpeza de recursos residuais.
Important
Desinstale o Operações do Azure IoT antes de excluir seu grupo de recursos e mantenha o cluster online sempre que possível. Excluir o grupo de recursos primeiro pode deixar recursos órfãos no cluster e causar falhas em implantações posteriores.