Bereitstellungseinstellungen für den ALM Accelerator
Die ALM Accelerator-Exportpipeline wird verwendet die Nutzdaten der Bereitstellungseinstellungen, um die Bereitstellungspipelines für eine bestimmte Lösung und Umgebung anzupassen. Die Nutzdaten der Bereitstellungseinstellungen sind eine JSON-Zeichenfolge, die als Parameter an die Exportpipeline übergeben wird.
Die folgenden Tabellen beschreiben die Bereitstellungseinstellungen, die für jede Bereitstellungsumgebung in den Nutzdaten enthalten sind.
Bereitstellungspipeline-Einstellungen
| Einstellungen | Erforderlich | Beschreibung |
|---|---|---|
| ApprovalType | Nein | Der Typ der Genehmigung, der in der Bereitstellungspipeline verwendet werden soll |
| BuildName | Ja | Der Name der Buildpipeline |
| BuildTemplate | Nein | Der Name der Buildpipeline-Vorlage |
| DeploymentEnvironmentName | Ja | Der Name der Bereitstellungsumgebung |
| DeploymentEnvironmentUrl | Ja | Die URL der Bereitstellungsumgebung |
| EnvironmentUrl | Ja | Die URL der Entwicklungs- oder Erstellenumgebung |
| ServiceConnectionName | Ja | Der Name der Serviceverbindung zur Entwicklungs- oder Erstellenumgebung |
| StepType | Nein | Der Typ des Schritts, der in der Bereitstellungspipeline verwendet werden soll |
Benutzereinstellungen
| Einstellungen | Erforderlich | Beschreibung |
|---|---|---|
| environmentvariable.environment-variable-schema-name | Nein | Legt den Wert von Umgebungsvariablen in einer Umgebung während der Bereitstellung fest. |
| canvasshare.aadGroupId.canvas-app-schema-name | Nein | Legt die Microsoft Entra-Gruppen-ID für die Freigabe der Canvas-App fest. Wenn die Canvas-App für mehrere Microsoft Entra-Gruppen freigegeben werden soll, kann am Ende der Einstellung ein eindeutiger Bezeichner von „.1“ oder „.2“ hinzugefügt werden. |
| canvasshare.roleName.canvas-app-schema-name | Nein | Legt die Rolle fest, die der Microsoft Entra-Gruppe zugewiesen werden soll. Gültige Optionen sind CanView, CanViewAndShare und CanEdit. Wenn die Canvas-App für mehrere Microsoft Entra-Gruppen freigegeben werden soll, kann am Ende der Einstellung ein eindeutiger Bezeichner von „.1“ oder „.2“ hinzugefügt werden. |
| owner.ownerEmail.flow-name.flow-id | Nein | Legt die Besitzenden des Flows fest, die nach dem Import der Lösung in die Bereitstellungsumgebung zugewiesen werden. |
| flow.sharing.flow-name.flow-id | Nein | Legt das Dataverse Microsoft Entra-Gruppenteam für die Freigabe des nach dem Import der Lösung in die Bereitstellungsumgebung mit dem Flow verknüpften Prozessdatensatzes fest. |
| activateflow.activateas.flow-name.flow-id | Nein | Legt die Benutzenden fest, die beim Aktivieren des Flows die Identität wechseln sollen. Andernfalls wird der Benutzende der Verbindungserstellung oder der Besitzende verwendet, um den Flow zu aktivieren. |
| activateflow.order.flow-name.flow-id | Nein | Legt die Reihenfolge fest, in der der Flow aktiviert wird. Dies ist nützlich, wenn übergeordnete/untergeordnete Flows aktiviert werden. Wenn die Reihenfolge nicht festgelegt ist, versuchen die Pipelines, Flows zu aktivieren, solange Flows aktiviert werden müssen. |
| activateflow.activate.flow-name.flow-id | Nein | In bestimmten Fällen können Flows in einer Bereitstellungsumgebung absichtlich deaktiviert bleiben. Diese Einstellung löst die Pipelines aus, um den Flow bei der Bereitstellung zu aktivieren oder nicht zu aktivieren. |
| connector.teamname.connector-name.connector-id | Nein | Legt das Dataverse Microsoft Entra-Gruppenteam für die Freigabe des mit dem benutzerdefinierten Connector verknüpften Connectordatensatzes, nachdem die Lösung in die Bereitstellungsumgebung importiert wurde. |
| groupTeam.teamid.aadGroupId | Nein | Legt die Dataverse Gruppenteams fest, die in der Bereitstellungsumgebung erstellt werden sollen. |
| businessUnit.teamid.aadGroupId | Nein | Legt die Dataverse Unternehmenseinheit fest, die den Gruppenteams zugeordnet ist. |
| webhookurl.webookname | Nein | Legt die URL des Webhooks fest, der in der Bereitstellungsumgebung aktualisiert werden soll. |
| sdkstep.unsec.sdkstepid | Nein | Legt die ungesicherte Konfiguration des SDK-Schrittes fest, der in der Bereitstellungsumgebung aktualisiert werden soll. |
| sdkstep.sec.sdkstepid | Nein | Legt die gesicherte Konfiguration des SDK-Schrittes fest, der in der Bereitstellungsumgebung aktualisiert werden soll. |
| TriggerSolutionUpgrade | Nein | Legt fest, ob das Lösungsupgrade während der Bereitstellung in der Umgebung angewendet werden soll. |
UserSettings ist ein Array von Variablen, die in den Bereitstellungspipelines festgelegt werden. Wenn die Exportpipeline ausgeführt wird, werden die Bereitstellungseinstellungen und benutzerdefinierten Bereitstellungseinstellungsdateien mithilfe von Platzhaltern für diese Werte generiert. Wenn die Bereitstellungspipeline ausgeführt wird, werden die meisten Platzhalter durch die Werte aus den Nutzdaten der Bereitstellungseinstellungen ersetzt. Die einzige Ausnahme bilden bestimmte reservierte Pipelinevariablen wie TriggerSolutionUpgrade, die nicht in den Bereitstellungseinstellungen oder benutzerdefinierten Bereitstellungseinstellungen enthalten sind. Wenn „UseDeploymentSettingsPlaceholders“ außerdem auf „False“ festgelegt ist, werden die Platzhalter nicht verwendet. Stattdessen werden die Werte direkt in den Bereitstellungseinstellungen und benutzerdefinierten Bereitstellungseinstellungsdateien festgelegt.
Schema der Bereitstellungseinstellungen
Das Schema der Bereitstellungseinstellungen basiert auf den Komponenten, die nach der Bereitstellung in einer Dataverse Lösung konfiguriert werden müssen. Es wird aktualisiert, wenn dem ALM Accelerator neue Funktionen hinzugefügt werden. Das Schema wird in der Datei deployment-settings.schema.json definiert.
Beispielnutzdaten für Bereitstellungseinstellungen
Die Beispielnutzdaten sind ein Beispiel häufiger Nutzdaten für die ALM Accelerator-Pipelines. Die Beispielnutzdaten werden in der Datei deployment-settings.sample.json definiert.