Wdrażanie operacji Azure IoT w klastrze testowym

Dowiedz się, jak wdrożyć Operacje Azure IoT w klastrze testowym, który jest klastrem Kubernetes z obsługą usługi Arc, którego można użyć na potrzeby scenariuszy testowania i oceny.

Jeśli chcesz wdrożyć Operacje Azure IoT w klastrze produkcyjnym, zobacz Deploy Operacje Azure IoT w klastrze produkcyjnym.

Zanim rozpoczniesz

W tym artykule omówiono Operacje Azure IoT deployments i instances które są dwiema różnymi pojęciami:

• Operacje Azure IoT deployment opisuje wszystkie składniki i zasoby, które umożliwiają scenariusz Operacje Azure IoT. Te składniki i zasoby obejmują:

  • Instancja Operacje Azure IoT
  • Rozszerzenia usługi Arc
  • Lokalizacje niestandardowe
  • Zasoby, które można skonfigurować w rozwiązaniu Operacje Azure IoT, takie jak zasoby i urządzenia.

• Operacje Azure IoT instance to zasób nadrzędny, który łączy pakiet usług zdefiniowanych w Czym jest Operacje Azure IoT?, takich jak broker MQTT, przepływy danych i łącznik dla OPC UA.

Kiedy mówimy o wdrażaniu Operacje Azure IoT, oznaczamy pełny zestaw składników tworzących deployment. Po utworzeniu wdrożenia można wyświetlać wystąpienie, zarządzać nim i aktualizować je.

Wymagania wstępne

Zasoby w chmurze:

• Subskrypcja Azure. Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz je bezpłatnie .

• Azure uprawnienia dostępu. Aby uzyskać więcej informacji, zobacz Omówienie > wdrożenia Wymagane uprawnienia.

Zasoby do rozwoju

• Na komputerze deweloperskim zainstalowano Azure CLI. Sprawdź dostępne rozszerzenia Azure CLI dla minimalnej wymaganej wersji do korzystania z rozszerzenia azure-iot-ops. Użyj az --version do sprawdzenia swojej wersji i az upgrade do aktualizacji, jeśli to konieczne. Aby uzyskać więcej informacji, zobacz Install the Azure CLI .

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

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

Host klastra:

• Mając klaster Kubernetes z funkcją Azure Arc, z włączonymi funkcjami lokalizacji niestandardowej i tożsamości obciążenia. Jeśli go nie masz, wykonaj kroki opisane w Przygotowanie klastra Kubernetes z obsługą Azure Arc.

  Jeśli wcześniej wdrożono Operacje Azure IoT w klastrze, odinstaluj te zasoby przed kontynuowaniem. Aby uzyskać więcej informacji, zobacz Update Operacje Azure IoT.

Automatyczna kardynalność

Aby automatycznie określić początkową kardynalność podczas wdrożenia, pomiń pole cardinality w zasobie Broker. Operator brokera MQTT wdraża odpowiednią liczbę zasobników na podstawie liczby dostępnych węzłów w momencie wdrożenia. Ta funkcja jest przydatna w scenariuszach nieprodukcyjnych, w których nie trzeba dostosowywać ustawień wysokiej dostępności ani skalowania.

Aby użyć automatycznej kardynalności, przygotuj plik konfiguracji Brokera w formacie JSON, który pomija pole cardinality. Na przykład ustaw tylko profil pamięci:

{
  "memoryProfile": "Medium"
}

Następnie wdróż z flagą --broker-config-file (inne parametry pominięte dla zwięzłości):

az iot ops create ... --broker-config-file <FILE>.json

Aby uzyskać więcej informacji, zobacz obsługę zaawansowanej konfiguracji brokera MQTT w Azure CLI.

Wdrażanie w portalu Azure

Basics

Środowisko wdrażania portalu Azure to narzędzie pomocnicze, które generuje polecenie wdrożenia na podstawie zasobów i konfiguracji. Ostatnim krokiem jest uruchomienie polecenia Azure CLI, dlatego nadal potrzebne są wymagania wstępne Azure CLI opisane w poprzedniej sekcji.

1. Zaloguj się do portalu Azure.

2. W polu wyszukiwania wyszukaj i wybierz pozycję Operacje Azure IoT.

3. Wybierz Utwórz.

