Configuration des objets globaux pour l' Orchestration Pipelines

Définition d'un paramètre de pipeline

1. Créez un paramètre de pipeline à partir du panneau de configuration de noeud de la barre d'outils.
2. Entrez un nom et une description facultative. Le nom doit être un serpent minuscule avec des lettres minuscules, des chiffres et des traits de soulignement. Par exemple, lower_snake_case_with_numbers_123 est un nom valide. Le nom doit commencer par une lettre. Si le nom n'est pas conforme, vous obtenez une erreur 404 lorsque vous tentez d'exécuter le pipeline.
3. Affectez un type de paramètre. En fonction du type de paramètre, vous devrez peut-être fournir plus de détails ou affecter une valeur par défaut.
4. Cliquez sur Ajouter à la liste pour sauvegarder le paramètre de pipeline.

Types de paramètre

Les types de paramètre sont catégorisés comme suit:

• De base: inclut des types de données pour structurer l'entrée dans un pipeline ou des options permettant de gérer la création d'un espace ou d'un actif en double.
• Ressource: permet de sélectionner un projet, un catalogue, un espace ou un actif.
• Instance: pour la sélection d'une instance d'apprentissage automatique ou d'une instance Cloud Object Storage .
• Autre: pour spécifier des détails, tels que le mode de création ou la règle d'erreur.

Planification de l'utilisation de données chiffrées

Les types de données chiffrées sont conservés en interne en tant que paramètres. Lorsque vous le transmettez en tant que variable d'environnement, il est stocké en tant que fichier monté temporairement.

Lorsque vous prévoyez d'utiliser le type de données chiffré, tenez compte des types de données chiffrés suivants:

• sont disponibles uniquement pour les paramètres de pipeline, les valeurs d'ensemble de paramètres et les variables d'environnement.
• doit être une valeur unique (aucune liste chiffrée).

Exemple d'utilisation de paramètres chiffrés

1. Créez un ensemble de paramètres appelé MASTER_PARAMETER_SET.
2. Créez un paramètre appelé dummy_pass et définissez le type sur Chiffré.
3. Définissez la valeur de dummy_pass sur n'importe quelle valeur.
4. Faites glisser le noeud Exécuter le script Bash sur l'espace de travail.
5. Ajoutez une variable d'environnement appelée DB2PASSWORD et affectez sa valeur à MASTER_PARAMETER_SET.dummy_pass.
6. Facultatif: testez votre variable de paramètre:
   1. Collez la commande suivante dans le code de script du script Run Bash:

      PARAM_VAL=$(<"$DB2PASSWORD")
      echo $PARAM_VAL
      

7. Exécutez le pipeline. Consultez le mot de passe factice dans le journal du noeud Exécuter le script Bash et PARAM_VAL se voit désormais attribuer la valeur $DB2PASSWORD.

Création d'un ensemble de paramètres en tant qu'actif de projet

Vous pouvez créer un ensemble de paramètres en tant qu'actif de projet réutilisable à utiliser dans des pipelines.

1. Ouvrez un projet existant ou créez un projet.
2. Cliquez sur « Nouvel élément » > « Définir des ensembles de paramètres réutilisables ».
3. Attribuez un nom à l'ensemble et spécifiez les détails de chaque paramètre de l'ensemble, notamment:
   • Nom du paramètre
   • Type de données
   • Invite
   • Valeur par défaut
4. Vous pouvez éventuellement créer des ensembles de valeurs pour les paramètres de l'ensemble de paramètres. Les ensembles de valeurs peuvent être des valeurs différentes pour différents contextes. Par exemple, vous pouvez créer un ensemble de valeurs de test avec des valeurs pour un environnement de test et un ensemble de valeurs de production.
5. Sauvegardez l'ensemble de paramètres après avoir créé tous les paramètres, s. Il peut être utilisé dans les pipelines créés dans ce projet.

Ajout d'un ensemble de paramètres à utiliser dans un pipeline

Pour ajouter un ensemble de paramètres à partir d'un projet:

