Erstellen von Standardlogik-App-Workflows für die Hybridbereitstellung in Ihrer eigenen Infrastruktur (Vorschau)

Gilt für: Azure Logic Apps (Standard)

Für Szenarien, in denen Sie Ihre eigene Infrastruktur verwenden, steuern und verwalten müssen, können Sie Standardlogik-App-Workflows mithilfe des Hybridbereitstellungsmodells in Azure Logic Apps erstellen. Dieses Modell bietet Funktionen zum Erstellen und Hosten von Integrationslösungen für teilweise verbundene Umgebungen, die lokale Verarbeitung, Speicher und Netzwerkzugriff erfordern. Ihre Infrastruktur kann lokale Systeme, private Clouds und öffentliche Clouds umfassen. Mit dem Hybridmodell wird Ihr Workflow der Standardlogik-App von der Azure Logic Apps-Runtime unterstützt, die lokal als Teil einer Azure Container Apps-Erweiterung gehostet wird.

Eine Architekturübersicht, die zeigt, wo Workflows der Standardlogik-App in einer teilweise verbundenen Umgebung gehostet und ausgeführt werden, finden Sie unter Einrichten von Infrastrukturanforderungen für die Hybridbereitstellung für Standardlogik-Apps.

In diesem Anleitungshandbuch wird gezeigt, wie Sie einen Workflow der Standardlogik-App mithilfe des Hybridbereitstellungsmodells erstellen und bereitstellen, nachdem Sie die erforderlichen lokalen Ressourcen zum Hosten Ihrer App eingerichtet haben.

Begrenzungen

• Hybridbereitstellung für Standardlogik-Apps ist verfügbar und wird nur in denselben Regionen wie Azure Container Apps auf Azure Arc-fähigen AKS unterstützt.

• Die folgenden Funktionen sind derzeit in dieser Vorschauversion nicht verfügbar:

  • Authentifizierung der verwalteten Identität
  • SAP-Zugriff über den integrierten SAP-Connector
  • Benutzerdefinierter C#-Code mit .NET Framework und der integrierten Aktion namens Lokale Funktion in dieser Logik-App aufrufen
  • XSLT 1.0 für benutzerdefinierten Code

  Azure Arc-fähige Kubernetes-Cluster unterstützen derzeit keine verwaltete Identitätsauthentifizierung für verwaltete API-Verbindungen. Stattdessen müssen Sie ihre eigene App-Registrierung mithilfe von Microsoft Entra ID erstellen. Um weitere Informationen zu erhalten befolgen Sie die Schritte weiter unten in diesem Leitfaden.

• Einige funktionsbasierte Trigger, z. B. Azure Blob, Cosmos DB und Event Hubs, erfordern eine Verbindung mit dem Azure-Speicherkonto, das Ihrer Standardlogik-App zugeordnet ist. Wenn Sie funktionsbasierte Trigger verwenden, fügen Sie in den Umgebungsvariablen Ihrer Standardlogik-App im Azure-Portal oder in der local.settings.json-Datei Ihres Logik-App-Projekts in Visual Studio Code die folgende App-Einstellung hinzu und stellen Sie die Verbindungszeichenfolge für Ihr Speicherkonto bereit:

  "Values": {
    "name": "AzureWebJobsStorage",
    "value": "{storage-account-connection-string}"
  }
  

Voraussetzungen

• Ein Azure-Konto und ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Die folgenden lokalen Ressourcen, die alle innerhalb desselben Netzwerks für die erforderliche Konnektivität vorhanden sein müssen:

  • Ein Azure Kubernetes Service-Cluster, das mit Azure Arc verbunden ist
  • Eine SQL-Datenbank zum lokalen Speichern des Workflowausführungsverlaufs, der Eingaben und der Ausgaben für die Verarbeitung
  • Eine SMB-Dateifreigabe (Server Message Block) zum lokalen Speichern von Artefakten, die von Ihren Workflows verwendet werden

  Um diese Anforderungen zu erfüllen, richten Sie diese lokalen Ressourcen ein, um die Hybridbereitstellung für Standardlogik-Apps zu unterstützen.

• Um in Visual Studio Code zu arbeiten, benötigen Sie die Azure Logic Apps (Standard)-Erweiterung für Visual Studio Code mit den entsprechenden Voraussetzungen.

  Tipp

  Wenn Sie über eine neue Visual Studio Code-Installation verfügen, vergewissern Sie sich, dass Sie einen einfachen Standardworkflow lokal ausführen können, bevor Sie versuchen, die Bereitstellung in Ihrer eigenen Infrastruktur durchzuführen. Diese Testausführung hilft beim Isolieren von Fehlern, die möglicherweise in Ihrem Standardworkflowprojekt vorhanden sind.

