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

Importante

Azure IoT Operations Preview – habilitado pelo Azure Arc está atualmente em visualização. Não deve utilizar este software de pré-visualização em ambientes de produção.

Você precisará implantar uma nova instalação do Azure IoT Operations quando uma versão disponível ao público estiver disponível. Você não poderá atualizar uma instalação de visualização.

Para obter os termos legais que se aplicam aos recursos do Azure que estão em versão beta, em visualização ou ainda não lançados em disponibilidade geral, consulte os Termos de Uso Suplementares para Visualizações do Microsoft Azure.

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 ""

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

Atualização

Na visualização pública, o Azure IoT Operations oferece suporte à atualização de instâncias da versão 0.7.x para 0.8.x.

Quando uma versão disponível em geral for disponibilizada, você precisará implantar uma nova instalação do Azure IoT Operations. Não será possível atualizar a partir de uma instalação de pré-visualizaçã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 instância, selecione Atualizar.

4. O assistente Atualizar Operações do Azure IoT solicita que você verifique se você tem a versão mais recente para a extensão da CLI de Operações do Azure IoT. Copie e execute o comando fornecido az extension add .

5. Atualize para a versão mais recente da instância de Operações do Azure IoT. Copie e execute o comando fornecido az iot ops upgrade .

6. Quando o comando de atualização for concluído com êxito, você poderá sair do assistente e atualizar a página da instância.

CLI do Azure

Use o comando para atualizar uma implantação do az iot ops upgrade Azure IoT Operations. Este comando:

• Atualiza as extensões do Azure Arc em seu cluster.
• Atualiza a instância de Operações do Azure IoT.

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