4. Na karcie Podstawowe podaj następujące informacje:

   Parameter	Wartość
   Subskrypcja	Wybierz subskrypcję zawierającą klaster włączony do Arc.
   Grupa zasobów	Wybierz grupę zasobów, która zawiera klaster z włączoną usługą Arc.
   Nazwa klastra	Wybierz klaster, do którego chcesz wdrożyć Operacje Azure IoT.
   Niestandardowa nazwa lokalizacji	Opcjonalnie: Zamień domyślną nazwę niestandardowej lokalizacji.
   Wersja wdrożenia	Wybierz wersję 1.2 (najnowszą). Aby uzyskać więcej informacji, zobacz Wersje operacji IoT.
   Komponenty opcjonalne wdrażania > łącznika OPC UA	Wybierz opcjonalny konektor do komponentu OPC UA.

5. Wybierz Dalej: Konfiguracja.

Configuration

1. Na karcie Konfiguracja podaj następujące informacje:

   Parameter	Wartość
   nazwa Operacje Azure IoT	Opcjonalnie: Zastąp domyślną nazwę instancji operacyjnej Azure IoT.
   Konfiguracja brokera MQTT	Opcjonalnie: edytuj ustawienia domyślne brokera MQTT. W portalu Azure można skonfigurować profil cardinality i memory. Aby skonfigurować inne ustawienia, w tym bufor komunikatów oparty na dysku i zaawansowane opcje klienta MQTT, zobacz pomoc Azure CLI w zakresie zaawansowanej konfiguracji brokera MQTT.
   Konfiguracja profilu przepływu danych	Opcjonalnie: Edytuj ustawienia domyślne przepływów danych. Aby uzyskać więcej informacji, zobacz Konfigurowanie profilu przepływu danych.

   Zrzut ekranu przedstawiający drugą kartę do wdrażania Operacje Azure IoT z poziomu portalu.

2. Wybierz pozycję Dalej: Zarządzanie zależnościami.

Zarządzanie zależnościami

1. Na karcie Zarządzanie zależnościami wybierz istniejący rejestr schematów lub wykonaj następujące kroki, aby je utworzyć:

   1. Wybierz pozycjęUtwórz nowy.

   2. Wprowadź nazwę rejestru schematu i przestrzeń nazw rejestru schematu.

   3. Wybierz Wybierz kontener Azure Storage.

   4. Wybierz konto magazynu z listy kont z obsługą hierarchicznych przestrzeni nazw lub wybierz pozycję Utwórz , aby je utworzyć.

      Rejestr schematów wymaga konta usługi Azure Storage z włączoną hierarchiczną strukturą przestrzeni nazw i dostępem do sieci publicznej. Podczas tworzenia nowego konta magazynu wybierz typ konta magazynu ogólnego przeznaczenia w wersji 2 i ustaw hierarchiczną przestrzeń nazw na Włączone.

      Aby uzyskać więcej informacji na temat konfigurowania konta magazynu, zobacz Wytyczne dotyczące wdrażania produkcyjnego.

   5. Wybierz kontener na koncie magazynu lub wybierz pozycję Kontener , aby go utworzyć.

   6. Wybierz pozycję Zastosuj , aby potwierdzić konfiguracje rejestru schematów.

2. Operacje Azure IoT używa namespaces do organizowania zasobów i urządzeń. Każde wystąpienie Operacje Azure IoT używa jednej przestrzeni nazw dla swoich zasobów i urządzeń. Na karcie zarządzanie Zależności wybierz istniejącą przestrzeń nazw rejestru urządzeń Azure lub wykonaj następujące kroki, aby je utworzyć:

   1. Wybierz pozycjęUtwórz nowy.

   2. Na karcie Podstawowe podaj następujące informacje:

      Parameter	Wartość
      Subskrypcja	Wybierz swoją subskrypcję.
      Grupa zasobów	Wybierz grupę zasobów zawierającą wystąpienie Operacje Azure IoT.
      Nazwa	Wprowadź unikatową nazwę przestrzeni nazw.
      Region	Wybierz region Azure do przechowywania przestrzeni nazw.

      Wybierz przycisk Dalej, aby kontynuować.

   3. Na karcie Tagi możesz opcjonalnie dodać tagi do przestrzeni nazw. Wybierz przycisk Dalej, aby kontynuować.

   4. Na karcie Przeglądanie + tworzenie przejrzyj konfiguracje i wybierz pozycję Utwórz , aby utworzyć przestrzeń nazw.

   5. Na karcie Zarządzanie zależnościami wybierz nowo utworzoną przestrzeń nazw z listy.

