Azure IoT Orchestrator Preview – manifesty

Důležité

Azure IoT Operations Preview – Služba Azure Arc je aktuálně ve verzi PREVIEW. Tento software ve verzi Preview byste neměli používat v produkčních prostředích.

Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.

Služba Azure IoT Orchestrator Preview rozšiřuje možnosti správy prostředků Azure mimo cloud. Prostřednictvím služby orchestrace můžou zákazníci definovat a spravovat svou hraniční infrastrukturu pomocí stejných souborů manifestu Arm, které dnes používají ke správě cloudových prostředků. Pro orchestraci existují dva hlavní typy prostředků: cíle a řešení. Tyto prostředky společně definují požadovaný stav hraničního prostředí.

Cíl

Cílem je konkrétní prostředí nasazení, jako je cluster Kubernetes nebo hraniční zařízení. Popisuje komponenty infrastruktury, které jsou součástí nainstalované jednou na zařízení, jako je PowerShell nebo Azure IoT Data Processor Preview. Každý cíl má vlastní nastavení konfigurace, které lze přizpůsobit tak, aby vyhovovalo konkrétním potřebám prostředí nasazení. Určuje také vazby zprostředkovatele, které definují, jaké typy prostředků se mají spravovat v cíli (například Helm, skripty PowerShellu, K8s, CRs nebo skripty Bash).

Pokud chcete vytvořit cílový prostředek pro cluster K8s s podporou Arc, přidejte json definice prostředku do šablony Azure Resource Manageru. Následující příklad vytvoří cílový prostředek, který definuje více komponent a vazeb.

{
  "type": "Microsoft.IoTOperationsOrchestrator/Targets",
  "name": "myTarget",
  "location": "eastus",
  "apiVersion": "2023-10-04-preview",
  "extendedLocation": { ... },
  "tags": {},
  "properties": {
    "version": "1.0.0",
    "scope": "myNamespace",
    "components": [
      {
        "name": "myHelmChart",
        "type": "helm.v3",
        "properties": {
          "chart": {
            "repo": "oci://azureiotoperations.azurecr.io/simple-chart",
            "version": "0.1.0"
          },
          "values": {}
        },
        "dependencies": []
      },
      {
        "name": "myCustomResource",
        "type": "yaml.k8s",
        "properties": {
          "resource": {
            "apiVersion": "v1",
            "kind": "ConfigMap",
            "data": {
                "key": "value"
            }
          }
        },
        "dependencies": ["myHelmChart"]
      }
    ],
    "topologies": [
      {
        "bindings": [
          {
            "role": "instance",
            "provider": "providers.target.k8s",
            "config": {
              "inCluster": "true"
            }
          },
          {
            "role": "helm.v3",
            "provider": "providers.target.helm",
            "config": {
              "inCluster": "true"
            }
          },
          {
            "role": "yaml.k8s",
            "provider": "providers.target.kubectl",
            "config": {
              "inCluster": "true"
            }
          }
        ]
      }
    ],
    "reconciliationPolicy": {
      "type": "periodic",
      "interval": "20m"
    }
  }
}

Cílové parametry

Parametr	Popis
type	Typ prostředku: Microsoft.IoTOperationsOrchestrator/Targets.
name	Název cílového prostředku
location	Název oblasti, ve které se vytvoří cílový prostředek.
apiVersion	Verze rozhraní API prostředků: 2023-10-04-preview
extendedLocation	Abstrakce oboru názvů, který se nachází v clusteru s podporou ARC. Pokud chcete vytvořit jakékoli prostředky v clusteru s podporou ARC, musíte nejprve vytvořit vlastní umístění.
značky	Volitelné značky prostředků
vlastnosti	Seznam vlastností cílového prostředku Další informace naleznete v následující tabulce parametrů vlastností.

Parametry cílových vlastností

Parametr Vlastnosti	Popis
version	Volitelné pole metadat pro sledování cílových verzí
rozsah	Obor názvů clusteru
Součásti	Seznam komponent použitých během nasazení a jejich podrobností Další informace najdete v tématu Poskytovatelé a komponenty.
Topologie	Seznam vazeb, které propojují skupinu zařízení nebo cílů s rolí Další informace najdete v následující tabulce parametrů topologies.bindings.
reconciliationPolicy	Interval pro četnost kontroly aktualizovaného požadovaného stavu správce prostředků nástroje Orchestrator. Minimální období je jedna minuta.

Parametry target topologies.bindings

Parametr topologií cíle obsahuje objekt vazeb , který poskytuje podrobnosti o připojení k různým cílům. Následující tabulka popisuje parametry vazeb objektu:

Properties.topologies.bindings – parametr	Popis
role	Role cíle, který se připojuje. Stejná entita jako cíl nebo zařízení může v různých kontextech předpokládat různé role, což znamená, že pro různé účely lze definovat více vazeb. Cíl může například použít chart Helm pro nasazení datové části a ADU pro aktualizace zařízení. V takových případech se vytvoří dvě vazby: jedna pro roli nasazení a jedna pro roli aktualizace s odpovídajícími konfiguracemi zprostředkovatele.
Zprostředkovatel	Název zprostředkovatele, který zpracovává konkrétní připojení.
config	Podrobnosti o konfiguraci použité k vytvoření připojení ke konkrétnímu cíli Konfigurace se liší v závislosti na typu poskytovatele. Další informace najdete v tématu Poskytovatelé a komponenty.

