Compartilhar via

Início Rápido: Configurar seu cluster

Nesse início rápido, você configurará os seguintes recursos no seu cluster de Operações do Azure IoT em visualização:

  • Um dispositivo que define uma conexão com um servidor OPC PLC simulado que simula um forno em uma padaria.
  • Um ativo que representa o forno e define os pontos de dados que o forno expõe.
  • Um fluxo de dados que manipula as mensagens do forno simulado.

No contexto das operações de IoT do Azure, um ativo é uma representação lógica de um dispositivo físico ou sistema que você deseja monitorar ou controlar.

Os servidores OPC UA são aplicativos de software que se comunicam com ativos. Os pontos de dados OPC UA são valores que os servidores OPC UA expõem. Os pontos de dados OPC UA podem fornecer dados históricos ou em tempo real sobre o status, o desempenho, a qualidade ou a condição dos ativos.

Nesse início rápido, você usará um arquivo Bicep para configurar sua instância de Operações do Azure IoT.

Dica

Se você preferir um tutorial mais longo que orienta você pelas mesmas etapas com mais profundidade e incluir detalhes adicionais, como configuração de segurança, consulte Tutorial: Adicionar ativos OPC UA ao cluster de Operações de IoT do Azure.

Pré-requisitos

Tenha uma instância do Visualização de Operações do Azure IoT implantada em um cluster do Kubernetes. O Início Rápido: executar a Visualização de Operações IoT do Azure nos GitHub Codespaces com K3s fornece instruções simples para implantar uma instância de Operações de IoT do Azure que você poderá usar para os inícios rápidos.

A menos que indicado de outra forma, execute os comandos do console neste início rápido em um ambiente do Bash ou do PowerShell.

Que problema vamos resolver?

Os dados que os servidores OPC UA expõem podem ter uma estrutura complexa e ser difíceis de entender. O recurso Operações do Azure IoT fornece uma maneira de modelar ativos OPC UA na forma de tags, eventos e propriedades. Essa modelagem facilita a compreensão dos dados e o uso deles em processos de downstream, como o Agente MQTT e fluxos de dados. Os fluxos de dados permitem manipular e encaminhar dados para serviços de nuvem como os Hubs de Eventos do Azure. Nesse início rápido, o fluxo de dados altera os nomes de alguns campos no conteúdo e adiciona uma ID de ativo às mensagens.

Implantar o simulador de PLC OPC

Este início rápido usa o simulador OPC PLC para gerar dados de exemplo. Para implantar o simulador OPC PLC, execute o seguinte comando:

kubectl apply -f https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/quickstarts/opc-plc-deployment.yaml

Cuidado

Essa configuração usa um certificado de instância de aplicativo autoassinado. Não use essa configuração em um ambiente de produção. Para saber mais, confira Configurar a infraestrutura de certificados OPC UA para o conector OPC UA.

Definir variáveis de ambiente

Se você estiver usando o ambiente do Codespaces, as variáveis de ambiente necessárias já estão definidas e você pode ignorar esta etapa. Caso contrário, defina as seguintes variáveis de ambiente em seu shell:

# Your subscription ID
SUBSCRIPTION_ID=<subscription-id>

# The name of the resource group where your Kubernetes cluster is deployed
RESOURCE_GROUP=<resource-group-name>

# The name of your Kubernetes cluster
CLUSTER_NAME=<kubernetes-cluster-name>

Configurar seu cluster

Execute os seguintes comandos para baixar e executar o arquivo Bicep que configura sua instância de Operações do Azure IoT. O arquivo Bicep:

  • Adiciona um dispositivo que se conecta ao simulador OPC PLC.
  • Adiciona um ativo que representa o forno e define os pontos de dados que o forno expõe.
  • Adiciona um fluxo de dados que manipula as mensagens do forno simulado.
  • Cria uma instância dos Hubs de Eventos do Azure para receber os dados.
wget https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/quickstarts/quickstart.bicep -O quickstart.bicep

AIO_EXTENSION_NAME=$(az k8s-extension list -g $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --cluster-type connectedClusters --query "[?extensionType == 'microsoft.iotoperations'].id" -o tsv | awk -F'/' '{print $NF}')
AIO_INSTANCE_NAME=$(az iot ops list -g $RESOURCE_GROUP --query "[0].name" -o tsv)
CUSTOM_LOCATION_NAME=$(az iot ops list -g $RESOURCE_GROUP --query "[0].extendedLocation.name" -o tsv | awk -F'/' '{print $NF}')

