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

Artigo
11/20/2024

Use a CLI do Azure e o portal do Azure para gerenciar, desinstalar ou atualizar instâncias de Operações de IoT do Azure.

Pré-requisitos

Uma instância de Operações IoT do Azure implantada em um cluster. Para obter mais informações, confira Implantar Operações do Azure IoT.
CLI do Azure instalada em seu computador de desenvolvimento. Esse 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 para atualizar, se necessário. Para obter mais informações, confira Como instalar a CLI do Azure.
A extensão das Operações do Azure IoT para a CLI do Azure. Use o seguinte comando para adicionar a extensão ou atualizá-la à versão mais recente:
```
az extension add --upgrade --name azure-iot-ops
```

Gerenciar

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

No portal do Azure, pesquise e selecione Operações do Azure IoT.
Use os filtros para exibir as instâncias de Operações do Azure IoT com base na assinatura, no grupo de recursos e muito mais.

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

O comando básico retorna todas as instâncias em sua assinatura.

az iot ops list

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

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

Exibir instância

Portal do Azure
CLI do Azure

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

No portal do Azure, acesse o grupo de recursos que contém sua instância das Operações do Azure IoT ou procure e selecione Operações do Azure IoT.
Selecione o nome da sua instância das Operações do Azure IoT.
Na página Visão geral de sua instância, a tabela Extensões do Arc exibe os recursos que foram implantados no seu cluster.

Use o comando az iot ops show 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 comando az iot ops show para exibir os recursos em sua implantação das Operações do Azure IoT na CLI do Azure. Adicione o sinalizador --tree para mostrar uma exibição de árvore da implantação que inclui a instância das Operações do Azure IoT especificada.

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

O modo de exibição de árvore de uma implantação é semelhante ao 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 das Operações do Azure IoT. Por padrão, o comando verifica o MQ, mas você pode especificar o serviço com o parâmetro --ops-service.

Atualizar marcas de instância e descrição

Portal do Azure
CLI do Azure

No portal do Azure, acesse o grupo de recursos que contém sua instância das Operações do Azure IoT ou procure e selecione Operações do Azure IoT.
Selecione o nome da sua instância das Operações do Azure IoT.
Na página Visão geral da instância, selecione Adicionar marcas ou editar para modificar marcas em sua instância.

Use o comando az iot ops update para editar as marcas e os parâmetros de descrição da instância das Operações do Azure IoT. Os valores fornecidos no comando update substituem quaisquer marcas ou descrição 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 marcas em uma instância, defina o parâmetro de marcas 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 respectivos artigos. Por exemplo, para gerenciar o Agente MQTT, comece com a visão geral do Agente.

(Versão prévia) Gerenciar componentes usando manifestos de implantação do Kubernetes

Em geral, o serviço Operações do Azure IoT usa a plataforma Azure Arc para fornecer uma experiência de nuvem híbrida em que você pode gerenciar a configuração por meio do ARM (Azure Resource Manager) 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 Operações do Azure IoT usando manifestos de implantação do Kubernetes YAML. Isso significa que você pode usar ferramentas como kubectl para gerenciar alguns componentes do Operações de IoT do Azure. Esse recurso está em versão prévia e tem algumas limitações:

Apenas alguns componentes dão suporte ao uso de manifestos de implantação do Kubernetes. Esses componentes são o Agente MQTT e os fluxos de dados. Outros componentes, como o conector para serviços OPC UA e Akri, não dão suporte a esse recurso.
A menos que o Operações de IoT do Azure 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 serã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, novos recursos criados usando manifestos de implantação do Kubernetes não serão sincronizados com o Azure. Somente as alterações nos recursos existentes são sincronizadas.

Desinstalar

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

As etapas do portal do Azure podem excluir uma instância das Operações do Azure IoT, 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
CLI do Azure

No portal do Azure, acesse o grupo de recursos que contém sua instância das Operações do Azure IoT ou procure e selecione Operações do Azure IoT.
Selecione o nome da sua instância das Operações do Azure IoT.
Na página Visão geral da instância, selecione Excluir.
Examine a lista de recursos que serão e que não serão excluídos como parte desta operação, digite o nome da instância e selecione Excluir para confirmar.

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

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

O comando delete remove:

A instância de Operações do Azure IoT
Extensões do Arc
Locais personalizados
Regras de sincronização de recursos
Recursos que você pode configurar em sua solução de Operações do Azure IoT, 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 de Operações de IoT do Azure (a saída de init), adicione o sinalizador --include-deps.

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

Compartilhar via