Gerenciar o ciclo de vida de uma instância de Operações do Azure IoT

Use a CLI do Azure e o portal do Azure para gerenciar, desinstalar ou atualizar instâncias do Azure IoT Operations.

Pré-requisitos

• Uma instância de Operações IoT do Azure implantada em um cluster. Para obter mais informações, consulte Implantar operações do Azure IoT.

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

• A extensão Azure IoT Operations para 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
  

Gerir

Após a implantação, você pode usar a CLI do Azure e o portal do Azure para exibir e gerenciar sua instância de Operações IoT do Azure.

Listar instâncias

Portal do Azure

1. No portal do Azure, procure e selecione Operações do Azure IoT.
2. Use os filtros para exibir instâncias de Operações do Azure IoT com base em assinatura, grupo de recursos e muito mais.

CLI do Azure

Use o az iot ops list comando para ver todas as instâncias do Azure IoT Operations em sua assinatura ou grupo de recursos.

O comando basic retorna todas as instâncias em sua assinatura.

az iot ops list

Para filtrar os resultados por grupo de recursos, adicione o --resource-group parâmetro.

az iot ops list --resource-group <RESOURCE_GROUP>

Ver instância

Portal do Azure

Você pode exibir sua instância de Operações do Azure IoT no portal do Azure.

1. No portal do Azure, vá para o grupo de recursos que contém sua instância de Operações do Azure IoT ou procure e selecione Operações do Azure IoT.

2. Selecione o nome da sua instância de Operações do Azure IoT.

3. Na página Visão geral da instância, a tabela Arc extensions exibe os recursos que foram implantados no cluster.

   

CLI do Azure

Use o az iot ops show comando para exibir as propriedades de uma instância.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Você também pode usar o az iot ops show comando para exibir os recursos em sua implantação do Azure IoT Operations na CLI do Azure. Adicione o sinalizador --tree para mostrar uma exibição em árvore da implantação que inclui a instância especificada do Azure IoT Operations.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

O modo de exibição em árvore de uma implantação se parece com o exemplo a seguir:

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Você pode executar az iot ops check em seu cluster para avaliar a integridade e as configurações de componentes individuais do Azure IoT Operations. Por padrão, o comando verifica MQ, mas você pode especificar o serviço com --ops-service parâmetro.

Atualizar tags de instância e descrição

Portal do Azure

1. No portal do Azure, vá para o grupo de recursos que contém sua instância de Operações do Azure IoT ou procure e selecione Operações do Azure IoT.

2. Selecione o nome da sua instância de Operações do Azure IoT.

3. Na página Visão geral da sua instância, selecione Adicionar tags ou editar para modificar tags na sua instância.

CLI do Azure

Use o az iot ops update comando para editar as marcas e os parâmetros de descrição da sua instância de Operações do Azure IoT. Os valores fornecidos no comando substituem update quaisquer tags ou descrições existentes

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

Para excluir todas as tags em uma instância, defina o parâmetro tags como um valor nulo. Por exemplo:

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

Gerenciar componentes

Cada instância de Operações IoT do Azure inclui vários componentes, como o agente MQTT, o conector para OPC UA e fluxos de dados. Para saber mais sobre como gerenciar esses componentes, consulte seus respetivos artigos. Por exemplo, para gerenciar o broker MQTT, comece com Visão geral do broker.

(Pré-visualização) Gerenciar componentes usando manifestos de implantação do Kubernetes

Em geral, o Azure IoT Operations usa a plataforma Azure Arc para fornecer uma experiência de nuvem híbrida onde você pode gerenciar a configuração por meio do Azure Resource Manager (ARM) e ferramentas de front-end, como o portal do Azure, o Bicep e a CLI do Azure.

No entanto, você também pode gerenciar os componentes do Azure IoT Operations usando manifestos de implantação do YAML Kubernetes. Isso significa que você pode usar ferramentas como kubectl gerenciar alguns componentes das Operações do Azure IoT. Esta funcionalidade está em pré-visualização e tem algumas limitações:

• Apenas alguns componentes suportam o uso de manifestos de implantação do Kubernetes. Esses componentes são o broker MQTT e os fluxos de dados. Outros componentes, como o conector para serviços OPC UA e Akri, não suportam esse recurso.
• A menos que o Azure IoT Operations seja implantado com a sincronização de recursos habilitada usando az iot ops create --enable-rsync, as alterações feitas nos recursos usando manifestos de implantação do Kubernetes não são sincronizadas com o Azure. Para saber mais sobre a sincronização de recursos, consulte Sincronização de recursos.
• Mesmo que a sincronização de recursos esteja habilitada, os novos recursos criados usando manifestos de implantação do Kubernetes não são sincronizados com o Azure. Apenas as alterações aos recursos existentes são sincronizadas.

Desinstale o .

A CLI do Azure e o portal do Azure oferecem opções diferentes para desinstalar as Operações IoT do Azure.

As etapas do portal do Azure podem excluir uma instância de Operações IoT do Azure, mas não podem afetar os recursos relacionados na implantação. Se você quiser excluir toda a implantação, use a CLI do Azure.

Portal do Azure

1. No portal do Azure, vá para o grupo de recursos que contém sua instância de Operações do Azure IoT ou procure e selecione Operações do Azure IoT.

2. Selecione o nome da sua instância de Operações do Azure IoT.

3. Na página Visão geral da instância, selecione Excluir.

4. Analise a lista de recursos que são ou não excluídos como parte desta operação, digite o nome da sua instância e selecione Excluir para confirmar.

   

CLI do Azure

Use o comando az iot ops delete para excluir toda a implantação do Azure IoT Operations de um cluster. O delete comando avalia os recursos relacionados às Operações do Azure IoT no cluster e apresenta uma exibição em árvore dos recursos a serem excluídos. O cluster deve estar online quando você executa esse comando.

O delete comando simplifica a reimplantação das Operações IoT do Azure no mesmo cluster. Ele desfaz o create comando para que você possa executar create, delete, create novamente e assim por diante sem ter que executar initnovamente.

O delete comando remove:

• A instância de Operações IoT do Azure
• Extensões de arco
• Locais personalizados
• Regras de sincronização de recursos
• Recursos que você pode configurar em sua solução de Operações IoT do Azure, como ativos, agente MQTT e fluxos de dados.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Para excluir a instância e também remover as dependências do Azure IoT Operations (a saída de init), adicione o sinalizador --include-deps.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps