Accès aux annotations

Vous pouvez accéder aux annotations à partir des tâches dans votre fichier yaml de définition de pipeline. L'exemple suivant montre comment accéder à l'annotation devops.cloud.ibm.com/build-number. Pour fournir cette annotation sous forme de variable d'environnement, remplacez-la par l'une des annotations d'exécution du tableau 1. annotations PipelineRun.

apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: simple-task
spec:
  steps:
    - name: simple-step
      image: icr.io/continuous-delivery/pipeline/pipeline-base-image:2.69
      env:
        - name: BUILD_NUMBER
          valueFrom:
            fieldRef:
              fieldPath: metadata.annotations['devops.cloud.ibm.com/build-number']
      command: ["bash", "-c"]
      args:
        - echo $BUILD_NUMBER;
          echo "COMPLETED"

Accès aux valeurs individuelles

Vous pouvez accéder à des paires clé-valeur individuelles dans un environnement Task. L'extrait de code suivant utilise le nom de propriété apikey sample (avec des propriétés sécurisées) et le nom de propriété environment property (avec des propriétés de texte). Ces noms de propriétés sont définis dans la page Propriétés du pipeline de livraison.

apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: cm-echo-props
spec:
  steps:
    - name: cm-show-props
      image: icr.io/continuous-delivery/pipeline/pipeline-base-image:2.69
      env:
        - name: SECURE_VALUE
          valueFrom:
            secretKeyRef:
              name: secure-properties
              key: apikey
        - name: ENVIRONMENT
          valueFrom:
            configMapKeyRef:
              name: environment-properties
              key: environment
      command: ["/bin/bash", "-c"]
      args:
        - echo -e "environment from ConfigMap is >>";
          echo $ENVIRONMENT;
          echo "";
          echo -e "apikey from Secrets is >>";
          echo $SECURE_VALUE

Accès à l'ensemble des valeurs

Vous pouvez ajouter toutes les paires clé-valeur provenant de et ConfigMap Secret à votre environnement Task. L'exemple suivant monte également le event-parameters``ConfigMap en tant que volume pour accéder à l'en-tête et au corps de l'événement déclencheur. Comme n'est event-parameters présent que pour les déclencheurs generic et scm, le volume est marqué comme facultatif afin que la tâche ne se solde pas par un échec lors des exécutions timer déclenchées par ou manual.

apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: cm-secrets-props
spec:
  steps:
    - name: cm-show-full-env
      image: icr.io/continuous-delivery/pipeline/pipeline-base-image:2.69
      envFrom:
        - configMapRef:
            name: environment-properties
        - secretRef:
            name: secure-properties
      volumeMounts:
        - mountPath: /event-parameters
          name: event-parameters
      command: ["/bin/bash", "-c"]
      args:
        - echo -e "The environment for this Step is ";
          env;
          echo "";
          echo -e "Event header is >>";
          cat /event-parameters/eventHeader || echo "No event header available";
          echo "";
          echo -e "Event body is >>";
          cat /event-parameters/eventBody || echo "No event body available"
  volumes:
    - name: event-parameters
      configMap:
        name: event-parameters
        optional: true

Fonctionnalité de base

Le visualisateur de journaux prend en charge les codes de couleur ANSI et les styles de texte. Il détecte automatiquement les URL dans le contenu des journaux et les restitue sous forme de liens cliquables s'ouvrant dans une nouvelle fenêtre.

Barre d'outils

La barre d'outils affichée dans le visualisateur de journaux comprend un certain nombre de fonctions supplémentaires, notamment

• maximiser : augmenter la surface disponible pour l'affichage du journal en masquant la liste des tâches et l'en-tête d'exécution. Cela permet à l'utilisateur de ne pas être distrait par d'autres parties de l'application et de se concentrer sur le contenu du journal.
• les préférences de l'utilisateur : elles sont conservées localement dans le navigateur et appliquées à tous les journaux de l'application. Pour plus de détails, voir les sections suivantes.

Horodatages

IBM-les travailleurs gérés et les travailleurs privés dont la version de l'agent est égale ou supérieure à 0.20.5 produisent par défaut des lignes de journal précédées d'un horodatage. L'utilisateur peut afficher ou masquer ces horodatages dans le visualiseur de journaux en basculant l'option dans le menu des paramètres de la barre d'outils du visualiseur de journaux.

Les horodatages affichés sont localisés en fonction des paramètres du navigateur de l'utilisateur, la valeur brute de l'horodatage reçue du travailleur étant fournie sous forme d'infobulle au passage de la souris.

Niveaux de journalisation

Le visualisateur de journaux analyse les lignes de journaux pour détecter le niveau de journal associé et les décorer en conséquence pour faciliter la consommation des journaux. Le format pris en charge est le suivant.

<timestamp> ::<level>::<message>

• timestamp est fourni par le travailleur
• level est l'un des error, warning, notice, info debug,, trace
  • debug et trace les journaux sont masqués par défaut
  • toute ligne de journal sans level explicite est considérée comme info, mais n'affichera pas le badge de niveau de journal pour éviter la redondance dans l'interface utilisateur lorsque les utilisateurs n'utilisent pas le format de journal pris en charge
• message est tout autre contenu de la ligne et peut contenir des codes ANSI pour le formatage, etc.

Par exemple, l'extrait suivant produirait une ligne de journal au niveau warning:

echo '::warning::Something that may require attention but is non-blocking…'

Les niveaux d'enregistrement affichés peuvent être modifiés via le menu des paramètres dans la barre d'outils de la visionneuse d'enregistrements.

Groupes de logs

Outre les niveaux de journalisation, le visualiseur de journaux permet également de créer des groupes de journaux. Le format pris en charge est le suivant.

<timestamp> ::group::<message>
…
<timestamp> ::endgroup::

Une commande group marque le début du groupe. Le contenu de message est affiché sous la forme d'un titre/résumé du groupe, accompagné d'un indicateur de l'état actuel du groupe (c'est-à-dire développé ou réduit). Un clic sur le résumé permet de basculer l'état du groupe.

Les groupes sont affichés par défaut dans l'état réduit, sauf si l'étape est toujours en cours lors de l'affichage des journaux. L'utilisateur peut développer ou réduire les groupes comme il le souhaite et leur état sera maintenu jusqu'à ce que l'utilisateur navigue vers une vue différente.

Les commandes group, endgroup et log level s'excluent mutuellement. Cependant, les journaux contenus dans un groupe peuvent utiliser les niveaux de journaux normalement.

L'imbrication de groupes n'est pas prise en charge. Une commande group mettra implicitement fin à tout groupe précédent non terminé.

Par exemple, l'extrait suivant produirait un groupe de journaux avec le résumé "Additional config" contenant un certain nombre de messages au niveau info:

echo '::group::Additional config'
echo 'This extends the base config'
echo '::info:: More info about the config…'
echo '::endgroup::'