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

Aprenda como implementar o Operações IoT do Azure 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 Operações IoT do Azure para um cluster de produção, veja Deploy Operações IoT do Azure para um cluster de produção.

Antes de começar

Este artigo discute Operações IoT do Azure deployments e instances, que são dois conceitos diferentes:

• Um Operações IoT do Azure deployment descreve todos os componentes e recursos que possibilitam o cenário Operações IoT do Azure. Esses componentes e recursos incluem:

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

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

Quando falamos de implementação de Operações IoT do Azure, 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. Se você não tiver uma assinatura do Azure, crie uma gratuitamente antes de começar.

• Permissões de acesso ao Azure. Para mais informações, consulte Resumo > de Implementação Permissões necessárias.

Recursos de desenvolvimento:

• O CLI do Azure instalado na sua máquina de desenvolvimento. Verifique as extensões disponíveis do CLI do Azure para a versão mínima necessária para usar a extensão azure-iot-ops. Utilize az --version para verificar a sua versão e az upgrade para atualizar, se necessário. Para mais informações, consulte Instale o CLI do Azure.

• A extensão Operações IoT do Azure para a CLI do Azure. Use o seguinte comando para adicionar a extensão ou atualizá-la para a versão mais recente:

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

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 Operações IoT do Azure no seu cluster anteriormente, desinstale esses recursos antes de continuar. Para mais informações, consulte Atualizar Operações IoT do Azure.

Cardinalidade automática

Para determinar automaticamente a cardinalidade inicial durante a implementação, omita o cardinality campo no recurso Broker. O operador do broker MQTT implementa o número adequado de pods com base no número de nós disponíveis no momento da implantação. Esta funcionalidade é útil para cenários não produtivos, onde não é necessário ajustar a alta disponibilidade ou definições de escala.

Para usar a cardinalidade automática, prepare um ficheiro de configuração Broker em formato JSON que omita o cardinality campo. Por exemplo, defina apenas o perfil de memória:

{
  "memoryProfile": "Medium"
}

Depois, lançar com a --broker-config-file bandeira (outros parâmetros omitidos para brevidade):

az iot ops create ... --broker-config-file <FILE>.json

Para mais informações, consulte o suporte da CLI Azure para configuração avançada de corretores MQTT.

Implementar no portal do Azure

Basics

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 CLI do Azure, por isso ainda precisa dos pré-requisitos do CLI do Azure descritos na secção anterior.

1. Inicie sessão no portal Azure.

2. Na caixa de pesquisa, pesquise e selecione Operações IoT do Azure.

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 Operações IoT do Azure.
   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.

Configuration

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

   Parâmetro	Valor
   Nome Operações IoT do Azure	Opcional: Substituir o nome padrão da instância Operações IoT do Azure.
   Configuração do broker MQTT	Opcional: edite as configurações padrão para o broker MQTT. No portal do 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 CLI do Azure 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.

   

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

Gestão de dependências

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

   1. Selecione Criar novo.

   2. Introduza um nome de registo Schema e um espaço de nomes de registo Schema.

   3. Selecione Select Armazenamento do Azure 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 Armazenamento do Azure 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.

2. Operações IoT do Azure utiliza namespaces para organizar ativos e dispositivos. Cada instância do Operações IoT do Azure 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 Operações IoT do Azure.
      Nome	Introduza um nome único para o 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.

Opções de implantação

1. 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.

   

2. Selecione Next: Automation.

Executar os comandos CLI do Azure

O passo final na experiência de implementação do portal Azure é executar um conjunto de comandos CLI do Azure para implementar o Operações IoT do Azure no seu cluster. O portal gera estes comandos com base na informação que forneces nos passos anteriores.

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

1. Inicie sessão no CLI do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure 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 Operações IoT do Azure. 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 Operações IoT do Azure, 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 CLI do Azure estiverem concluídos com sucesso, podes fechar o assistente Install Operações IoT do Azure.

Quando o comando create é concluído com sucesso, tens uma instância de Operações IoT do Azure 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 implementação, utilize az iot ops check para avaliar a implementação do serviço IoT Operations em termos de estado de funcionamento, configuração e usabilidade. O check comando ajuda-o a encontrar problemas na sua implementação e configuração.

az iot ops check

O comando check indica que as verificações de fluxo de dados foram ignoradas quando ainda não existem fluxos de dados, o que é normal e esperado até criar um fluxo de dados. Para obter mais informações, consulte Processar e rotear dados com fluxos de dados.

Para verificar as configurações dos mapas de tópicos, QoS e rotas de mensagens, adicione o --detail-level 2 parâmetro ao check comando para uma visualização detalhada.

Para visualizar todas as versões da extensão CLI do Operações IoT do Azure que estão disponíveis, execute o seguinte comando:

az iot ops get-versions

Próximos passos

• Configure a observabilidade para configurar a monitorização e os painéis.
• A instância do Operações IoT do Azure que implementou está configurada para testar cenários. Se quiser ativar definições seguras e preparar a instância para cenários de produção, siga os passos em Ative definições seguras numa instância Operações IoT do Azure existente.