Zarządzanie cyklem życia wystąpienia operacji usługi Azure IoT

Ważne

Usługa Azure IoT Operations Preview — włączona przez usługę Azure Arc jest obecnie dostępna w wersji zapoznawczej. Nie należy używać tego oprogramowania w wersji zapoznawczej w środowiskach produkcyjnych.

Po udostępnieniu ogólnie dostępnej wersji należy wdrożyć nową instalację operacji usługi Azure IoT. Nie będzie można uaktualnić instalacji w wersji zapoznawczej.

Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

Użyj interfejsu wiersza polecenia platformy Azure i witryny Azure Portal, aby zarządzać, odinstalować lub aktualizować wystąpienia operacji usługi Azure IoT.

Wymagania wstępne

• Wystąpienie operacji usługi Azure IoT wdrożone w klastrze. Aby uzyskać więcej informacji, zobacz Wdrażanie operacji usługi Azure IoT.

• Interfejs wiersza polecenia platformy Azure zainstalowany na komputerze deweloperskim. Ten scenariusz wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.64.0 lub nowszej. Użyj az --version polecenia , aby sprawdzić wersję i az upgrade zaktualizować w razie potrzeby. Aby uzyskać więcej informacji, zobacz Jak zainstalować interfejs wiersza polecenia platformy Azure.

• Rozszerzenie Operacje usługi Azure IoT dla interfejsu wiersza polecenia platformy Azure. Użyj następującego polecenia, aby dodać rozszerzenie lub zaktualizować je do najnowszej wersji:

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

Zarządzanie

Po wdrożeniu możesz użyć interfejsu wiersza polecenia platformy Azure i witryny Azure Portal, aby wyświetlić wystąpienie operacji usługi Azure IoT i zarządzać nim.

Wyświetlanie listy wystąpień

Interfejs wiersza polecenia platformy Azure

az iot ops list Użyj polecenia , aby wyświetlić wszystkie wystąpienia operacji usługi Azure IoT w subskrypcji lub grupie zasobów.

Podstawowe polecenie zwraca wszystkie wystąpienia w subskrypcji.

az iot ops list

Aby filtrować wyniki według grupy zasobów, dodaj --resource-group parametr .

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

Witryna Azure Portal

1. W witrynie Azure Portal wyszukaj i wybierz pozycję Operacje usługi Azure IoT.
2. Użyj filtrów, aby wyświetlić wystąpienia operacji usługi Azure IoT na podstawie subskrypcji, grupy zasobów i nie tylko.

Wyświetl wystąpienie

Interfejs wiersza polecenia platformy Azure

Użyj polecenia , az iot ops show aby wyświetlić właściwości wystąpienia.

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

Możesz również użyć az iot ops show polecenia , aby wyświetlić zasoby we wdrożeniu operacji usługi Azure IoT w interfejsie wiersza polecenia platformy Azure. Dodaj flagę --tree , aby wyświetlić widok drzewa wdrożenia, który zawiera określone wystąpienie operacji usługi Azure IoT.

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

Widok drzewa wdrożenia wygląda podobnie do następującego przykładu:

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

Możesz uruchomić az iot ops check w klastrze, aby ocenić kondycję i konfiguracje poszczególnych składników operacji usługi Azure IoT. Domyślnie polecenie sprawdza MQ, ale można określić usługę z parametrem --ops-service .

Witryna Azure Portal

Wystąpienie operacji usługi Azure IoT można wyświetlić w witrynie Azure Portal.

1. W witrynie Azure Portal przejdź do grupy zasobów zawierającej wystąpienie operacji usługi Azure IoT lub wyszukaj i wybierz pozycję Operacje usługi Azure IoT.

2. Wybierz nazwę wystąpienia operacji usługi Azure IoT.

3. Na stronie Przegląd wystąpienia tabela rozszerzeń usługi Arc zawiera zasoby wdrożone w klastrze.

   

Aktualizowanie tagów i opisu wystąpienia

Interfejs wiersza polecenia platformy Azure

