Déploiement d'une solution

Déployez un package de solution pour un locataire Orchestrator dans Automation Cloud.

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:

• Onglet Déploiements: sélectionnez Déployer dans le coin supérieur droit.
• Onglet Packages: sélectionnez l'action Deployer row pour le package que vous souhaitez déployer.
• Barre latérale du package: ouvrez un package pour développer sa barre latérale, puis sélectionnez Déployer dans le coin supérieur droit de la barre latérale.
• Onglet Versions de la barre latérale du package: sélectionnez l'action Déployer la ligne pour la version de package spécifique que vous souhaitez déployer.

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

Le formulaire Configuration est l'endroit où vous définissez ce qu'il doit déployer, où il arrive et comment il s'active. Remplissez les champs suivants, puis sélectionnez Déployer. Les champs Package et Version sont toujours visibles; les champs restants sont regroupés sous la commande Options , que vous pouvez développer ou réduire. Lorsqu'elle est réduite, le champ Options affiche un résumé des valeurs actuelles (par exemple, le dossier de destination, si les déclencheurs sont immédiatement activés et si un runtime est configuré).

Champ	Description
Paquet (Package)	Sélectionnez le package de solution à déployer dans la liste déroulante. Une fois que vous avez sélectionné un package, sa description s’affiche sous le champ.
Version	La version de package à installer. Apparaît après que vous avez sélectionné un package. La valeur par défaut est la dernière version publiée. Chaque entrée affiche le flux dans lequel la version a été publiée. La date de publication et les notes de publication de la version sélectionnée s'affichent sous le champ. Sélectionnez une version différente dans la liste déroulante si nécessaire.
Options	Développe ou réduit les paramètres de déploiement qui suivent. Lorsqu'elle est réduite, elle affiche un résumé des valeurs sélectionnées.
Nom du déploiement	Un nom unique et requis pour ce déploiement. Remplissage automatique à partir du nom du package. Modifiez pour utiliser un autre nom. Le nom est validé au fur et à mesure que vous saisissez: si un déploiement du même nom existe déjà, le formulaire affiche une erreur et vous ne pouvez pas continuer tant que le nom n'est pas unique.
Emplacement	Le dossier dans lequel le dossier de la solution sera créé. La valeur par défaut est Partagé. Sélectionnez un dossier spécifique dans la liste déroulante, ou sélectionnez Installer en tant que dossier racine pour créer ce dossier sous le locataire.
Domaine d’activité	Facultatif. Une ou plusieurs zones métier auxquelles ce déploiement appartient. Pour filtrer les déploiements de solutions par domaine d'activité, utilisez Registre Déploiements > Déploiements de solutions dans Orchestrator. Pour plus de détails, consultez la section À propos du contexte du registre.
Propriétaire de l’entreprise	Facultatif. La personne responsable de ce déploiement. Vous pouvez filtrer l'onglet Déploiements par propriétaire de l'entreprise.
Nom du dossier de la solution	Nom du sous-dossier créé dans le dossier de destination. Remplissage automatique pour correspondre au nom du déploiement jusqu'à ce que vous le modifiiez. Modifiez-le pour le personnaliser pour ce déploiement.
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.

Flux et emplacement de déploiement

Une version publiée dans le flux du locataire est libellée Locataire dans la liste déroulante Version . Le champ Emplacement définit l'emplacement de création du dossier de la solution. Pour un package publié dans le flux de locataire, vous pouvez sélectionner n’importe quel dossier. Un package publié dans un flux de dossier ne peut être déployé qu'au sein de la hiérarchie de dossiers de ce flux.

Pour publier un package dans un flux de dossier, utilisez l'option Flux dans le panneau Publier de Studio Web. Pour connaître les étapes, consultez Publier une solution dans un flux.

Pour connaître la relation entre les flux, consultez Flux de solution.

Le formulaire Configuration vérifie vos autorisations avant d'activer le déploiement. Pour l'autorisation requise par chaque flux et les messages affichés par le formulaire, consultez la section Autorisations requises pour le déploiement.

Exécuter le déploiement

Après avoir rempli le formulaire Configuration, choisissez l'une des options suivantes en bas du formulaire:

