Desdobrar operações do Azure IoT para um cluster de teste

Aprenda como implementar o Azure IoT Operations num cluster de testes, que é um cluster Kubernetes compatível com Arc e que pode usar para cenários de teste e avaliação.

Se quiser implementar Azure IoT Operations para um cluster de produção, veja Deploy Azure IoT Operations para um cluster de produção.

Antes de começar

Este artigo discute Azure IoT Operations deployments e instances, que são dois conceitos diferentes:

• Um Azure IoT Operations deployment descreve todos os componentes e recursos que possibilitam o cenário Azure IoT Operations. Esses componentes e recursos incluem:

  • uma instância de Azure IoT Operations
  • Extensões de arco
  • Locais personalizados
  • Recursos que pode configurar na sua solução Azure IoT Operations, como ativos e dispositivos.

• Uma instância de Azure IoT Operations é o recurso principal que agrupa o conjunto de serviços definidos em O que é Azure IoT Operations?, como o broker MQTT, fluxos de dados e conector para OPC UA.

Quando falamos de implementação de Azure IoT Operations, referimo-nos ao conjunto completo de componentes que compõem um deployment. Uma vez que a implantação exista, poderá exibir, gerir e atualizar a instância.

Pré-requisitos

Recursos da cloud:

• Uma subscrição do Azure.

• Permissões de acesso ao Azure. Para obter mais informações, consulte Detalhes > da implantação Permissões necessárias.

Recursos de desenvolvimento:

• Azure CLI instalado na sua máquina de desenvolvimento. Este cenário requer Azure CLI versão 2.53.0 ou superior. Utilize az --version para verificar a sua versão e az upgrade para atualizar, se necessário. Para mais informações, consulte Como instalar o Azure CLI.

Um host de cluster:

• Ter um cluster Kubernetes habilitado para Azure Arc com funcionalidades de localização personalizada e identidade da carga de trabalho ativadas. Se não tiver, siga as etapas em Prepare o seu cluster Kubernetes habilitado pelo Azure Arc.

  Se implementou o Azure IoT Operations no seu cluster anteriormente, desinstale esses recursos antes de continuar. Para mais informações, consulte Atualizar Azure IoT Operations.

Implementar no portal do Azure

A experiência de implementação do portal Azure é uma ferramenta auxiliar que gera um comando de implementação com base nos seus recursos e configuração. O passo final é executar um comando Azure CLI, por isso ainda precisa dos pré-requisitos do Azure CLI descritos na secção anterior.

1. Inicie sessão no portal Azure.

2. Na caixa de pesquisa, pesquise e selecione Azure IoT Operations.

3. Selecione Criar.

4. Na guia Noções básicas, forneça as seguintes informações:

   Parâmetro	Valor
   Subscrição	Selecione a assinatura que contém o cluster com suporte para Arc.
   Grupo de recursos	Selecione o grupo de recursos que contém o cluster habilitado para Arc.
   Nome do cluster	Selecione o cluster onde pretende implementar o Azure IoT Operations.
   Nome da localização personalizada	Opcional: substitua o nome padrão do local personalizado.
   Versão de implantação	Selecione a versão 1.2 (mais recente ). Para obter mais informações, consulte Versões de operações IoT.
   Componentes opcionais de implantação > Conector OPC UA	Escolha implantar o conector opcional para o componente OPC UA.

5. Selecione Next: Configuration.

6. Na guia Configuração, forneça as seguintes informações:

   Parâmetro	Valor
   Nome Azure IoT Operations	Opcional: Substituir o nome padrão da instância Azure IoT Operations.
   Configuração do broker MQTT	Opcional: edite as configurações padrão para o broker MQTT. No portal Azure é possível configurar as definições de cardinalidade e perfil de memória. Para configurar outras definições, incluindo buffer de mensagens apoiado em disco e opções avançadas de cliente MQTT, consulte Azure CLI suporte para configuração avançada de corretores MQTT.
   Configuração do perfil de fluxo de dados	Opcional: edite as configurações padrão para fluxos de dados. Para obter mais informações, consulte Configurar perfil de fluxo de dados.

   

7. Selecione Next: Dependency management (Próximo: Gerenciamento de dependência).

8. Na guia Gerenciamento de dependência, selecione um registro de esquema existente ou use estas etapas para criar um:

   1. Selecione Criar novo.

   2. Forneça um nome de registro de esquema e um namespace de registro de esquema.

   3. Selecione Select Azure Storage contentor.

   4. Escolha uma conta de armazenamento na lista de contas habilitadas para namespace hierárquico ou selecione Criar para criar uma.

      O registo de esquemas requer uma conta Azure Storage com namespace hierárquico e acesso à rede pública ativados. Ao criar uma nova conta de armazenamento, escolha um tipo de conta de armazenamento de uso geral v2 e defina o namespace hierárquico como Habilitado.

      Para obter mais informações sobre como configurar sua conta de armazenamento, consulte Diretrizes de implantação de produção.

   5. Selecione um contêiner em sua conta de armazenamento ou selecione Contêiner para criar um.

   6. Selecione Aplicar para confirmar as configurações do Registro do esquema.

