DocumentationAEM as a Cloud ServiceGuide de l’utilisateur

Variables de pipeline dans Cloud Manager configuring-pipeline-variables

Last update: Mon Oct 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 devrez peut-être é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

Cloud Manager vous permet de configurer des 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.

Ajout d’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 pour différentes étapes.

Vous devez disposer des autorisations nécessaires pour modifier le pipeline pour ajouter, modifier et supprimer des variables de pipeline.

Si un pipeline s’exécute, la gestion des variables est bloquée.

Pour ajouter une variable de pipeline via Cloud Manager :

  1. Lorsque vous gérez vos pipelines, cliquez sur Ellipsis - Icône More du pipeline pour lequel vous souhaitez créer des variables de pipeline.

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

    Afficher/modifier des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, saisissez les détails à 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. Elle doit respecter les conventions d’appellation suivantes :

    • Les variables ne peuvent contenir que des caractères alphanumériques et un 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.
    • Chaque valeur de variable de type secretString doit comporter 500 caractères ou moins.
    Valeur La valeur contenue dans la variable.
    Étape appliquée

    Requis. L’étape du pipeline auquel 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.
    • Tests de l’interface utilisateur - La variable est utilisée pendant la phase de test de l’interface utilisateur.
    Type Sélectionnez cette option si la variable est en texte brut ou chiffrée en secret.

    Ajouter une variable

  4. Cliquez sur Ajouter.

    Ajoutez d’autres variables si nécessaire.

  5. Cliquez sur Enregistrer.

Modification d’une variable de pipeline edit-ui

  1. Lorsque vous gérez vos pipelines, cliquez sur Ellipsis - Icône More du pipeline pour lequel vous souhaitez modifier les variables de pipeline.

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

    Afficher/modifier des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, cliquez sur Ellipsis - Icône More de la variable que vous souhaitez 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.

Supprimer une variable de pipeline delete-ui

  1. Lorsque vous gérez vos pipelines, cliquez sur Ellipsis - Icône More du pipeline pour lequel vous souhaitez supprimer des variables de pipeline.

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

    Afficher/modifier des variables de pipeline

  3. Dans la boîte de dialogue Configuration des variables, cliquez sur Ellipsis - Icône More de la variable à supprimer, puis cliquez sur Supprimer.

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

Cette commande de l’interface de ligne de commande 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