Opcje wdrażania

1. Na karcie Zarządzanie zależnościami wybierz opcję Wdrożenia ustawień testu . Ta opcja używa ustawień domyślnych, które są zalecane do celów testowych.

   

2. Wybierz pozycję Dalej: Automatyzacja.

Uruchamianie poleceń Azure CLI

Ostatnim krokiem w środowisku wdrażania portalu Azure jest uruchomienie zestawu poleceń Azure CLI w celu wdrożenia Operacje Azure IoT w klastrze. Portal generuje te polecenia na podstawie informacji podanych w poprzednich krokach.

Pojedynczo uruchom każde polecenie Azure CLI na karcie Automation w terminalu:

1. Zaloguj się do Azure CLI interaktywnie przy użyciu przeglądarki, nawet jeśli już wcześniej się zalogowałeś. Jeśli nie logujesz się interaktywnie, może pojawić się błąd informujący, że w celu uzyskania dostępu do zasobu, Twoje urządzenie musi być zarządzane.

   az login
   

2. Zainstaluj najnowsze rozszerzenie interfejsu wiersza polecenia Operacje Azure IoT, jeśli jeszcze tego nie zrobiono.

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

3. Skopiuj i uruchom podaną komendę az iot ops schema registry create w celu utworzenia rejestru schematów używanego przez składniki Operacje Azure IoT. Jeśli zdecydujesz się używać istniejącego rejestru schematów, to polecenie nie jest wyświetlane na karcie Automatyzacja .

4. Przygotuj klaster do wdrożenia Operacje Azure IoT. Skopiuj i uruchom podane polecenie az iot ops init .

   Wskazówka

   Polecenie init musi być uruchamiane tylko raz na klaster. Jeśli postępowałeś zgodnie z opcjonalnymi wymaganiami wstępnymi dotyczącymi skonfigurowania własnego wystawcy urzędu certyfikacji, wykonaj kroki opisane w sekcji Skonfiguruj własnego wystawcę.

   Wykonanie tego polecenia może potrwać kilka minut. Postęp procesu wdrażania można obserwować na wyświetlaczu postępu w terminalu.

5. Aby wdrożyć Operacje Azure IoT, skopiuj i uruchom podane polecenie az iot ops create. Wykonanie tego polecenia może potrwać kilka minut. Postęp procesu wdrażania można obserwować na wyświetlaczu postępu w terminalu.

6. Po pomyślnym zakończeniu wszystkich poleceń Azure CLI można zamknąć kreatora Instaluj Operacje Azure IoT.

Po pomyślnym zakończeniu polecenia create masz działające wystąpienie Operacje Azure IoT uruchomione w klastrze. Na tym etapie wystąpienie jest skonfigurowane dla większości scenariuszy testowania i oceny.

Weryfikowanie wdrożenia

Po zakończeniu wdrożenia użyj az iot ops check, aby ocenić wdrożenie usługi IoT Operations pod kątem stanu, konfiguracji i użyteczności. Polecenie check pomaga znaleźć problemy we wdrożeniu i konfiguracji.

az iot ops check

Polecenie check zgłasza, że kontrole przepływu danych są pomijane, gdy nie ma jeszcze żadnych przepływów danych, co jest normalne i oczekiwane do momentu utworzenia przepływu danych. Aby uzyskać więcej informacji, zobacz Przetwarzanie i kierowanie danych za pomocą przepływów danych.

Aby sprawdzić konfiguracje mapowań tematów, QoS i tras wiadomości, dodaj parametr --detail-level 2 do polecenia check, aby wyświetlić szczegółowe informacje.

Aby wyświetlić wszystkie dostępne wersje rozszerzenia interfejsu wiersza polecenia Operacje Azure IoT, uruchom następujące polecenie:

az iot ops get-versions

Dalsze kroki

• Skonfiguruj możliwość obserwowania , aby skonfigurować monitorowanie i pulpity nawigacyjne.
• Wdrożone wystąpienie Operacje Azure IoT jest skonfigurowane na potrzeby scenariuszy testowania. Jeśli chcesz włączyć bezpieczne ustawienia i przygotować wystąpienie do scenariuszy produkcyjnych, wykonaj kroki opisane w artykule Włączanie bezpiecznych ustawień w istniejącym wystąpieniu Operacje Azure IoT.