DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

Variables de pipeline dans Cloud Manager configuring-pipeline-variables

Last update: Thu Oct 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Administration
  • Développeur

Votre processus de création peut dépendre de variables de configuration spécifiques qui ne doivent pas être stockées dans le référentiel Git. Vous pouvez également les ajuster entre les exécutions de pipeline sur la même branche. Cloud Manager vous permet de gérer ces paramètres en tant que variables de pipeline.

À propos des variables de pipeline pipeline-variables

Avec Cloud Manager, vous pouvez configurer les variables de pipeline de plusieurs manières différentes.

Les variables peuvent être stockées en texte brut ou chiffrées au repos. Dans les deux cas, les variables sont disponibles dans l’environnement de création en tant que variable d’environnement qui peut ensuite être référencée depuis le fichier pom.xml ou d’autres scripts de création.

Ajouter une variable de pipeline via Cloud Manager ui

Les variables de pipeline peuvent être configurées et gérées via l’interface utilisateur de Cloud Manager. Ils permettent de rationaliser la gestion des pipelines, en particulier lorsque différentes configurations sont requises selon différentes étapes.

Vous devez disposer des autorisations de modification du pipeline pour ajouter, modifier et supprimer des variables de pipeline.

Si un pipeline est actif, la gestion des variables est bloquée.

Pour ajouter une variable de pipeline via Cloud Manager :

  1. Lors de la gestion de vos pipelines, cliquez sur l’icône Points de suspension - Plus du pipeline pour lequel vous souhaitez créer des variables de pipeline.

  2. Dans le menu déroulant, cliquez sur Afficher/Modifier les variables.

    Affichage/modification des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, saisissez les détails dans la première ligne du tableau.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Champ Description
    Nom

    Nom unique de la variable de configuration. Il identifie la variable spécifique utilisée dans le pipeline. Il doit respecter les conventions de dénomination suivantes :

    • Les variables ne peuvent contenir que des caractères alphanumériques et le trait de soulignement (_).
    • Les noms doivent être en majuscules.
    • Il existe une limite de 200 variables par pipeline.
    • Chaque nom doit comporter 100 caractères ou moins.
    • La valeur string de chaque variable doit comporter moins de 2 048 caractères.
    • La valeur de chaque variable de type secretString doit comporter 500 caractères ou moins.
    Valeur Valeur de la variable.
    Étape appliquée

    Obligatoire. L’étape du pipeline à laquelle la variable s’applique :

    • Build - La variable est appliquée pendant le processus de création.
    • Tests fonctionnels - La variable est utilisée pendant l’étape de test fonctionnel.
    • Test de l’interface utilisateur - La variable est utilisée pendant la phase de test de l’interface utilisateur. <li< Deploy - La variable est utilisée lors de l’étape de déploiement. Par exemple, utilisez cette variable pour les pipelines Edge Delivery Services.
    Type Sélectionnez cette option si la variable est en texte brut ou chiffrée en tant que secret.

    Ajouter une variable

  4. Cliquez sur Ajouter.

    Ajoutez des variables supplémentaires si nécessaire.

  5. Cliquez sur Enregistrer.

Modification d’une variable de pipeline edit-ui

  1. Lors de la gestion de vos pipelines, cliquez sur l’icône Points de suspension - Plus du pipeline pour lequel vous souhaitez modifier les variables de pipeline.

  2. Dans le menu déroulant, cliquez sur Afficher/Modifier les variables.

    Affichage/modification des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, cliquez sur l’icône Points de suspension - Plus de la variable à modifier.

  4. Dans le menu déroulant, cliquez sur Modifier.

    Modifier la variable

  5. Mettez à jour la valeur de la variable selon les besoins.

    Seule la valeur de la variable peut être modifiée.

  6. Utilisez l’une des méthodes suivantes :

    • Cliquez sur Appliquer - Icône de coche pour appliquer la modification.
    • Cliquez sur Icône Annuler pour annuler la modification.

  7. Cliquez sur Enregistrer.

Suppression d’une variable de pipeline delete-ui

  1. Lors de la gestion de vos pipelines, cliquez sur l’icône Points de suspension - Plus du pipeline pour lequel vous souhaitez supprimer des variables de pipeline.

  2. Dans le menu déroulant, cliquez sur Afficher/Modifier les variables.

    Affichage/modification des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, cliquez sur l’icône Points de suspension - Plus de la variable à supprimer, puis cliquez sur Supprimer.

Définir des variables de pipeline à l’aide de l’interface de ligne de commande Cloud Manager cli

Cette commande de l’interface de ligne de commande (CLI) définit une variable.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

Cette commande répertorie les variables.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Lorsqu’elles sont utilisées dans un fichier Maven pom.xml, il est souvent utile de lier ces variables aux propriétés Maven en utilisant une syntaxe similaire à l’exemple suivant :

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab