Szybki start: konfigurowanie klastra

W tym przewodniku Szybki start skonfigurujesz następujące zasoby w klastrze operacji usługi Azure IoT:

  • Urządzenie, które definiuje połączenie z symulowanym serwerem OPC PLC, który symuluje piekarnik w piekarni.
  • Zasób reprezentujący piekarnik i definiuje punkty danych udostępniane przez piekarnik.
  • Przepływ danych, który manipuluje komunikatami z symulowanego piekarnika.

W kontekście operacji usługi Azure IoT zasób jest logiczną reprezentacją urządzenia fizycznego lub systemu, który chcesz monitorować lub kontrolować.

Serwery OPC UA to oprogramowanie komunikujące się z zasobami. Punkty danych OPC UA to wartości uwidaczniane przez serwery OPC UA. Punkty danych OPC UA mogą dostarczać dane historyczne dotyczące stanu, wydajności, jakości lub stanu zasobów w czasie rzeczywistym.

W tym szybkim starcie użyjesz pliku Bicep do skonfigurowania wystąpienia Operacje Azure IoT.

Wskazówka

Jeśli wolisz dłuższy samouczek, który przeprowadzi Cię przez te same kroki bardziej szczegółowo i zawiera dodatkowe szczegóły, takie jak konfiguracja zabezpieczeń, zobacz Samouczek: dodawanie zasobów OPC UA do klastra operacji usługi Azure IoT.

Wymagania wstępne

Posiadaj instancję usługi Operacje Azure IoT wdrożoną w klastrze Kubernetes. Przewodnik Szybki start: uruchamianie operacji Azure IoT w GitHub Codespaces z K3s zawiera proste instrukcje dotyczące wdrażania wystąpienia operacji Azure IoT, którego można użyć na potrzeby szybkiego startu.

Jeśli nie określono inaczej, możesz uruchomić polecenia konsoli w tym quickstart za pomocą środowiska Bash lub PowerShell.

Jaki problem rozwiążemy?

Dane udostępniane przez serwery OPC UA mogą mieć złożoną strukturę i mogą być trudne do zrozumienia. Operacje usługi Azure IoT umożliwiają modelowanie zasobów OPC UA jako punktów danych, zdarzeń i akcji. Modelowanie ułatwia zrozumienie danych i używanie ich w procesach podrzędnych, takich jak broker MQTT i przepływy danych. Przepływy danych umożliwiają manipulowanie danymi i kierowanie ich do usług w chmurze, takich jak Azure Event Hubs. W tym wprowadzeniu Quickstart przepływ danych zmienia nazwy niektórych pól danych i dodaje identyfikator zasobu do komunikatów.

Wdrażanie symulatora OPC PLC

Ten szybki start używa symulatora OPC PLC do generowania danych przykładowych. Aby wdrożyć symulator OPC PLC, uruchom następujące polecenie:

kubectl apply -f https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/quickstarts/opc-plc-deployment.yaml

Uwaga

Ta konfiguracja używa certyfikatu wystąpienia aplikacji z podpisem własnym. Nie używaj tej konfiguracji w środowisku produkcyjnym. Aby dowiedzieć się więcej, zobacz Konfigurowanie infrastruktury certyfikatów OPC UA dla łącznika OPC UA.


Ustawianie zmiennych środowiskowych

Jeśli używasz środowiska Codespaces, wymagane zmienne środowiskowe są już ustawione i możesz pominąć ten krok. W przeciwnym razie ustaw następujące zmienne środowiskowe w powłoce:

# Your subscription ID
SUBSCRIPTION_ID=<subscription-id>

# The name of the resource group where your Kubernetes cluster is deployed
RESOURCE_GROUP=<resource-group-name>

# The name of your Kubernetes cluster
CLUSTER_NAME=<kubernetes-cluster-name>

Konfigurowanie klastra

Uruchom następujące polecenia, aby pobrać i uruchomić plik Bicep, który konfiguruje instancję Operacje Azure IoT. Plik Bicep:

  • Dodaje urządzenie łączące się z symulatorem OPC PLC.
  • Dodaje zasób reprezentujący piekarnik i definiuje punkty danych udostępniane przez piekarnik.
  • Dodaje przepływ danych, który manipuluje komunikatami z symulowanego piekarnika.
  • Tworzy wystąpienie usługi Azure Event Hubs w celu odbierania danych.
wget https://raw.githubusercontent.com/Azure-Samples/explore-iot-operations/main/samples/quickstarts/quickstart.bicep -O quickstart.bicep

AIO_EXTENSION_NAME=$(az k8s-extension list -g $RESOURCE_GROUP --cluster-name $CLUSTER_NAME --cluster-type connectedClusters --query "[?extensionType == 'microsoft.iotoperations'].id" -o tsv | awk -F'/' '{print $NF}')
AIO_INSTANCE_NAME=$(az iot ops list -g $RESOURCE_GROUP --query "[0].name" -o tsv)
CUSTOM_LOCATION_NAME=$(az iot ops list -g $RESOURCE_GROUP --query "[0].extendedLocation.name" -o tsv | awk -F'/' '{print $NF}')

