Accesso alle annotazioni

Puoi accedere alle annotazioni dalle attività all'interno del tuo file yaml di definizione della pipeline. Il seguente esempio mostra come accedere all'annotazione devops.cloud.ibm.com/build-number. Per fornire questa annotazione come variabile d'ambiente, sostituirla con una delle annotazioni di esecuzione della Tabella 1. PipelineRun annotazioni.

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"

Accesso a valori individuali

Puoi accedere a valori-chiavi individuali all'interno di un'attività (Task). Il seguente frammento di codice utilizza il nome della proprietà apikey di esempio (con proprietà sicure) e il nome della proprietà environment (con proprietà di testo). Questi nomi di proprietà sono impostati nella pagina Proprietà della pipeline di consegna.

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

Accesso a tutti i valori

Puoi aggiungere tutte le coppie chiave-valore dalla mappa di configurazione (ConfigMap) e dal segreto (Secret) al tuo ambiente Task:

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
      command: ["/bin/bash", "-c"]
      args:
        - echo -e "The environment for this Step is ";
          env

Funzionalità di base

Il visualizzatore di log supporta i codici colore e gli stili di testo ANSI e rileva automaticamente gli URL nel contenuto del log, rendendoli come link cliccabili che si aprono in una nuova finestra.

Barra degli strumenti

La barra degli strumenti visualizzata nel visualizzatore di log include una serie di funzioni aggiuntive, tra cui:

• massimizzare: aumentare l'area disponibile per la visualizzazione dei registri nascondendo l'elenco delle attività e l'intestazione dell'esecuzione. In questo modo l'utente può eliminare le distrazioni provenienti da altre parti dell'applicazione e concentrarsi sul contenuto del registro.
• preferenze dell'utente: vengono memorizzate localmente nel browser e applicate a tutti i registri dell'applicazione. Per maggiori dettagli, consultare le sezioni seguenti.

timestamps

IBM-i lavoratori gestiti e i lavoratori privati con la versione dell'agente 0.20.5 o successiva, producono linee di log con prefisso temporale per impostazione predefinita. L'utente può mostrare o nascondere questi timestamp nel visualizzatore di log selezionando l'opzione nel menu delle impostazioni nella barra degli strumenti in cima al visualizzatore di log.

I timestamp visualizzati sono localizzati in base alle impostazioni del browser dell'utente e il valore grezzo del timestamp ricevuto dal lavoratore viene fornito come tooltip al passaggio del mouse.

Livelli di log

Il visualizzatore di log analizza le linee di log per rilevare il livello di log associato e le decora di conseguenza per aiutare a consumare i log. Il formato supportato è descritto di seguito.

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

• timestamp è fornito dal lavoratore
• level è uno di error, warning, notice, info, debug
  • debug i log sono nascosti per impostazione predefinita
  • qualsiasi riga di log senza un esplicito level è considerata info, ma non visualizzerà il badge del livello di log per evitare ridondanze nell'interfaccia utente quando gli utenti non utilizzano il formato di log supportato
• message è qualsiasi altro contenuto della riga e può contenere codici ANSI per la formattazione, ecc.

Ad esempio, il seguente snippet produce una riga di log al livello warning :

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

I livelli di log visualizzati possono essere modificati tramite il menu delle impostazioni nella barra degli strumenti nella parte superiore del visualizzatore di log.

Gruppi di log

Oltre ai livelli di log, il visualizzatore di log supporta anche i gruppi collassabili all'interno dei log. Il formato supportato è descritto di seguito.

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

Un comando group segna l'inizio del gruppo. Il contenuto di message viene visualizzato come titolo/riassunto del gruppo insieme a un indicatore dello stato attuale del gruppo (ad esempio, espanso o chiuso). Facendo clic sul riepilogo si alterna lo stato del gruppo.

Per impostazione predefinita, i gruppi vengono visualizzati nello stato collassato, a meno che il passo non sia ancora in corso quando vengono visualizzati i registri. L'utente può espandere o chiudere i gruppi come desidera e il loro stato viene mantenuto finché non si passa a una visualizzazione diversa.

I gruppi di log non possono essere mescolati con i livelli di log sulla stessa riga; i comandi group, endgroup, e log level si escludono a vicenda. Tuttavia, i registri contenuti in un gruppo possono utilizzare i livelli di registro come di consueto.

La nidificazione dei gruppi non è supportata. Un comando group termina implicitamente qualsiasi gruppo precedente non terminato.

Ad esempio, il seguente snippet produrrà un gruppo di log con il sommario "Additional config" contenente una serie di messaggi al livello info :

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