Řešení

Řešení je šablona, která definuje úlohu aplikace, kterou je možné nasadit na jeden nebo více cílů. Řešení tedy popisuje komponenty aplikace (například věci, které používají komponenty infrastruktury definované v cíli, jako jsou skripty PowerShellu nebo kanály zpracovatele dat Azure IoT).

Pokud chcete vytvořit prostředek řešení, přidejte do šablony Azure Resource Manageru json definice prostředku. Následující příklad vytvoří prostředek řešení, který definuje dvě komponenty, z nichž jedna je závislá na druhé.

{
  "type": "Microsoft.IoTOperationsOrchestrator/Solutions",
  "name": "mySolution",
  "location": "eastus",
  "apiVersion": "2023-10-04-preview",
  "extendedLocation": { ... },
  "tags": {},
  "properties": {
    "version": "1.0.0",
    "components": [
      {
        "name": "myHelmChart",
        "type": "helm.v3",
        "properties": {
          "chart": {
            "repo": "oci://azureiotoperations.azurecr.io/simple-chart",
            "version": "0.1.0"
          },
          "values": {}
        },
        "dependencies": []
      },
      {
        "name": "myCustomResource",
        "type": "yaml.k8s",
        "properties": {
          "resource": {
            "apiVersion": "v1",
            "kind": "ConfigMap",
            "data": {
                "key": "value"
            }
          }
        },
        "dependencies": ["myHelmChart"]
      }
    ]
  }
}

Parametry řešení

Parametr	Popis
type	Typ prostředku: Microsoft.IoTOperationsOrchestrator/Solutions.
name	Název prostředku řešení
location	Název oblasti, ve které se prostředek řešení vytvoří.
apiVersion	Verze rozhraní API prostředků: 2023-10-04-preview
extendedLocation	Abstrakce oboru názvů, který se nachází v clusteru s podporou ARC. Pokud chcete vytvořit jakékoli prostředky v clusteru s podporou ARC, musíte nejprve vytvořit vlastní umístění.
značky	Volitelné značky prostředků
vlastnosti	Seznam vlastností prostředku řešení Další informace naleznete v následující tabulce parametrů vlastností.

Parametry vlastností řešení

Parametr Vlastnosti	Popis
version	Volitelné pole metadat pro sledování verzí řešení
Součásti	Seznam komponent vytvořených v nasazení a jejich podrobnosti Další informace najdete v tématu Poskytovatelé a komponenty.

Instance

Instance je konkrétní nasazení řešení do cíle. Je možné si ho představit jako instanci řešení.

Pokud chcete vytvořit prostředek instance, přidejte json definice prostředku do šablony Azure Resource Manageru. Následující příklad ukazuje instanci, která nasadí řešení s názvem *mySolution v cílovém clusteru s názvem myTarget:

{
  "type": "Microsoft.IoTOperationsOrchestrator/Instances",
  "name": "myInstance",
  "location": "eastus",
  "apiVersion": "2023-10-04-preview",
  "extendedLocation": { ... },
  "tags": {},
  "properties": {
    "version": "1.0.0",
    "scope": "myNamespace",
    "solution": "mySolution",
    "target": {
      "name": "myTarget"
    },
    "reconciliationPolicy": {
      "type": "periodic",
      "interval": "1h"
    }
  }
}

Parametry instance

Parametr	Popis
type	Typ prostředku: Microsoft.IoTOperationsOrchestrator/Instances.
name	Název prostředku instance
location	Název oblasti, ve které se vytvoří prostředek instance.
apiVersion	Verze rozhraní API prostředků: 2023-10-04-preview
extendedLocation	Abstrakce oboru názvů, který se nachází v clusteru s podporou ARC. Pokud chcete vytvořit jakékoli prostředky v clusteru s podporou ARC, musíte nejprve vytvořit vlastní umístění.
značky	Volitelné značky prostředků
vlastnosti	Seznam vlastností prostředku instance Další informace naleznete v následující tabulce parametrů vlastností.

Parametry vlastností instance

Parametr Vlastnosti	Popis
version	Volitelné pole metadat pro sledování verzí instancí
rozsah	Obor názvů clusteru
solution	Název řešení použitého k nasazení
target	Název cíle nebo cílů, na kterých se řešení nasadí.
reconciliationPolicy	Interval pro četnost kontroly aktualizovaného požadovaného stavu správce prostředků nástroje Orchestrator. Minimální období je jedna minuta.

Komponenty

Komponenty jsou všechny prostředky, které může orchestrátor spravovat. Komponenty se odkazují jak v manifestech řešení, tak v cílových manifestech. Pokud se komponenta znovu používá v řešení, například jako součást kanálu, měli byste ji zahrnout do manifestu řešení. Pokud se komponenta nasazuje jednou jako součást nastavení prostředí, měli byste ji zahrnout do cílového manifestu.

Parametr	Description
name	Název komponenty.
type	Typ komponenty. Například helm.v3 nebo yaml.k8s.
vlastnosti	Podrobnosti o spravované komponentě
závislosti	Seznam všech komponent, na kterých je tato aktuální komponenta závislá.

Vlastnosti dané komponenty závisí na typu komponenty, který se spravuje. Další informace o různých typech komponent najdete v tématu Poskytovatelé a komponenty.