1. Cliquez sur l'icône des objets globaux et accédez à l' onglet Ensembles de paramètres.
2. Cliquez sur Ajouter un ensemble de paramètres pour ajouter des ensembles de paramètres à partir de votre projet que vous souhaitez utiliser dans votre pipeline.
3. Vous pouvez ajouter ou supprimer des ensembles de paramètres de la liste. Les ensembles de paramètres que vous spécifiez pour une utilisation dans votre pipeline deviennent disponibles lorsque vous affectez des paramètres en tant qu'entrée dans le pipeline.

Création d'un ensemble de paramètres à partir de la liste de paramètres dans votre pipeline

Vous pouvez créer un ensemble de paramètres à partir de la liste des paramètres de votre pipeline

1. Cliquez sur l'icône des objets globaux et ouvrez les paramètres de pipeline.
2. Sélectionnez les paramètres de votre choix dans l'ensemble, puis cliquez sur l'icône Sauvegarder en tant qu'ensemble de paramètres .
3. Entrez un nom et une description facultative pour l'ensemble.
4. Sauvegardez pour ajouter l'ensemble de paramètres à utiliser dans votre pipeline.

Utilisation d'un ensemble de paramètres dans un pipeline

Pour utiliser un ensemble de paramètres:

1. Choisissez Affecter un paramètre de pipeline comme type d'entrée à partir d'une feuille de propriétés de noeud.
2. Choisissez le paramètre à affecter. Une liste affiche tous les paramètres disponibles du type pour cette entrée. Les paramètres disponibles peuvent être des paramètres individuels et des paramètres définis dans le cadre d'un ensemble. Le nom de l'ensemble de paramètres précède le nom du paramètre. Par exemple, Parameter_set_name.Parameter_name.
3. Exécutez le pipeline et sélectionnez une valeur définie pour la valeur correspondante (si disponible), affectez une valeur au paramètre ou acceptez la valeur par défaut.

Utilisation des ensembles de paramètres par défaut du projet

Un projet peut avoir un ensemble de paramètres nommé PROJDEF. Cet ensemble de paramètres contient les paramètres et les valeurs de variable d'environnement d'un travail ou d'une exécution de travail Pipelines. Comme il s'agit d'un ensemble de paramètres, vous pouvez utiliser l'interface utilisateur de l'ensemble de paramètres existant pour gérer ces variables. L'ensemble de paramètres peut être importé dans d'autres projets.

Méfiez-vous des PROJDEF:

• Vous pouvez référencer une valeur d'ensemble de paramètres PROJDEF avec la valeur PROJDEF du paramètre de pipeline.
• La valeur PROJDEF est prise en charge pour les paramètres de tous les types, mais uniquement pour les variables d'environnement définies par l'utilisateur PROJDEF chiffrées et de type chaîne.
• Les paramètres de l'ensemble de paramètres PROJDEF doivent utiliser le même nom que les paramètres de pipeline ayant la valeur PROJDEF.

Pour utiliser PROJDEF dans un projet:

1. Créez l'ensemble de paramètres PROJDEF.

2. Ajoutez le paramètre à votre jeu de paramètres PROJDEF, par exemple $DB2_USERID.

3. Ajoutez une variable définie par l'utilisateur portant le même nom dans votre flux de pipelines.

4. Ajoutez une variable définie par l'utilisateur portant le même nom dans votre flux de pipelines.

5. Cliquez sur Editer les paramètres locaux ou sur Editer l'ensemble de paramètres pour ce travail en fonction de l'endroit où votre variable est créée.

6. Cliquez sur Assign PROJDEF dans le menu déroulant Valeur dérivée de pour la variable. Si PROJDEF n'est pas disponible, l'option de menu n'apparaît pas.

7. Facultatif: Pour entrer une valeur de variable à partir d'une autre méthode, cliquez sur l'icône de déconnexion.

Pour affecter PROJDEF à tous les paramètres d'un ensemble:

1. Editez vos ensembles de valeurs en cliquant sur Editer les valeurs pour ce travail ou une valeur similaire.
2. Cliquez sur la liste déroulante Ensemble de paramètres source .
3. Sélectionnez PROJDEF.

