Paramètres de déploiement pour ALM Accelerator
Le pipeline d’exportation ALM Accelerator utilise la charge utile des paramètres de déploiement pour personnaliser les pipelines de déploiement pour une solution et un environnement particuliers. La charge utile des paramètres de déploiement est une chaîne JSON transmise au pipeline d’exportation en tant que paramètre.
Les tableaux suivants décrivent les paramètres de déploiement inclus dans la charge utile comprend suivants pour chaque environnement de déploiement.
Paramètres du pipeline de déploiement
| Paramètre | Requise | Description |
|---|---|---|
| ApprovalType | Non | Type d’approbation à utiliser dans le pipeline de déploiement |
| BuildName | Oui | Nom du pipeline de build |
| BuildTemplate | Non | Nom du modèle de pipeline de build |
| DeploymentEnvironmentName | Oui | Nom de l’environnement de déploiement |
| DeploymentEnvironmentUrl | Oui | URL de l’environnement de déploiement |
| EnvironmentUrl | Oui | URL de l’environnement de développement ou du créateur |
| ServiceConnectionName | Oui | Nom de la connexion de service à l’environnement de développement ou du créateur |
| StepType | Non | Type d’étape à utiliser dans le pipeline de déploiement |
Paramètres utilisateur
| Paramètre | Requise | Description |
|---|---|---|
| environmentvariable.environment-variable-schema-name | Non | Définit la valeur des variables d’environnement dans un environnement lors du déploiement. |
| canvasshare.aadGroupId.canvas-app-schema-name | Non | Définit l’ID de groupe Microsoft Entra pour partager l’application canevas. Quand l’application canevas doit être partagée avec plusieurs groupes Microsoft Entra, il est possible d’ajouter un identificateur unique .1 ou .2 à la fin du paramètre. |
| canvasshare.roleName.canvas-app-schema-name | Non | Définit le rôle à attribuer au Microsoft Entra groupe. Les options valides sont CanView, CanViewAndShare et CanEdit. Quand l’application canevas doit être partagée avec plusieurs groupes Microsoft Entra, il est possible d’ajouter un identificateur unique .1 ou .2 à la fin du paramètre. |
| owner.ownerEmail.flow-name.flow-id | Non | Définit le propriétaire du flux attribué après l’importation de la solution dans l’environnement de déploiement. |
| flow.sharing.flow-name.flow-id | Non | Définit l’équipe du groupe Dataverse Microsoft Entra avec laquelle partager l’enregistrement de processus associé au flux après l’importation de la solution dans l’environnement de déploiement. |
| activateflow.activateas.flow-name.flow-id | Non | Définit l’utilisateur auquel emprunter l’identité lors de l’activation du flux. Sinon, l’utilisateur ou le propriétaire créateur de la connexion est utilisé pour activer le flux. |
| activateflow.order.flow-name.flow-id | Non | Définit l’ordre dans lequel activer le flux, utile lors de l’activation des flux parent/enfant. Cependant, les pipelines tentent d’activer les flux tant qu’il y a des flux à activer si l’ordre n’est pas défini. |
| activateflow.activate.flow-name.flow-id | Non | Dans certains cas, les flux peuvent être intentionnellement laissés à l’état désactivé dans un environnement de déploiement. Ce paramètre déclenche les pipelines pour qu’ils activent ou non le flux lors du déploiement. |
| connector.teamname.connector-name.connector-id | Non | Définit l’équipe du groupe Dataverse Microsoft Entra avec laquelle partager l’enregistrement de connecteur associé au connecteur personnalisé après l’importation de la solution dans l’environnement de déploiement. |
| groupTeam.teamid.aadGroupId | Non | Définit les Dataverse équipes de groupe à créer dans l’environnement de déploiement. |
| businessUnit.teamid.aadGroupId | Non | Définit l’a division Dataverse associée aux équipes de groupe. |
| webhookurl.webookname | Non | Définit l’URL du webhook à mettre à jour dans l’environnement de déploiement. |
| sdkstep.unsec.sdkstepid | Non | Définit la configuration non sécurisée de l’étape du SDK pour mettre à jour dans l’environnement de déploiement. |
| sdkstep.sec.sdkstepid | Non | Définit la configuration sécurisée de l’étape du SDK pour mettre à jour dans l’environnement de déploiement. |
| TriggerSolutionUpgrade | Non | Définit l’application ou non de la mise à niveau de la solution lors du déploiement dans cet environnement. |
UserSettings est un tableau de variables définies sur les pipelines de déploiement. Lorsque le pipeline d’exportation est exécuté, les paramètres de déploiement et les fichiers de paramètres de déploiement personnalisés sont générés en utilisant les espaces réservés pour ces valeurs. Lorsque le pipeline de déploiement est exécuté, la plupart des espaces réservés sont remplacés par les valeurs de la charge utile des paramètres de déploiement. À l’exception des variables de pipeline réservées spécifiques, comme TriggerSolutionUpgrade qui ne sont pas incluses dans les paramètres de déploiement ou les paramètres de déploiement personnalisés. De plus, si UseDeploymentSettingsPlaceholders est défini sur False, les espaces réservés ne sont pas utilisés. Au lieu de cela, les valeurs sont définies directement dans les fichiers de paramètres de déploiement et de paramètres de déploiement personnalisés.
Schéma des paramètres de déploiement
Le schéma des paramètres de déploiement est basé sur les composants qui nécessitent une configuration après le déploiement dans un Dataverse solution. Il est mis à jour lorsque de nouvelles fonctionnalités sont ajoutées à l’accélérateur ALM. Le schéma est défini dans le fichier deployment-settings.schema.json.
Exemple de charge utile des paramètres de déploiement
L’exemple de charge utile est un exemple de charge utile courante pour les pipelines ALM Accelerator. L’exemple de charge utile est défini dans le fichier deployment-settings.sample.json.