• Déployer: valide la configuration et exécute immédiatement le déploiement. Le workflow progresse à travers les étapes suivantes indiquées dans le panneau Que se passera-t-il sur la gauche. Si la configuration comporte des erreurs, le flux s'arrête à Configurer et ouvre l'explorateur de ressources afin que vous puissiez les corriger. Si l'option Activer immédiatement est désactivée, l'étape Activer est ignorée.

  Étape	Description
  Configuration	Confirme les paramètres du formulaire de configuration.
  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 .

  Lorsque l'exécution se termine, un écran de réussite affiche le déploiement réussi et le message « [package] v[version] a été déployé!». L'écran comporte les options Afficher les déploiements, Démarrer la tâche et Accéder au dossier. Si l’option Activer a été immédiatement désactivée, l’écran affiche également une bannière Activation requise avec un bouton Activer .

• Personnaliser (sélectionnez la flèche déroulante sur le bouton Déployer ): ouvre l'explorateur de ressources afin que vous puissiez examiner et configurer les composants de la solution individuels avant l'exécution du déploiement. Dans l'explorateur de ressources, vous pouvez:

  • Filtrez les propriétés affichées pour un composant à l'aide de la commande Affichage (Toutes les propriétés, Propriétés vides, Propriétés requises ou Propriétés configurables).
  • Liez un composant à une ressource existante, modifiez la ressource à laquelle il est lié ou dissociez-le — voir Lier, modifier ou dissocier un composant ci-dessous.
  • Inversez les modifications apportées à un composant à l'aide de Réinitialiser.
  • Examinez le compteur de problèmes (erreurs, avertissements et informations) et le panneau Journaux .

  Lorsque vous avez terminé, sélectionnez l'une des options suivantes:

  • Poursuivez le déploiement.
  • Validez pour vérifier la configuration sans déployer.
  • Enregistrez en tant que brouillon pour enregistrer et reprendre ultérieurement.
  • Annuler pour annuler vos modifications. La passerelle Annuler ce déploiement? la boîte de dialogue contient des boutons Non et Oui . Pour conserver vos modifications, sélectionnez Non, puis sélectionnez Enregistrer en tant que brouillon.

Enregistrer un déploiement en tant que brouillon

Si vous n’êtes pas prêt à exécuter un déploiement, vous pouvez enregistrer votre progression et le terminer ultérieurement:

1. Sélectionnez Personnaliser dans la liste déroulante du bouton Déployer pour ouvrir l'explorateur de ressources.
2. Configurez les composants selon les besoins.
3. Sélectionnez Enregistrer en tant que brouillon.

Une fois que vous avez sélectionné Enregistrer en tant que brouillon, l'onglet Déploiements s'ouvre. La ligne du brouillon se trouve en haut avec une puce de statut Brouillon et Install · Draft dans Dernière opération.

Pour un nouveau brouillon d'installation, la barre latérale affiche uniquement les actions suivantes:

• Continuer la modification: rouvre l'explorateur de ressources à l'étape Configurer .
• Supprimer le brouillon: supprime le brouillon.

Lier, modifier ou dissocier un composant (facultatif)

La liaison d'un composant à une ressource existante évite de dupliquer les connexions, les ressources et les files d'attente entre les déploiements. Lors de la personnalisation d'un brouillon de déploiement, vous pouvez lier un composant à une ressource existante, modifier la ressource à laquelle il est lié ou le dissocier.

Remarque :

Lorsque le déploiement se trouve en dehors de votre espace de travail personnel (par exemple, dans un dossier partagé), la liste des candidats exclut les ressources stockées dans votre espace de travail personnel à n'importe quelle profondeur de dossier, y compris les sous-dossiers imbriqués. Cela évite les configurations de déploiement endommagées que vos collaborateurs ne peuvent pas exécuter ou gérer, car ils ne peuvent pas accéder aux ressources de votre espace de travail personnel.

Si le déploiement se trouve au sein de votre espace de travail personnel, toutes vos ressources accessibles, y compris vos ressources d'espace de travail personnel, sont disponibles pour être liées.

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.

