Azure IoT-bewerkingen implementeren in een productiecluster

Meer informatie over het implementeren van Azure IoT-bewerkingen naar een Kubernetes-cluster met beveiligde instellingen voor productie met behulp van de Azure-portal.

Als u een testexemplaren van Azure IoT-bewerkingen hebt geïmplementeerd in een cluster en u hetzelfde cluster wilt gebruiken voor productiescenario's, volgt u de stappen in Beveiligingsinstellingen voor een bestaand Azure IoT-bewerkingen exemplaar.

Voordat u begint

In dit artikel worden Azure IoT-bewerkingen deployments en instances besproken. Dit zijn twee verschillende concepten:

• Een Azure IoT-bewerkingen deployment beschrijft alle onderdelen en resources die het Azure IoT-bewerkingen scenario mogelijk maken. Deze onderdelen en resources omvatten:

  • Een Azure IoT-bewerkingen-exemplaar
  • Arc-extensies
  • Aangepaste locaties
  • Resources die u kunt configureren in uw Azure IoT-bewerkingen oplossing, zoals assets en apparaten.

• Een Azure IoT-bewerkingen instance is de bovenliggende resource die de suite met services bundelt die zijn gedefinieerd in Wat is Azure IoT-bewerkingen? zoals MQTT-broker, gegevensstromen en connector voor OPC UA.

Wanneer we het hebben over het implementeren van Azure IoT-bewerkingen, bedoelen we de volledige set onderdelen waaruit een deployment bestaat. Zodra de implementatie bestaat, kunt u het exemplaar bekijken, beheren en bijwerken.

Vereisten

Cloudbronnen

• Een Azure-abonnement. Als u geen Azure-abonnement hebt, kunt u er gratis een maken voordat u begint.

• Azure toegangsmachtigingen. Zie Implementatieoverzicht > vereiste machtigingen voor meer informatie.

Ontwikkelingsresources:

• De Azure CLI geïnstalleerd op uw ontwikkelcomputer. Controleer Beschikbare Azure CLI-extensies voor de minimaal vereiste versie om de azure-iot-ops-extensie te gebruiken. Gebruik az --version om uw versie te controleren en az upgrade om de versie zo nodig bij te werken. Zie De Azure CLI installeren voor meer informatie.

• De Azure IoT-bewerkingen-extensie voor de Azure CLI. Gebruik de volgende opdracht om de extensie toe te voegen of bij te werken naar de nieuwste versie:

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

Een clusterhost:

• Een Kubernetes-cluster met Azure Arc ingeschakeld, waarbij de aangepaste locatie- en workloadidentiteitsfuncties zijn ingeschakeld. Als u er nog geen hebt, volgt u de stappen in Prepareer uw Kubernetes-cluster met Azure Arc.

  Als u eerder Azure IoT-bewerkingen in uw cluster hebt geïmplementeerd, verwijdert u deze resources voordat u doorgaat. Zie Update Azure IoT-bewerkingen voor meer informatie.

• (Aanbevolen) Configureer uw eigen certificeringsinstantieverlener voordat u Azure IoT-bewerkingen implementeert: Bring your own issuer.

Implementeren in Azure-portal

Basics

De Azure portalimplementatie is een helperprogramma waarmee een implementatieopdracht wordt gegenereerd op basis van uw resources en configuratie. De laatste stap is het uitvoeren van een Azure CLI opdracht, dus u hebt nog steeds de Azure CLI vereisten nodig die in de vorige sectie worden beschreven.

1. Meld u aan bij Azure portal.

2. Zoek en selecteer Azure IoT-bewerkingen in het zoekvak.

3. Selecteer Maken.

4. Geef op het tabblad Basisbeginselen u de volgende gegevens op:

   Kenmerk	Waarde
   Abonnement	Selecteer het abonnement dat uw cluster met Arc bevat.
   Resourcegroep	Selecteer de resourcegroep die uw Arc-ingeschakelde cluster bevat.
   Clusternaam	Selecteer het cluster waarnaar u Azure IoT-bewerkingen wilt implementeren.
   Naam van aangepaste locatie	Optioneel: vervang de standaardnaam voor de aangepaste locatie.
   Implementatieversie	Selecteer versie 1.2 (nieuwste versie). Zie IoT Operations-versies voor meer informatie.
   Implementatie van optionele componenten van de OPC UA-connector>	Kies ervoor om de optionele connector voor HET OPC UA-onderdeel te implementeren.

5. Selecteer Volgende: Configuratie.

Configuration

1. Geef op het tabblad Configuratie de volgende informatie op:

   Kenmerk	Waarde
   Naam van Azure IoT-bewerkingen	Optional: Vervang de standaardnaam voor het Azure IoT-bewerkingen exemplaar.
   MQTT-brokerconfiguratie	Optioneel: bewerk de standaardinstellingen voor de MQTT-broker. In Azure portal kunt u cardinaliteit en memoryprofiel configureren. Zie Azure CLI-ondersteuning voor geavanceerde MQTT-brokerconfiguratie voor het configureren van andere instellingen, waaronder schijfondersteunde berichtbuffer, persistentie, diagnostische gegevens en geavanceerde MQTT-clientopties.
   Configuratie van gegevensstroomprofiel	Optioneel: bewerk de standaardinstellingen voor gegevensstromen. Zie Profiel voor gegevensstromen configureren voor meer informatie.

   