az deployment group create --subscription $SUBSCRIPTION_ID --resource-group $RESOURCE_GROUP --template-file quickstart.bicep --parameters clusterName=$CLUSTER_NAME customLocationName=$CUSTOM_LOCATION_NAME aioExtensionName=$AIO_EXTENSION_NAME aioInstanceName=$AIO_INSTANCE_NAME adrNamespaceName=myqsnamespace

Przeglądanie konfiguracji

Plik Bicep skonfigurował następujące zasoby:

  • Urządzenie łączące się z symulatorem OPC PLC.
  • Zasób reprezentujący piekarnik i definiuje punkty danych udostępniane przez piekarnik.
  • Przepływ danych, który przetwarza wiadomości z symulowanego piekarnika.
  • Przestrzeń nazw Azure Event Hubs, która zawiera docelowy hub dla przepływu danych.

Aby wyświetlić przepływ urządzeń, zasobów i danych, przejdź w przeglądarce do interfejsu użytkownika operations experience i zaloguj się przy użyciu poświadczeń Microsoft Entra ID. Ponieważ pracujesz z nowym wdrożeniem, nie ma jeszcze żadnych witryn. Możesz znaleźć klaster utworzony w poprzedniej instrukcji szybkiego startu, wybierając Wyświetl nieprzypisane wystąpienia. W środowisku operacji wystąpienie reprezentuje klaster, w którym wdrożono operacje usługi Azure IoT.

Zrzut ekranu przedstawiający środowisko operacji pokazujące nieprzypisane wystąpienia.

Przed kontynuowaniem upewnij się, że wszystkie zasoby znajdują się w stanie Dostępne . Utworzenie zasobów i wyświetlenie ich w interfejsie użytkownika może potrwać kilka minut.

Zrzut ekranu przedstawiający środowisko operacji, które pokazuje wszystkie zasoby jako dostępne.

Urządzenie opc-ua-connector definiuje połączenie z symulatorem PLC OPC.

Zrzut ekranu przedstawiający środowisko operacji z listą urządzeń.

Zasób piekarnika definiuje punkty danych udostępniane przez piekarnik:

Zrzut ekranu przedstawiający środowisko operacji z listą zasobów.

Przepływ danych definiuje, jak wiadomości z symulowanego piekarnika są przetwarzane i kierowane do Event Hubów w chmurze:

Zrzut ekranu przedstawiający środowisko operacji z listą przepływów danych.

Poniższy zrzut ekranu przedstawia sposób konfigurowania przepływu danych konwersji temperatury:

Zrzut ekranu przedstawiający środowisko operacji pokazujące obliczenie konwersji temperatury.

Sprawdzanie, czy dane przepływają do usługi Event Hubs

Aby sprawdzić, czy dane przepływają do chmury, możesz wyświetlić instancję Event Hubs w portalu Azure. Może być konieczne odczekanie kilku minut na uruchomienie przepływu danych i przepływ komunikatów do centrum zdarzeń.

Zastosowana wcześniej konfiguracja Bicep utworzyła przestrzeń nazw usługi Event Hubs i centrum, które jest używane jako miejsce docelowe przez przepływ danych. Aby wyświetlić przestrzeń nazw i centrum, przejdź do grupy zasobów w portalu Azure zawierającej wystąpienie operacji IoT, a następnie wybierz przestrzeń nazw usługi Event Hubs.

Jeśli komunikaty przepływają do wystąpienia, możesz zobaczyć liczbę przychodzących komunikatów na stronie Przegląd wystąpienia:

Zrzut ekranu przedstawiający stronę przeglądu wystąpienia usługi Event Hubs z komunikatami przychodzącymi.

Jeśli komunikaty przepływają, możesz użyć Eksploratora danych, aby wyświetlić komunikaty:

Zrzut ekranu strony instancji Event Hubs **Eksplorator danych**.

Wskazówka

Aby wyświetlić komunikaty, może być konieczne przypisanie siebie do roli odbiornika danych usługi Azure Event Hubs.

Jak rozwiązaliśmy ten problem?

W tym przewodniku Szybki start użyto pliku bicep do skonfigurowania wystąpienia operacji usługi Azure IoT przy użyciu przepływu urządzenia, zasobu i danych. Konfiguracja przetwarza i kieruje dane z symulowanego piekarnika. Przepływ danych w konfiguracji kieruje komunikaty do wystąpienia usługi Azure Event Hubs.

Czyszczenie zasobów

Jeśli przejdziesz do następnego przewodnika Szybki start, zachowaj wszystkie zasoby.

Jeśli robisz przerwę przed przejściem do kolejnego przewodnika Szybki start, zalecamy zatrzymanie codespace, aby uniknąć niepotrzebnych kosztów. Aby uzyskać więcej informacji, zobacz Zatrzymywanie i uruchamianie przestrzeni kodu.

Jeśli chcesz usunąć wszystkie zasoby utworzone na potrzeby tego przewodnika Szybki start, usuń grupę zasobów Azure zawierającą połączony klaster Azure Arc i inne zasoby używane w tym przewodniku Szybki start. Następnie usuń swój codespace i utworzone dla niego sekrety w serwisie GitHub. Aby usunąć przestrzeń kodu i wpisy tajne, zobacz Usuwanie przestrzeni kodu i Usuwanie wpisów tajnych.

Następny krok