Implantar operações de Azure IoT em um cluster de teste

Saiba como implantar Azure IoT Operations em um cluster de teste, que é um cluster kubernetes habilitado para Arc que você pode usar para cenários de teste e avaliação.

Se você quiser implantar Azure IoT Operations em um cluster de produção, consulte Deploy Azure IoT Operations em 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 habilitam o cenário de Azure IoT Operations. Esses componentes e recursos incluem:

  • Uma instância de Azure IoT Operations
  • Extensões do Arc
  • Locais personalizados
  • Recursos que você pode configurar em sua solução de Azure IoT Operations, como ativos e dispositivos.

• Um Azure IoT Operations instance é o recurso pai que agrupa o conjunto de serviços definido em O que é Azure IoT Operations? como agente MQTT, fluxos de dados e conector para OPC UA.

Quando falamos em implantar Azure IoT Operations, queremos dizer o conjunto completo de componentes que compõem um deployment. Depois que a implantação existir, você poderá exibir, gerenciar e atualizar a instância.

Pré-requisitos

Recursos de nuvem:

• Uma assinatura Azure.

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

Recursos de desenvolvimento:

• Azure CLI instalado em seu computador de desenvolvimento. Esse cenário requer Azure CLI versão 2.53.0 ou superior. Use az --version para verificar sua versão e az upgrade para atualizar, se necessário. Para obter mais informações, consulte Como instalar o Azure CLI.

Um host de cluster:

• Tenha um cluster Kubernetes habilitado para o Azure Arc com os recursos de localização personalizada e identidade de workload ativados. Se você não tiver um, siga as etapas em Prepare seu cluster kubernetes habilitado para Azure Arc.

  Se você implantou Azure IoT Operations no cluster anteriormente, desinstale esses recursos antes de continuar. Para obter mais informações, consulte Update Azure IoT Operations.

Implantar no portal Azure

A experiência de implantação do portal Azure é uma ferramenta auxiliar que gera um comando de implantação com base em seus recursos e configuração. A etapa final é executar um comando Azure CLI, portanto, você ainda precisa dos pré-requisitos de Azure CLI descritos na seção anterior.

1. Entre no Azure portal.

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 habilitado para Arc.
   Grupo de recursos	Selecione o grupo de recursos que contém o cluster habilitado para Arc.
   Nome do cluster	Selecione o cluster no qual você deseja implantar Azure IoT Operations.
   Nome do local personalizado	Opcional: substitua o nome padrão pelo local personalizado.
   Versão de implantação	Selecione a versão 1.2 (mais recente ). Para obter mais informações, consulte as 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 Avançar: configuração.

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

   Parâmetro	Valor
   nome do Azure IoT Operations	Optional: substitua o nome padrão da instância Azure IoT Operations.
   Configuração do Agente MQTT	Opcional: edite as configurações padrão para o Agente MQTT. No portal Azure, é possível configurar configurações de cardinalidade e perfil de memória. Para definir outras configurações, incluindo o buffer de mensagens sustentado por disco e opções avançadas do cliente MQTT, consulte o suporte do Azure CLI para configuração avançada do broker 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, veja Configurar o perfil de fluxo de dados.

   Uma captura de tela que mostra a segunda guia para implantar o Azure IoT Operations a partir do portal.

7. Selecione Avançar: Gerenciamento de dependências.

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

   1. Selecione Criar novo.

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

   3. Selecione Select Azure Storage contêiner.

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

      O registro de esquema requer uma conta Azure Storage com namespace hierárquico e acesso à rede pública habilitados. 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 as 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 de esquema.

9. Azure IoT Operations usa namespaces para organizar ativos e dispositivos. Cada instância Azure IoT Operations usa um único namespace para seus ativos e dispositivos. Na guia Dependency management, selecione um namespace existente do Registro de Dispositivo do Azure, ou use estas etapas 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 sua assinatura.
      Grupo de recursos	Selecione o grupo de recursos que contém sua instância de Azure IoT Operations.
      Nome	Forneça um nome exclusivo para o namespace.
      Região	Selecione a região Azure para armazenar seu namespace.

      Selecione Avançar para continuar.

   3. Na guia Marcas , opcionalmente, você pode adicionar marcas ao namespace. Selecione Avançar para continuar.

   4. Na guia Examinar + criar , examine suas configurações e selecione Criar para criar o namespace.

   5. De volta à guia Gerenciamento de dependências , selecione o namespace recém-criado na lista.

10. Na guia Gerenciamento de dependências , selecione a opção de implantação de configurações de teste . Essa opção usa as configurações padrão recomendadas para fins de teste.

    

11. Selecione Avançar: Automação.

Executar comandos Azure CLI

A etapa final na experiência de implantação do portal do Azure é executar um conjunto de comandos Azure CLI para implantar Azure IoT Operations em seu cluster. Os comandos são gerados com base nas informações fornecidas nas etapas anteriores.

Uma de cada vez, execute cada comando Azure CLI na guia Automation em um terminal:

1. Entre no Azure CLI interativamente com um navegador, mesmo se você já tiver entrado antes. Se você não entrar de modo interativo, poderá receber um erro informando que Seu dispositivo deverá ser gerenciado para acessar o recurso.

   az login
   

2. Instale a extensão mais recente da CLI Azure IoT Operations se ainda não tiver feito isso.

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

3. Copie e execute o comando az iot ops schema registry create para criar um registro de esquema usado por componentes Azure IoT Operations. 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 implantação do Azure IoT Operations. Copie e execute o comando az iot ops init fornecido.

   Dica

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

   Esse comando pode levar vários minutos para ser concluído. Você poderá ver o andamento na exibição de progresso da implantação no terminal.

5. Para implantar 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ê poderá ver o andamento na exibição de progresso da implantação no terminal.

6. Depois que todos os comandos Azure CLI forem concluídos com êxito, você poderá fechar o assistente Instalar Azure IoT Operations.

Depois que o comando create for concluído com êxito, você terá uma instância de Azure IoT Operations em funcionamento em execução no 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 de Operações de IoT para 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 comando check 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, veja Processar e encaminhar dados com fluxos de dados.

Você pode verificar as configurações de mapas de tópico, QoS e rotas de mensagem adicionando o parâmetro --detail-level 2 ao comando check para obter uma exibição detalhada.

Você pode exibir todas as versões da extensão da CLI Azure IoT Operations disponíveis executando o seguinte comando:

az iot ops get-versions

Próximas etapas

A instância de Azure IoT Operations implantada é configurada para cenários de teste. Se você quiser habilitar a configuração de segurança e preparar a instância para cenários de produção, siga as etapas em Habilitar configurações seguras em uma instância existente do Azure IoT Operations.