2. Selecteer Volgende: Afhankelijkheidsbeheer.

Beheer van afhankelijkheden

1. Selecteer op het tabblad Afhankelijkheidsbeheer een bestaand schemaregister of gebruik deze stappen om er een te maken:

   1. Selecteer Nieuw maken.

   2. Voer een schemaregisternaam en schemaregisternaamruimte in.

   3. Selecteer Azure Storage-container.

   4. Kies een opslagaccount in de lijst met hiërarchische accounts met naamruimte of selecteer Maken om er een te maken.

      Schemaregister vereist een Azure Storage-account waarvoor hiërarchische naamruimte en openbare netwerktoegang is ingeschakeld. Wanneer u een nieuw opslagaccount maakt, kiest u een opslagaccounttype algemeen gebruik v2 en stelt u hiërarchische naamruimtein op Ingeschakeld.

      Zie richtlijnen voor productie-implementatie voor meer informatie over het configureren van uw opslagaccount.

   5. Selecteer een container in uw opslagaccount of selecteer Container om er een te maken.

   6. Selecteer Toepassen om de schemaregisterconfiguraties te bevestigen.

2. Azure IoT-bewerkingen maakt gebruik van namespaces om assets en apparaten te organiseren. Elk Azure IoT-bewerkingen exemplaar maakt gebruik van één naamruimte voor de assets en apparaten. Selecteer op het tabblad Dependency management een bestaande Azure Device Registry-naamruimte of gebruik deze stappen om er een te maken:

   1. Selecteer Nieuw maken.

   2. Geef op het tabblad Basisbeginselen u de volgende gegevens op:

      Kenmerk	Waarde
      Abonnement	Selecteer uw abonnement.
      Resourcegroep	Selecteer de resourcegroep die uw Azure IoT-bewerkingen-exemplaar bevat.
      Naam	Voer een unieke naam in voor uw naamruimte.
      Region	Selecteer de Azure regio om uw naamruimte op te slaan.

      Selecteer Volgende om door te gaan.

   3. Op het tabblad Tags kunt u desgewenst tags toevoegen aan uw naamruimte. Selecteer Volgende om door te gaan.

   4. Controleer uw configuraties op het tabblad Controleren en maken en selecteer Maken om de naamruimte te maken.

   5. Selecteer op het tabblad Afhankelijkheidsbeheer de naamruimte die zojuist is gemaakt uit de lijst.

Implementatieopties

1. Selecteer op het tabblad Afhankelijkheidsbeheer de optie Implementatie van beveiligde instellingen .

   

2. Geef in de sectie Implementatieopties de volgende informatie op:

   Kenmerk	Waarde
   Abonnement	Selecteer het abonnement dat uw Azure sleutelkluis bevat.
   Azure Key Vault	Selecteer een Azure sleutelkluis of selecteer Nieuw maken. Zorg ervoor dat uw sleutelkluis Azure op rollen gebaseerd toegangsbeheer heeft als machtigingsmodel. Als u deze instelling wilt controleren, selecteert u Geselecteerde kluis beheren>Instellingen>Toegangsconfiguratie. Zorg ervoor dat u uw gebruikersaccount permissies geeft voor beheer van geheimen met de rol .
   Door de gebruiker toegewezen beheerde identiteit voor geheimen	Selecteer een identiteit of selecteer Nieuwe maken.
   Gebruiker toegewezen beheerde identiteit voor Azure IoT-bewerkingen onderdelen	Selecteer een identiteit of selecteer Nieuwe maken. Gebruik niet dezelfde beheerde identiteit als de identiteit die u hebt geselecteerd voor geheimen.

   

3. Selecteer Volgende: Automatisering.

Opdrachten Azure CLI uitvoeren

De laatste stap in de Azure portalimplementatie is het uitvoeren van een set Azure CLI opdrachten om Azure IoT-bewerkingen in uw cluster te implementeren. De portal genereert deze opdrachten op basis van de informatie die u in de vorige stappen opgeeft.

Voer een voor één elke Azure CLI opdracht uit op het tabblad Automation in een terminal:

1. Meld u aan bij Azure CLI interactief met een browser, zelfs als u zich al eerder hebt aangemeld. Als u zich niet interactief aanmeldt, krijgt u mogelijk een foutmelding met de mededeling dat Apparaat moet worden beheerd voor toegang tot uw resource wanneer u doorgaat met de volgende stap om Azure IoT-bewerkingen te implementeren.

   az login
   

2. Installeer de meest recente Azure IoT-bewerkingen CLI-extensie.

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