9. Azure IoT Operations utiliza namespaces para organizar ativos e dispositivos. Cada instância do Azure IoT Operations utiliza um único namespace para os seus ativos e dispositivos. No separador Gestão de Dependências, selecione um namespace existente do Registo de Dispositivos Azure ou siga estes passos para criar um:

   1. Selecione Criar novo.

   2. Na guia Noções básicas, forneça as seguintes informações:

      Parâmetro	Valor
      Subscrição	Selecione a sua subscrição.
      Grupo de recursos	Selecione o grupo de recursos que contém a sua instância de Azure IoT Operations.
      Nome	Dê um nome único ao seu espaço de nomes.
      Região	Selecione a região Azure para armazenar o seu espaço de nomes.

      Selecione Seguinte para continuar.

   3. No separador Etiquetas , pode opcionalmente adicionar etiquetas ao seu espaço de nomes. Selecione Seguinte para continuar.

   4. Na aba Rever + criar, revise as suas configurações e selecione Criar para criar o namespace.

   5. De volta ao separador de Gestão de Dependências , selecione o espaço de nomes recém-criado na lista.

10. Na guia Gerenciamento de dependência , selecione a opção Implantação de configurações de teste . Esta opção usa configurações padrão recomendadas para fins de teste.

    

11. Selecione Next: Automation.

Executar os comandos Azure CLI

O passo final na experiência de implementação do portal Azure é executar um conjunto de comandos Azure CLI para implementar o Azure IoT Operations no seu cluster. Os comandos são gerados com base nas informações fornecidas nas etapas anteriores.

Um de cada vez, execute cada comando Azure CLI no separador Automação num terminal:

1. Inicie sessão no Azure CLI interativamente com um navegador, mesmo que já tenha feito login antes. Se não iniciar sessão de forma interativa, poderá receber um erro que indica que o seu dispositivo precisa ser gerido para aceder ao seu recurso.

   az login
   

2. Instale a mais recente extensão CLI do Azure IoT Operations se ainda não o fez.

   az extension add --upgrade --name azure-iot-ops
   

3. Copie e execute o comando fornecido az iot ops schema register create para criar um registo de esquema utilizado por Azure IoT Operations componentes. Se você optar por usar um registro de esquema existente, esse comando não será exibido na guia Automação .

4. Prepare o cluster para a implementação do Azure IoT Operations. Copie e execute o comando az iot ops init fornecido.

   Sugestão

   O init comando só precisa ser executado uma vez por cluster. Se seguiu o pré-requisito opcional para configurar o seu próprio emissor de autoridade de certificação, siga as etapas em Utilize o seu próprio emissor.

   Esse comando pode levar vários minutos para ser concluído. Você pode acompanhar o progresso no visor da implantação no terminal.

5. Para implementar Azure IoT Operations, copie e execute o comando az iot ops create fornecido. Esse comando pode levar vários minutos para ser concluído. Você pode acompanhar o progresso no visor da implantação no terminal.

6. Quando todos os comandos Azure CLI estiverem concluídos com sucesso, podes fechar o assistente Install Azure IoT Operations.

Quando o comando create é concluído com sucesso, tens uma instância de Azure IoT Operations a funcionar no teu cluster. Neste ponto, sua instância está configurada para a maioria dos cenários de teste e avaliação.

Verificar a implantação

Após a conclusão da implantação, execute az iot ops check para avaliar a implantação do serviço IoT Operations quanto à integridade, configuração e usabilidade. O check comando pode ajudá-lo a encontrar problemas em sua implantação e configuração.

az iot ops check

O check comando exibe um aviso sobre fluxos de dados ausentes, o que é normal e esperado até que você crie um fluxo de dados. Para obter mais informações, consulte Processar e rotear dados com fluxos de dados.

Pode verificar as configurações dos mapas de tópicos, das QoS e das rotas de mensagens ao adicionar o parâmetro --detail-level 2 ao comando check para uma exibição pormenorizada.

Pode visualizar todas as versões da extensão CLI do Azure IoT Operations disponíveis executando o seguinte comando:

az iot ops get-versions

Próximos passos

A instância do Azure IoT Operations que implementou está configurada para testar cenários. Se quiser ativar a definição segura e preparar a instância para cenários de produção, siga os passos em Ative definições seguras numa instância Azure IoT Operations existente.