- Introduction
- Gestion des projets et packages de solutions
- Gestion des déploiements de solutions
- Meilleures pratiques
Guide de l'utilisateur des solutions
Déployer une solution implique d'installer un package de solution en tant que nouveau déploiement dans un dossier Orchestrator. Pour plus d'informations sur les déploiements de solutions, consultez Comprendre le cycle de vie du développement des solutions.
Vous pouvez lancer un déploiement de solution depuis Studio Web ou Orchestrator. Les deux interfaces pilotent la même expérience de déploiement sous-jacente: Studio Web est l'interface d'origine conçue pour les auteurs de solutions qui souhaitent compresser et déployer dans un même flux; Orchestrator est l'espace administratif conçu pour les Administrators de locataires gérant les déploiements à grande échelle. Cette page documente le flux Orchestrator.
Le flux de déploiement d’Orchestrator nécessite un package de solution qui a déjà été publié dans un flux. Vous pouvez publier un package depuis Studio Web ou Studio Desktop avant de le déployer ici.
Cette étape est généralement effectuée par un administrateur.
Ouvrez le workflow de déploiement
Vous pouvez ouvrir le workflow de déploiement depuis l'un des emplacements suivants dans Orchestrator:
- 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.
Les quatre chemins ouvrent le même Déployer le workflow dans le formulaire Configuration . Le fil d'Ariane en haut indique Locataire > Solutions > Déploiements > Déployer.
Remplir le formulaire de configuration
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).
| Champ | Description |
|---|---|
| Paquet (Package) | 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. |
| Options | Expands or collapses the deployment settings that follow. When collapsed, it shows a summary of the selected values. |
| Nom du déploiement | 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. |
| Emplacement | Le dossier dans lequel le dossier de la solution sera créé. La valeur par défaut est Partagé. Sélectionnez un autre dossier dans la liste déroulante pour modifier la destination. |
| Nom du dossier de la solution | 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. |
| Activer immédiatement | Activer (activé par défaut). Lorsque cette option est activée, les déclencheurs sont immédiatement activés, le cas échéant. |
| Configurer le runtime | Activer (activé par défaut). Lorsqu'il est activé, enregistre un runtime sans serveur lorsqu'aucune machine d'exécution par défaut n'est configurée au niveau du locataire. |
Exécuter le déploiement
Après avoir rempli le formulaire Configuration, choisissez l'une des options suivantes en bas du formulaire:
-
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:
Étape Description Configurer Valide et configure le déploiement. Déployer Configure des dossiers et enregistre des ressources. Activer (Activate) Active les déclencheurs et valide le déploiement si l’option Activer est activée immédiatement . -
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.
Réutiliser des composants existants (facultatif)
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.
Lorsque vous sélectionnez Personnaliser, l'explorateur de ressources affiche tous les composants dans le package de solution. Si un composant portant le même nom existe déjà dans le locataire, vous pouvez lui lier la solution au lieu d’en créer un nouveau.
Cette option est disponible pour les ressources, les compartiments de stockage, les webhooks et les files d'attente. Pour chaque conflit, vous pouvez:
- Conservez le composant existant et n'en créez pas un supplémentaire.
- Conservez le composant existant et ajoutez de nouveaux champs à partir de la solution (les champs existants ne sont pas modifiés).
- Renommez la ressource en conflit dans le service concerné.
- Renommez la ressource dans le déploiement de la solution, si possible.
Pour lier un composant existant:
-
Dans l'explorateur de ressources, sélectionnez le composant que vous souhaitez lier.
-
Sélectionnez Lier à l'existant.
-
Dans la boîte de dialogue Lier au processus existant , sélectionnez le composant auquel vous souhaitez lier.
-
Sélectionnez Lien.
- 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.
Surveiller le statut du déploiement
Une fois le déploiement démarré, vous pouvez surveiller la progression à partir de la vue du workflow ou de l'onglet Déploiements dans Solutions. Les statuts suivants sont possibles:
| État (Status) | Description |
|---|---|
| En cours | L’opération de déploiement est en cours d’exécution. |
| Réussi | Le déploiement est terminé et tous les composants sont installés. |
| Échec | Le déploiement a échoué et une restauration automatique a été effectuée. |
| Échec de la restauration | Le déploiement a échoué et certains composants nécessitent un nettoyage manuel. |
Pour plus de détails sur tous les statuts, consultez Statuts de déploiement.
Activer le déploiement
Si la solution contient des applications et qu’elles ne sont pas activées à l’aide du lien fourni, l’activation du déploiement échouera. Consultez la documentation d'Orchestrator et d'Apps pour des instructions détaillées.
Après un déploiement réussi, Orchestrator évalue l'état de préparation à l'activation. Le déploiement apparaît dans l'onglet Déploiements avec l'un des statuts suivants:
-
Inactif (Prêt à être activé): aucune configuration supplémentaire n’est requise. Sélectionnez l'icône Plus d'actions , puis sélectionnez Activer le déploiement.
-
Inactif (nécessite une configuration pour être activé): des prérequis supplémentaires doivent être remplis avant l'activation:
-
Sélectionnez l'icône Autres actions et choisissez Configurer l'activation.
-
Examinez les résultats de la validation de l'activation et remplissez les éléments requis:
- Ajouter des comptes et attribuer des rôles.
- Ajouter des machines aux dossiers de solutions.
- Définissez des mappages compte-machine, si nécessaire.
- Définissez les valeurs d'actif par robot, le cas échéant.
- Activez les apps utilisées dans la solution.
- Remplissez les liaisons pour les composants de type processus, le cas échéant.
Remarque :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.
-
Résolvez les éléments répertoriés.
-
Sélectionnez Valider.
-
Sélectionnez Activer.
-
Result: Once your solution is deployed and successfully activated, that solution is displayed on the Deployments tab with an Active status.