Erstellen ihrer Standardlogik-App

Ändern der CPU- und Speicherzuweisung im Azure-Portal

Führen Sie die folgenden Schritte aus, um die CPU- und Speichereinstellungen für Ihre Standardlogik-App-Ressource zu bearbeiten:

1. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

2. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Container aus.

3. Wählen Sie auf der Symbolleiste der Seite Container Bearbeiten und Bereitstellenaus, wodurch der Bereich Einen Container bearbeiten geöffnet wird.

4. Ändern Sie auf der Registerkarte Eigenschaften unter Containerressourcenzuordnung die folgenden Werte entsprechend Ihrem Szenario:

   Eigenschaft	Wert	Beschreibung
   CPU-Kerne	- Standard: 1 - Minimum: 0,25 - Maximum: 2	Bestimmt die CPU-Kerne, die Ihrer Containerinstanz zugewiesen werden sollen. Sie können diesen Wert um 0,25 Kerne bis zum Maximalwert erhöhen. Die Gesamtanzahl aller Containerinstanzen für diese Logik-App ist auf 2 Kerne beschränkt.
   Memory	- Standard: 2 - Minimum: 0,1 - Maximum: 4	Bestimmt die Arbeitsspeicherkapazität in Gibibytes (Gi), die Ihrer Containerinstanz zugewiesen werden soll. Sie können diesen Wert um 0,1 Gi auf den Maximalwert erhöhen. Die Gesamtkapazität für alle Containerinstanzen für diese Logik-App ist auf 4 Gi beschränkt.

5. Wählen Sie abschließend Speichern aus.

Ändern der Replikatskalierung im Azure-Portal

Sie können die automatische Skalierung für den Replikatbereich steuern, der als Reaktion auf ein Triggerereignis bereitgestellt wird. Ein Replikat ist eine neue Instanz einer Logik-App-Ressourcenrevision oder -version. Um die Minimum- und Maximumwerte für diesen Bereich zu ändern, können Sie die Skalierungsregeln ändern, um die Ereignistypen zu bestimmen, welche die Skalierung auslösen. Weitere Informationen finden Sie unter Festlegen von Skalierungsregeln in Azure Container Apps.

1. Öffnen Sie im Azure-Portal Ihre Ressource vom Typ „Logic App (Standard)“.

2. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Skalieren aus.

3. Ändern Sie auf der Seite Skalieren unter der Einstellung „Skalierungsregel“ die folgenden Werte so, dass sie ihrem Szenario entsprechen:

   Eigenschaft	Wert	Beschreibung
   Mindestanzahl Replikate	- Standard: 1 - Minimum: 0 - Maximum: 1000	Bestimmt die Mindestanzahl der Replikate, die für die Revision zu einem bestimmten Zeitpunkt zulässig sind. Dieser Wert setzt Skalierungsregeln außer Kraft und muss kleiner als die maximale Anzahl von Replikaten sein.
   Maximale Anzahl Replikate	- Standard: 30 - Minimum: 0 - Maximum: 1000	Bestimmt die maximale Anzahl von Replikaten, die für die Revision zu einem bestimmten Zeitpunkt zulässig sind. Dieser Wert setzt Skalierungsregeln außer Kraft.

4. Wählen Sie abschließend Speichern aus.

Steuern des eingehenden Datenverkehrs an Ihre Logik-App im Azure-Portal

Sie können Ihre Logik-App für das öffentliche Web, Ihr virtuelles Netzwerk und andere Logik-Apps in Ihrer Umgebung verfügbar machen, indem Sie den Eingang aktivieren. Azure erzwingt Eingangseinstellungen über eine Reihe von Regeln, die das Routing von externem und internem Datenverkehr an Ihre Logik-App steuern. Wenn Sie den Eingang aktivieren, müssen Sie keinen Azure Load Balancer, öffentliche IP-Adresse oder andere Azure-Ressourcen erstellen, um eingehende HTTP-Anforderungen oder TCP-Datenverkehr zu aktivieren. Weitere Informationen finden Sie unter Eingang in Container Apps.

1. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Eingang aus.

2. Wählen Sie auf der Seite Eingang neben Eingang das Feld Aktiviert aus.

3. Konfigurieren Sie basierend auf Ihrem Szenario die verbleibenden Optionen.

   Weitere Informationen finden Sie in der folgenden Dokumentation:

   • Konfigurieren des eingehenden Datenverkehrs für Ihre App in Azure Container Apps
   • Einrichten von IP-Eingangsbeschränkungen in Azure Container Apps

Einrichten der Authentifizierung für verwaltete API-Verbindungen

