- Einleitung
- Verwalten von Lösungsprojekten und -paketen
- Verwalten von Lösungsbereitstellungen
- Best Practices
Das Bereitstellen einer Lösung bedeutet, dass ein Lösungspaket als neue Bereitstellung in einem Orchestrator-Ordner installiert wird. Weitere Informationen zu Lösungsbereitstellungen finden Sie unter Grundlegendes zum Lebenszyklus der Lösungsentwicklung.
Sie können eine Lösungsbereitstellung entweder über Studio Web oder über Orchestrator initiieren. Beide Oberflächen unterstützen dieselbe Bereitstellungserfahrung: Studio Web ist die Ursprungsoberfläche, die für Lösungsautoren entwickelt wurde, die in einem einzigen Flow paketieren und bereitstellen möchten; Orchestrator ist die administrative Oberfläche, die für Mandantenadministratoren entwickelt wurde, die Bereitstellungen in großem Umfang verwalten. Auf dieser Seite wird der Ablauf des Orchestrators dokumentiert.
Der Bereitstellungsablauf in Orchestrator erfordert ein Lösungspaket, das bereits in einem Feed veröffentlicht wurde. Sie können ein Paket aus Studio Web oder Studio Desktop veröffentlichen, bevor Sie es hier bereitstellen.
Dieser Schritt wird in der Regel von einem Administrator ausgeführt.
Öffnen Sie den Workflow Bereitstellen
Sie können den Workflow Bereitstellung über einen der folgenden Speicherorte im Orchestrator öffnen:
- Deployments tab: Select Deploy in the upper-right corner.
- Packages tab: Select the Deploy row action for the package you want to deploy.
- Package sidebar: Open a package to expand its sidebar, then select Deploy in the upper-right corner of the sidebar.
- Versions tab of the Package sidebar: Select the Deploy row action for the specific package version you want to deploy.
Alle vier Pfade öffnen denselben Bereitstellungs- Workflow im Setup -Formular. Der Breadcrumb oben lautet Tenant > Solutions > Deployments > Deploy.
Füllen Sie das Setup-Formular aus
The Setup form is where you define what to deploy, where it lands, and how it activates. Complete the following fields, then select Deploy. The Package and Version fields are always visible; the remaining fields are grouped under the Options control, which you can expand or collapse. When collapsed, Options shows a summary of the current values (for example, the destination folder, whether triggers are enabled right away, and whether a runtime is set up).
| Feld | Beschreibung |
|---|---|
| Paket | Select the solution package to deploy from the dropdown. The list shows all packages published to your tenant feed. After you select a package, its description appears beneath the field. |
| Version | The package version to install. Appears after you select a package. Defaults to the latest published version. The publish date and release notes for the selected version appear beneath the field. Select a different version from the dropdown if needed. |
| Optionen | Expands or collapses the deployment settings that follow. When collapsed, it shows a summary of the selected values. |
| Name der Bereitstellung | A required, tenant-unique name for this deployment. Auto-filled from the package name. Edit to use a different name. The name is validated as you type: if a deployment with the same name already exists, the form shows an error and you cannot continue until the name is unique. |
| Ort | Der Ordner, in dem der Lösungsordner erstellt wird. Standardmäßig freigegeben. Wählen Sie einen anderen Ordner aus der Dropdownliste aus, um das Ziel zu ändern. |
| Name des Lösungsordners | The name of the subfolder created inside the destination folder. Auto-filled to match the deployment name until you edit it. Edit to customize it for this deployment. |
| Sofort aktivieren | Umschalten (standardmäßig aktiviert). Wenn diese Option aktiviert ist, werden Trigger sofort aktiviert, sofern vorhanden. |
| Runtime einrichten | Umschalten (standardmäßig aktiviert). Wenn diese Option aktiviert ist, wird eine serverlose Runtime bereitgestellt, wenn keine Standardausführungsmaschine auf Mandantenebene konfiguriert ist. |
Führen Sie die Bereitstellung aus
Nachdem Sie das Formular Setup ausgefüllt haben, wählen Sie eine der folgenden Optionen am unteren Rand des Formulars aus:
-
Deploy: validates the configuration and runs the deployment immediately. The workflow progresses through the following steps shown in the What will happen panel on the left:
Schritt Beschreibung Konfigurieren Validiert und richtet die Bereitstellung ein. Bereitstellen Richtet Ordner ein und stellt Ressourcen bereit. Aktivieren (Activate) Aktiviert Trigger und validiert die Bereitstellung, wenn Sofort aktivieren aktiviert ist. -
Customize (select the dropdown arrow on the Deploy button): opens the resource explorer so you can review and configure individual solution components before the deployment runs. In the resource explorer, you can:
- Filter the properties shown for a component using the Display control (All properties, Empty properties, Required properties, or Configurable properties).
- Link a component to an existing resource using Link to existing.
- Revert your changes to a component using Reset.
- Review the Issues counter (errors, warnings, and information) and the Logs panel.
When you finish, select one of the following:
- Continue to proceed with the deployment.
- Validate to check the configuration without deploying.
- Save as draft to save and resume later.
- Delete draft to discard the deployment.
Save a deployment as a draft
If you are not ready to run a deployment, you can save your progress and finish it later:
- Select Customize from the Deploy button dropdown to open the resource explorer.
- Configure components as needed.
- Select Save as draft.
The draft appears in the Deployments tab with a Draft status chip. To resume it, select the draft row, then select Continue editing. To discard it, select Delete draft.
Vorhandene Komponenten wiederverwenden (optional)
When the deployment is located outside your Personal Workspace (for example, in a shared folder), the candidate list excludes resources stored in your Personal Workspace at any folder depth, including nested subfolders. This prevents broken deployment configurations that your collaborators cannot run or maintain because they cannot access your Personal Workspace resources.
If the deployment is inside your Personal Workspace, all your accessible resources, including your Personal Workspace resources, are available for linking.
Wenn Sie Anpassen auswählen, zeigt der Ressourcen-Explorer alle Komponenten im Lösungspaket an. Wenn bereits eine Komponente mit demselben Namen im Mandanten vorhanden ist, können Sie die Lösung damit verknüpfen, anstatt eine neue zu erstellen.
Diese Option steht für Assets, Speicher-Buckets, Webhooks und Warteschlangen zur Verfügung. Für jeden Konflikt können Sie:
- Die vorhandene Komponente beibehalten und keine zusätzliche erstellen.
- Behalten Sie die vorhandene Komponente bei und fügen Sie neue Felder aus der Lösung hinzu (vorhandene Felder werden nicht geändert).
- Benennen Sie die in Konflikt stehende Ressource im jeweiligen Dienst um.
- Benennen Sie die Ressource in der Lösungsbereitstellung nach Möglichkeit um.
So verknüpfen Sie eine vorhandene Komponente:
-
Wählen Sie im Ressourcen-Explorer die Komponente aus, die Sie verknüpfen möchten.
-
Wählen Sie Mit vorhandenen verknüpfen.
-
Wählen Sie im Dialogfeld Mit vorhandenem Prozess verknüpfen die Komponente aus, die Sie verknüpfen möchten.
-
Wählen Sie Link aus.
- When a resource is linked, it is not created as part of the deployment; the solution uses the linked resource directly. Linking a resource with a different name may lead to runtime errors unless the solution was developed to support this configuration.
- When you link a resource that exists in another folder, the solution stores the runtime dependency against the solution folder where the resource is copied, not the original source folder. Users with permissions on the solution folder can run the process without needing permissions on the original resource location.
Überwachen Sie den Bereitstellungsstatus
Nachdem die Bereitstellung gestartet wurde, können Sie den Fortschritt über die Workflowansicht oder über die Registerkarte Bereitstellungen in Lösungen überwachen. Folgende Stati sind möglich:
| Status | Beschreibung |
|---|---|
| In Bearbeitung | Der Bereitstellungsvorgang wird ausgeführt. |
| Erfolgreich | Die Bereitstellung ist abgeschlossen und alle Komponenten sind installiert. |
| Fehlgeschlagen (Failed) | Die Bereitstellung ist fehlgeschlagen, und es wurde ein automatisches Rollback durchgeführt. |
| Rollback fehlgeschlagen | Die Bereitstellung ist fehlgeschlagen und einige Komponenten müssen manuell bereinigt werden. |
Weitere Informationen zu allen Status finden Sie unter Bereitstellungsstatus.
Aktivieren Sie die Bereitstellung
Wenn die Lösung Apps enthält und diese nicht mit dem angegebenen Link aktiviert werden, schlägt die Aktivierung der Bereitstellung fehl. Ausführliche Anweisungen finden Sie in der Orchestrator- und Apps -Dokumentation.
Nach einer erfolgreichen Bereitstellung bewertet der Orchestrator die Aktivierungsbereitschaft. Die Bereitstellung wird auf der Registerkarte Bereitstellungen mit einem der folgenden Status angezeigt:
-
Inaktiv (Bereit zur Aktivierung): Es ist keine zusätzliche Konfiguration erforderlich. Wählen Sie das Symbol Weitere Aktionen und dann Bereitstellung aktivieren aus.
-
Inaktiv (erfordert Setup zum Aktivieren): Vor der Aktivierung müssen zusätzliche Voraussetzungen erfüllt sein:
-
Wählen Sie das Symbol Weitere Aktionen und dann Aktivierung einrichten aus.
-
Überprüfen Sie die Ergebnisse der Aktivierungsvalidierung und schließen Sie die erforderlichen Elemente ab:
- Fügen Sie Konten hinzu und weisen Sie Rollen zu.
- Fügen Sie Maschinen zu Lösungsordnern hinzu.
- Definieren Sie bei Bedarf Konto-Maschinen-Zuordnungen.
- Definieren Sie ggf. Asset-Werte pro Roboter.
- Aktivieren Sie die in der Lösung verwendeten Apps.
- Füllen Sie ggf. Bindungen für Prozesskomponenten aus.
Hinweis:When deploying a solution, a Default Serverless template may be automatically attached to the target folder if the Set up runtime toggle was enabled on the Setup form. This ensures the solution can run without manually configuring machine templates. If a serverless template is already inherited, no additional template is attached.
-
Lösen Sie die aufgeführten Elemente.
-
Wählen Sie Validieren aus.
-
Wählen Sie Aktivieren aus.
-
Result: Once your solution is deployed and successfully activated, that solution is displayed on the Deployments tab with an Active status.