Les ressources qui se trouvent au niveau du locataire plutôt que dans un dossier sont marquées d'une icône dédiée dans l'arborescence de l'explorateur de ressources, et leur en-tête de détails de la ressource affiche une puce de locataire .

Lier un composant à une ressource existante

1. Dans l'explorateur de ressources, sélectionnez le composant que vous souhaitez lier.

2. Sélectionnez Lier à l'existant.

   Le titre du sélecteur est Lier à [type de ressource] existant, par exemple Lier à une ressource existante. Le champ de recherche est pré-rempli avec le nom du composant. Chaque ligne de ressource candidat affiche le nom de la ressource, un libellé de type tel que Ressource (Informations d’identification) et le chemin du dossier. Les emplacements de votre espace de travail personnel sont libellés Mon espace de travail. Le sélecteur affiche également une note sur l'association d'une ressource avec un nom différent, ainsi que les boutons Annuler et Lier .

3. Sélectionnez la ressource à laquelle vous souhaitez lier.

4. Sélectionnez Lien.

Remarque :

• Lorsqu’une ressource est liée, elle n’est pas créée dans le cadre du déploiement; la solution utilise directement la ressource liée. Associer une ressource avec un nom différent peut entraîner des erreurs de runtime, sauf si la solution a été développée pour prendre en charge cette configuration.
• Lorsque vous liez une ressource qui existe dans un autre dossier, la solution stocke la dépendance du runtime dans le dossier de la solution où la ressource est copiée, et non dans le dossier source d'origine. Les utilisateurs disposant d'autorisations sur le dossier de la solution peuvent exécuter le processus sans avoir besoin d'autorisations sur l'emplacement des ressources d'origine.

Comprendre un composant lié

Lorsqu'un composant est lié, un badge lié apparaît dans l'arborescence des composants et dans l'en-tête des détails. La zone des détails affiche une carte de ressource liée avec un bouton Modifier et le message suivant: « La ressource est liée et ne sera pas créée dans le cadre du déploiement.» La dissociation se trouve dans le coin supérieur droit de la zone des détails.

Modifier ou dissocier un composant

Les composants liés sont marqués d'un badge lié dans l'explorateur de ressources.

1. Dans l’explorateur de ressources, sélectionnez le composant lié.
2. Sélectionnez l'une des options suivantes :
   • Modifiez pour lier le composant à une ressource différente, en utilisant le même sélecteur décrit ci-dessus.
   • Dissocier pour supprimer le lien.

Résultat: la dissociation supprime la connexion entre la solution et la ressource externe. La ressource est alors créée à l’intérieur du dossier de la solution au lieu de réutiliser celui lié.

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

Remarque :

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 Autres actions , puis sélectionnez Activer. Vous pouvez également sélectionner Activer le déploiement dans la barre latérale. Les deux ouvrent la boîte de dialogue Activer le déploiement , qui affiche deux vérifications: Ajouter des comptes et attribuer des rôles (avec le lien Gérer les comptes ) et Ajouter des machines (avec le lien Configurer les machines ). Sélectionnez Activer le déploiement pour continuer, ou le faire plus tard pour fermer la boîte de dialogue.

• Inactif (nécessite une configuration pour être activé): des prérequis supplémentaires doivent être remplis avant l'activation:

  1. Sélectionnez l'icône Autres actions et choisissez Configurer l'activation.

  2. 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.

     Les composants liés ne peuvent pas être reconnectés ou dissociés pendant l’activation. Si un composant est lié, la vue de la configuration affiche un avis au lieu de champs modifiables.

     Remarque :

     Lors du déploiement d'une solution, un modèle Sans serveur par défaut peut être automatiquement joint au dossier cible si le bouton bascule Configurer le runtime a été activé sur le formulaire de configuration. Cela garantit que la solution peut s'exécuter sans configurer manuellement les modèles de machine. Si un modèle sans serveur est déjà hérité, aucun modèle supplémentaire n’est joint.

  3. Résolvez les éléments répertoriés.

  4. Sélectionnez Valider.

  5. Sélectionnez Activer.

Résultat: une fois votre solution déployée et activée avec succès, cette solution s'affiche dans l'onglet Déploiements avec le statut Actif.