Um verwaltete API-Verbindungen in Workflows der Standardlogik-App zu authentifizieren, die in Azure Arc-fähigen Kubernetes-Clustern gehostet werden, müssen Sie ihre eigene App-Registrierung mit Microsoft Entra ID erstellen. Sie können dann die Werte dieser App-Registrierung als Umgebungsvariablen in Ihrer Standardlogik-App-Ressource hinzufügen, um stattdessen Ihre API-Verbindungen zu authentifizieren.

Erstellen einer App-Registrierung bei Microsoft Entra ID

Azure-Portal

1. Folgen Sie im Azure-Portal der Schnellstartanleitung: Registrieren Sie eine Anwendung bei der Microsoft Identity Platform, um eine App-Registrierung zu erstellen.

2. Suchen Sie nach Abschluss der Erstellung Ihre neue App-Registrierung im Portal.

3. Wählen Sie im Ressourcenmenü Übersicht aus und speichern Sie die folgenden Werte, die Sie später für die Verbindungsauthentifizierung benötigen:

   • Client-ID
   • Mandanten-ID
   • Geheimer Clientschlüssel

4. Führen Sie für die Objekt-ID die folgenden Schritte aus:

   1. Wählen Sie auf der Seite Übersicht den Link Verwaltete Anwendung im lokalen Verzeichnis für Ihre App-Registrierung aus:

      

   2. Kopieren Sie auf der daraufhin geöffneten Seite den Wert der Objekt-ID:

      

5. Fügen Sie nun die gespeicherten Werte als Umgebungsvariablen zu Ihrer Standardlogik-App-Ressource hinzu.

Azure CLI

1. Verwenden Sie zum Erstellen der App-Registrierung den Befehl az ad sp create.

2. Um alle Eigenschaften zu überprüfen, verwenden Sie den Befehl az ad sp show.

3. Suchen und speichern Sie in der Ausgabe beider Befehle die folgenden Werte, die Sie später für die Verbindungsauthentifizierung benötigen:

   • Client-ID
   • ObjectID
   • Mandanten-ID
   • Geheimer Clientschlüssel

4. Fügen Sie nun die gespeicherten Werte als Umgebungsvariablen zu Ihrer Standardlogik-App-Ressource hinzu.

Hinzufügen von App-Registrierungswerten zur Standardlogik-App

1. Gehen Sie im Azure-Portal zu Ihrer Standard-Logik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter Einstellungen Container aus und wählen Sie dann die Registerkarte Umgebungsvariablen aus.

   Weitere Informationen zu App-Einstellungen und Hosteinstellungen finden Sie unter Bearbeiten von App-Einstellungen und Hosteinstellungen.

3. Wählen Sie auf der Symbolleiste Bearbeiten und bereitstellen aus.

4. Wählen Sie im Bereich Container bearbeiten Umgebungsvariablen und dann Hinzufügen aus.

5. Fügen Sie in der folgenden Tabelle jede Umgebungsvariable mit dem angegebenen Wert hinzu:

   Umgebungsvariable	Wert
   WORKFLOWAPP_AAD_CLIENTID	<my-client-ID>
   WORKFLOWAPP_AAD_OBJECTID	<my-object-ID>
   WORKFLOWAPP_AAD_TENANTID	<my-tenant-ID>
   WORKFLOWAPP_AAD_CLIENTSECRET	<my-client-secret>

6. Wählen Sie abschließend Speichern aus.

Speichern und Verweisen auf Client-ID und geheimen Clientschlüssel

Sie können die Werte der Client-ID und des geheimen Clientschlüssels in Ihrer Logik-App-Ressource als geheime Schlüssel speichern und dann stattdessen auf der Registerkarte Umgebungsvariablen auf diese Werte verweisen.

1. Navigieren Sie im Azure-Portal zu Ihrer Logik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Geheime Schlüssel aus.

3. Wählen Sie in der Symbolleiste Hinzufügen aus.

4. Geben Sie im Bereich Geheimen Schlüssel hinzufügen die folgenden Informationen für jeden geheimen Schlüssel an und wählen Sie dann Hinzufügen aus:

   Schlüssel	Wert
   WORKFLOWAPP_AAD_CLIENTID	<my-client-ID>
   WORKFLOWAPP_AAD_CLIENTSECRET	<my-client-secret>

Bekannte Probleme und Problembehandlung

Azure-Portal

• Ihre Standardlogik-App wird bereitgestellt und als Azure Container Apps-Ressourceangezeigt, aber als Typ wird Logic App (Hybrid) angezeigt.

• Azure enthält Ihre Standardlogik-App in der Ressourcenliste Container Apps und nicht in der Ressourcenliste Logik-Apps.