3. Kopieer de opgegeven az iot ops schema registry create opdracht om een schemaregister te maken dat wordt gebruikt door Azure IoT-bewerkingen onderdelen. Als u ervoor kiest om een bestaand schemaregister te gebruiken, wordt deze opdracht niet weergegeven op het tabblad Automation .

   Notitie

   Voor deze opdracht is vereist dat u schrijfmachtigingen voor roltoewijzing hebt, omdat er een rol wordt toegewezen om het schemaregister toegang te geven tot het opslagaccount. De rol is standaard de ingebouwde rol Storage Blob Data Contributor, of u kunt een aangepaste rol maken met beperkte machtigingen om toe te wijzen. Zie az iot ops schema registry create voor meer informatie.

4. Als u het cluster wilt voorbereiden voor Azure IoT-bewerkingen implementatie, kopieert en voert u de opgegeven opdracht az iot ops init uit.

   Aanbeveling

   De init opdracht hoeft slechts eenmaal per cluster te worden uitgevoerd. Als je een cluster hergebruikt met al de nieuwste versie van Azure IoT-bewerkingen geïmplementeerd, kun je deze stap overslaan.

   Het uitvoeren van deze opdracht kan enkele minuten in beslag nemen. U kunt de voortgang van de implementatie volgen op het voortgangsdisplay in de terminal.

5. Implementeer Azure IoT-bewerkingen. Kopieer en voer de opgegeven opdracht az iot ops create uit . Het uitvoeren van deze opdracht kan enkele minuten in beslag nemen. U kunt de voortgang van de implementatie volgen op het voortgangsdisplay in de terminal.

   Als u de optionele vereisten voor het instellen van uw eigen certificeringsinstantieverlener hebt gevolgd, voegt u de --trust-settings parameters toe aan de create opdracht:

   --trust-settings configMapName=<CONFIGMAP_NAME> configMapKey=<CONFIGMAP_KEY_WITH_PUBLICKEY_VALUE> issuerKind=<CLUSTERISSUER_OR_ISSUER> issuerName=<ISSUER_NAME>
   

6. Schakel geheime synchronisatie in voor het geïmplementeerde Azure IoT-bewerkingen-exemplaar. Kopieer en voer de opgegeven opdracht az iot ops secretsync enable uit . Deze opdracht:

   • Hiermee maakt u een federatieve identiteitsreferentie met behulp van de door de gebruiker toegewezen beheerde identiteit.
   • Voegt een roltoewijzing toe aan de door de gebruiker toegewezen beheerde identiteit voor toegang tot de Azure Key Vault.
   • Hiermee voegt u een minimale geheime providerklasse toe die is gekoppeld aan het Azure IoT-bewerkingen-exemplaar.

7. Wijs een door de gebruiker toegewezen beheerde identiteit toe aan het geïmplementeerde Azure IoT-bewerkingen-exemplaar. Kopieer en voer de opgegeven opdracht az iot ops identity assign uit . Met deze opdracht maakt u een federatieve identiteitsreferentie met behulp van de OIDC-verlener van het aangegeven verbonden cluster en het Azure IoT-bewerkingen serviceaccount.

   Important

   Met de standaardversie van deze opdracht wordt een identiteit toegewezen voor gegevensstromen. Als u van plan bent om gegevensstroomgrafieken te gebruiken, neemt u de --usage parameter op met de waarde wasm-graph.

8. Start de pods van het schemaregister opnieuw om de nieuwe identiteit toe te passen.

   kubectl rollout restart statefulset adr-schema-registry -n azure-iot-operations
   

9. Zodra alle Azure CLI opdrachten zijn voltooid, kunt u de wizard Install Azure IoT-bewerkingen sluiten.

Zodra de opdracht create is voltooid, hebt u een werkend Azure IoT-bewerkingen exemplaar dat wordt uitgevoerd op uw cluster. Op dit moment is uw exemplaar geconfigureerd voor productiescenario's.

Implementatie verifiëren

Nadat de implementatie is voltooid, gebruikt u az iot ops check om de implementatie van de IoT Operations-service te evalueren op status, configuratie en bruikbaarheid. De check opdracht helpt u bij het vinden van problemen in uw implementatie en configuratie.

az iot ops check

Het check commando rapporteert de dataflowchecks als overgeslagen wanneer er nog geen dataflows zijn, wat normaal en verwacht is totdat je een dataflow aanmaakt. Zie Gegevens verwerken en routeren met gegevensstromen voor meer informatie.

Als u de configuraties van topictoewijzingen, QoS en berichtroutes wilt controleren, voegt u de parameter --detail-level 2 toe aan het check commando voor een gedetailleerde weergave.

Voer de volgende opdracht uit om alle versies van de Azure IoT-bewerkingen CLI-extensie weer te geven die beschikbaar zijn:

az iot ops get-versions

Volgende stappen

• Configureer waarneembaarheid voor het instellen van bewaking en dashboards.
• Schakel beveiligde instellingen in om geheimenbeheer en beheerde identiteiten in te stellen.
• Zie deze scripts in GitHub voor het automatiseren van een implementatie die gereed is voor productie met beveiligde instellingen.
• Zie Upgrade Azure IoT-bewerkingen om uw Azure IoT-bewerkingen-implementatie te upgraden naar een nieuwere versie.