Edition d'un ensemble de paramètres dans un travail

Si vous utilisez un ensemble de paramètres lorsque vous définissez un travail, vous pouvez choisir un ensemble de valeurs pour remplir les variables avec les valeurs de cet ensemble. Si vous modifiez et sauvegardez les valeurs, puis éditez le travail et sauvegardez les modifications, les valeurs par défaut des ensembles de paramètres sont rétablies.

Définition d'une variable utilisateur

Vous pouvez créer des variables utilisateur à utiliser dans votre pipeline. Les variables utilisateur, telles que les paramètres, sont définies au niveau global et ne sont spécifiques à aucun noeud. La valeur initiale d'une variable utilisateur doit être définie lorsque vous la définissez et ne peut pas être définie dynamiquement en tant que résultat d'une sortie de noeud. Lorsque vous définissez une variable utilisateur, vous pouvez utiliser le noeud Définir des variables utilisateur pour la mettre à jour avec la sortie du noeud.

Pour créer une variable utilisateur:

1. Créez une variable à partir du panneau de configuration du noeud Mettre à jour la variable ou de la barre d'outils.
2. Entrez un nom et une description facultative. Le nom doit être un serpent minuscule avec des lettres minuscules, des chiffres et des traits de soulignement. Par exemple, lower_snake_case_with_numbers_123 est un nom valide. Le nom doit commencer par une lettre. Si le nom n'est pas conforme, vous obtenez une erreur 404 lorsque vous tentez d'exécuter le pipeline.
3. Complétez la définition de la variable, y compris le choix d'un type de variable et d'un type d'entrée.
4. Cochez l'option Rendre la valeur de la variable utilisateur disponible comme résultat du pipeline. L'option active l'utilisation de la valeur en tant que sortie à partir de tout noeud Exécuter le travail de pipeline qui s'exécute dans ce pipeline. Pour plus d'informations sur l'utilisation, voir Variables utilisateur dans les résultats de pipeline .
5. Cliquez sur Ajouter pour ajouter la variable à la liste. Il est désormais disponible pour être utilisé dans un noeud.

Variables utilisateur dans les résultats de pipeline

Si une variable utilisateur peut être utilisée en conséquence, elle devient disponible en tant que sortie dans tous les travaux associés à ce pipeline.

Un cas d'utilisation courant consiste à pouvoir utiliser une valeur calculée dans un pipeline à partir d'un autre pipeline qui l'exécute. Vous pouvez stocker le nom de fichier dans une variable utilisateur, puis exécuter ce pipeline à partir d'un autre pipeline avec le nom de fichier comme entrée dans un script Bash.

Configuration de la limite de taille pour une variable utilisateur

1. Ouvrez votre mappe de configuration en exécutant la commande kubectl edit -n <namespace> configmap watson-pipelines-config où namespace est votre espace de nom d'instance Cloud Pak for Data .
2. Définissez la valeur de user_variables_size_limit avec la valeur au format de quantité Kubernetes .
3. Redémarrez vos pods Tekton en exécutant la commande kubectl -n <namespace> delete pod -l 'app=tekton-extensions-controller'.

Définir un fuseau horaire

Vous pouvez définir le fuseau horaire dans votre mappe de configuration.

1. Ouvrez votre mappe de configuration en exécutant la commande kubectl edit -n <namespace> configmap watson-pipelines-config où namespace est votre espace de nom d'instance Cloud Pak for Data .
2. Définissez la valeur de votre fuseau horaire avec l'exemple de code suivant:

   apiVersion: v1
   kind: ConfigMap
   metadata:
      name: watson-pipelines-config
      namespace: zen
   data:
      default_container_env: |
         - name: TZ
           value: America/New_York
   

3. Définissez la valeur de votre fuseau horaire dans Pipelines CR :

   oc patch wspipelines wspipelines-cr -p '{"spec":{"timezone":"America/New_York"}}' --type=merge
   

4. Attendez la fin de la réconciliation avec :

   oc get wspipelines wspipelines-cr