az iot ops update Użyj polecenia , aby edytować tagi i parametry opisu wystąpienia operacji usługi Azure IoT. Wartości podane w poleceniu update zastępują wszystkie istniejące tagi lub opis

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

Aby usunąć wszystkie tagi w wystąpieniu, ustaw parametr tagów na wartość null. Na przykład:

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

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do grupy zasobów zawierającej wystąpienie operacji usługi Azure IoT lub wyszukaj i wybierz pozycję Operacje usługi Azure IoT.

2. Wybierz nazwę wystąpienia operacji usługi Azure IoT.

3. Na stronie Przegląd wystąpienia wybierz pozycję Dodaj tagi lub edytuj, aby zmodyfikować tagi w wystąpieniu.

Odinstaluj program

Interfejs wiersza polecenia platformy Azure i witryna Azure Portal oferują różne opcje odinstalowywania operacji usługi Azure IoT.

Kroki witryny Azure Portal umożliwiają usunięcie wystąpienia operacji usługi Azure IoT, ale nie mogą mieć wpływu na powiązane zasoby we wdrożeniu. Jeśli chcesz usunąć całe wdrożenie, użyj interfejsu wiersza polecenia platformy Azure.

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot ops delete, aby usunąć całe wdrożenie operacji usługi Azure IoT z klastra. Polecenie delete oblicza zasoby powiązane z operacjami usługi Azure IoT w klastrze i przedstawia widok drzewa zasobów do usunięcia. Klaster powinien być w trybie online po uruchomieniu tego polecenia.

Polecenie delete usprawnia ponowne wdrażanie operacji usługi Azure IoT w tym samym klastrze. Spowoduje to cofnięcie create polecenia, aby można było uruchomić createpolecenie , delete, create ponownie i tak dalej bez konieczności ponownego uruchamiania init.

Polecenie delete usuwa:

• Wystąpienie operacji usługi Azure IoT
• Rozszerzenia usługi Arc
• Lokalizacje niestandardowe
• Reguły synchronizacji zasobów
• Zasoby, które można skonfigurować w rozwiązaniu Operacje usługi Azure IoT, takie jak zasoby, broker MQTT i przepływy danych.

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

Aby usunąć wystąpienie, a także usunąć zależności operacji usługi Azure IoT (dane wyjściowe initpolecenia ), dodaj flagę --include-deps.

Witryna Azure Portal

1. W witrynie Azure Portal przejdź do grupy zasobów zawierającej wystąpienie operacji usługi Azure IoT lub wyszukaj i wybierz pozycję Operacje usługi Azure IoT.

2. Wybierz nazwę wystąpienia operacji usługi Azure IoT.

3. Na stronie Przegląd wystąpienia wybierz pozycję Usuń wystąpienie.

4. Przejrzyj listę zasobów, które są i nie zostały usunięte w ramach tej operacji, a następnie wpisz nazwę wystąpienia i wybierz pozycję Usuń , aby potwierdzić.

   

Zaktualizuj

Obecnie nie ma obsługi aktualizowania istniejącego wdrożenia operacji usługi Azure IoT. Zamiast tego odinstaluj i ponownie wdróż nową wersję operacji usługi Azure IoT.

1. Użyj polecenia az iot ops delete, aby usunąć wdrożenie operacji usługi Azure IoT w klastrze.

   az iot ops delete --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP>
   

2. Zaktualizuj rozszerzenie interfejsu wiersza polecenia, aby uzyskać najnowszą wersję operacji usługi Azure IoT.

   az extension update --name azure-iot-ops
   

3. Wykonaj kroki opisane w tym artykule, aby wdrożyć najnowszą wersję operacji usługi Azure IoT w klastrze.

   Napiwek

   Dodaj flagę --ensure-latest do polecenia , aby sprawdzić, czy zainstalowano najnowszą wersję interfejsu az iot ops init wiersza polecenia operacji usługi Azure IoT i zgłosić błąd, jeśli uaktualnienie jest dostępne.