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.