az deployment group create --subscription $SUBSCRIPTION_ID --resource-group $RESOURCE_GROUP --template-file quickstart.bicep --parameters clusterName=$CLUSTER_NAME customLocationName=$CUSTOM_LOCATION_NAME aioExtensionName=$AIO_EXTENSION_NAME aioInstanceName=$AIO_INSTANCE_NAME aioNamespaceName=myqsnamespace

Examinar configuração

O arquivo Bicep configurou os seguintes recursos:

  • Um dispositivo que se conecta ao simulador OPC PLC.
  • Um ativo que representa o forno e define os pontos de dados que o forno expõe.
  • Dois fluxos de dados que processam as mensagens do forno simulado.
  • Um namespace dos Hubs de Eventos do Azure que contém um hub de destino para os fluxos de dados.

Para exibir o dispositivo, o ativo e os fluxos de dados, navegue até a interface do usuário da experiência de operações no navegador e entre com suas credenciais de ID do Microsoft Entra. Como você está trabalhando com uma nova implantação, ainda não há sites. Você pode encontrar o cluster criado no início rápido anterior selecionando Instâncias não atribuídas. Na experiência de operações, uma instância representa um cluster onde você implantou as Operações de IoT do Azure.

Captura de tela na experiência de operações mostrando instâncias não atribuídas.

O dispositivo opc-ua-connector define a conexão com o simulador OPC PLC:

Captura de tela na experiência de operações que mostra uma lista de dispositivos.

O ativo do forno define os pontos de dados que o forno expõe:

Captura de tela na experiência de operações que mostra uma lista de ativos.

Os fluxos de dados definem como as mensagens do forno simulado são processadas e encaminhadas para os Hubs de Eventos na nuvem:

Captura de tela na experiência de operações que mostra uma lista de fluxos de dados.

A seguinte captura de tela mostra como o fluxo de dados de conversão de temperatura está configurado:

Captura de tela na experiência de operações que mostra o cálculo de conversão de temperatura.

Verificar se os dados estão fluindo para os Hubs de Eventos

Para verificar se os dados estão fluindo para a nuvem, você pode exibir a sua instância dos Hubs de Eventos no portal do Azure. Pode ser necessário aguardar vários minutos para o fluxo de dados iniciar e para as mensagens fluírem para o hub de eventos.

A configuração Bicep aplicada anteriormente criou um namespace e um hub dos Hubs de Eventos do Azure que é usado como destino pelo fluxo de dados. Para visualizar o namespace e o hub, navegue até o grupo de recursos no portal do Azure que contém sua instância de Operações de IoT e selecione o namespace dos Hubs de Eventos.

Se as mensagens estiverem fluindo para a instância, você poderá ver a contagem de mensagens de entrada na página de visão geral da instância:

Captura de tela que mostra a página de visão geral da instância dos Hubs de Eventos com mensagens de entrada.

Se as mensagens estiverem fluindo, você poderá usar o Data Explorer para exibir as mensagens:

Captura de tela da página **Data Explorer** da instância dos Hubs de Eventos.

Dica

Talvez seja necessário atribuir-se à função Receptor de dados dos Hubs de Eventos do Azure para que o namespace dos Hubs de Eventos exiba as mensagens.

Como resolvemos o problema?

Neste início rápido, você usou um arquivo bicep para configurar sua instância de Operações de IoT do Azure com um dispositivo, ativo e fluxo de dados. A configuração processa e roteia dados de um forno simulado. O fluxo de dados na configuração encaminha as mensagens para uma instância dos Hubs de Eventos do Azure.

Limpar os recursos

Se você continuar no próximo início rápido, mantenha todos os seus recursos.

Se você quiser remover a implantação das Operações do Azure IoT, mas manter o seu cluster, use o comando az iot ops delete:

az iot ops delete --cluster $CLUSTER_NAME --resource-group $RESOURCE_GROUP

Se você quiser excluir todos os recursos criados para este início rápido, exclua o cluster do Kubernetes no qual você implantou as Operações do Azure IoT e remova o grupo de recursos do Azure que continha o cluster.

Se você usou os Codespaces para esses inícios rápidos, exclua seu Codespace do GitHub.

Próxima etapa

Se você quiser saber como criar um dashboard do Microsoft Fabric para obter insights dos seus dados de forno, confira Tutorial: Obter insights a partir dos seus dados processados.

  • Last updated on