• Ihre verbundene Azure Container Apps-Umgebung listet Ihre Standardlogik-App mit einem App-Typ namens Hybrid Logic-App auf.

• Um Änderungen im Designer nach dem Speichern des Workflows widerzuspiegeln, müssen Sie möglicherweise gelegentlich den Designer aktualisieren.

Arc-fähige Kubernetes-Cluster

In seltenen Szenarien bemerken Sie möglicherweise einen hohen Speicherbedarf in Ihrem Cluster. Um dieses Problem zu verhindern, skalieren Sie entweder hoch oder fügen Sie die automatische Skalierung für Knotenpools hinzu.

Funktionshost wird nicht ausgeführt

Vergewissern Sie sich nach der Bereitstellung der Standardlogik-App, dass Ihre App ordnungsgemäß ausgeführt wird.

1. Wechseln Sie im Azure-Portal zur Container App Ressource für Ihre Logik-App.

2. Wählen Sie im Ressourcenmenü Übersicht aus.

3. Wählen Sie auf der Seite Übersicht neben dem Feld Anwendungs-URL die Ressourcen-URL aus.

   Wenn Ihre App ordnungsgemäß ausgeführt wird, wird ein Browserfenster geöffnet und zeigt die folgende Meldung an:

   

   Andernfalls, wenn ihre App Fehler aufweist, überprüfen Sie, ob Ihre AKS-Pods ordnungsgemäß ausgeführt werden. Führen Sie in Windows PowerShell die folgenden Befehle aus:

   az aks get-credentials {resource-group-name} --name {aks-cluster-name} --admin
   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

   Weitere Informationen finden Sie in der folgenden Dokumentation:

   • az aks get-credentials
   • Befehlszeilentool (kubetctl)

Cluster verfügt nicht über genügend Knoten

Wenn Sie den vorherigen Befehl ausgeführt haben und eine Warnung erhalten, die dem folgenden Beispiel ähnelt, verfügt Ihr Cluster nicht über genügend Knoten für die Verarbeitung:

Warning: FailedScheduling  4m52s (x29 over 46m)  default-scheduler  0/2 nodes are available: 2 Too many pods. preemption: 0/2 nodes are available: 2 No preemption victims found for incoming pod.

Führen Sie die folgenden Schritte aus, um die Anzahl der Knoten zu erhöhen und die automatische Skalierung einzurichten:

1. Wechseln Sie im Azure-Portal zu Ihrer Kubernetes-Dienstinstanz.

2. Wählen Sie im Instanzmenü unter Einstellungen die Option Knotenpools aus.

3. Wählen Sie auf der Symbolleiste der Seite Knotentools + Knotenpool hinzufügen aus.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Erstellen von Knotenpools für einen Cluster in Azure Kubernetes Service (AKS)
• Verwalten von Knotenpools für einen Cluster in Azure Kubernetes Service (AKS)
• Übersicht über die automatische Clusterskalierung in Azure Kubernetes Service (AKS)
• Verwenden der Autoskalierung für Cluster in Azure Kubernetes Service (AKS)

SMB Container Storage Interface (CSI)-Treiber nicht installiert

Nachdem Sie den vorherigen kubectl describe pod-Befehl ausgeführt haben, vergewissern Sie sich, ob der CSI-Treiber für Ihre SMB-Dateifreigabe ordnungsgemäß installiert ist, wenn die folgende Warnung angezeigt wird:

Warning FailedScheduling 5m16s (x2 over 5m27s)  default-scheduler 0/14 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/14 nodes are available: 14 Preemption is not helpful for scheduling.

Normal NotTriggerScaleUp 9m49s (x31 over 14m) cluster-autoscaler pod didn't trigger scale-up: 3 pod has unbound immediate PersistentVolumeClaims

Führen Sie zum Bestätigen über Windows PowerShell die folgenden Befehle aus:

kubectl get csidrivers

Wenn die angezeigte Ergebnisliste nicht smb.csi.k8s.io enthält, führen Sie in einer Windows-Eingabeaufforderung den folgenden Befehl aus:

helm repo add csi-driver-smb
help repo update helm install csi-driver-smb csi-driver-smb/csi-driver-smb --namespace kube-system --version v1.15.0

Um den Status des CSI-SMB-Treiber-Pods zu überprüfen, führen Sie in der Windows-Eingabeaufforderung den folgenden Befehl aus:

kubectl --namespace=kube-system get pods --selector="app.kubernetes.io/name=csi-driver-smb" --watch

Weitere Informationen finden Sie unter CSI-Treiber (Container Storage Interface) auf Azure Kubernetes Service (AKS).

Zugehöriger Inhalt

• Einrichten von Anforderungen für die Bereitstellung von Standardlogik-Apps in Ihrer eigenen Infrastruktur