アノテーションへのアクセス

パイプライン定義 yaml ファイルのタスクからアノテーションにアクセスできます。 以下の例は、devops.cloud.ibm.com/build-number アノテーションにアクセスする方法を示しています。 そのアノテーションを環境変数として指定するには、表1にある実行アノテーションのいずれかに置き換えてください。 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"

個別の値へのアクセス

Task の個別のキー値にアクセスできます。 以下のコードスニペットでは、サンプルとして「 apikey 」というプロパティ名（セキュアプロパティを含む）と、「 environment 」というプロパティ名（テキストプロパティを含む）を使用しています。 これらのプロパティ名は、デリバリーパイプラインの [ プロパティ ] ページで設定されます。

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

すべての値へのアクセス

ConfigMap および Secret に記載されているすべてのキーと値のペアを、 Task 環境に追加することができます。 次の例でも、 event-parameters ConfigMap をボリュームとしてマウントし、トリガーイベントのヘッダーと本文にアクセスしています。 event-parameters は scm および generic のトリガーでのみ存在するため、 manual または timer のトリガーによる実行でタスクが失敗しないよう、このボリュームは「オプション」としてマークされています。

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

基本機能

ログビューアは、ANSIカラーコードとテキストスタイルをサポートし、ログコンテンツ内のURLを自動的に検出し、新しいウィンドウで開くクリック可能なリンクとして表示します。

ツールバー

ログビューアに表示されるツールバーには、以下のような追加機能がある：

• 最大化：タスクリストとランヘッダーを非表示にすることで、ログビューアで使用できる領域を増やす。 これにより、ユーザーはアプリの他の部分から気が散ることをなくし、ログの内容に集中することができる。
• ユーザー設定：ブラウザにローカルに保存され、アプリ内のすべてのログに適用されます。 詳しくは、以下のセクションを参照してください。

タイムスタンプ

IBM-マネージドワーカー、およびエージェントバージョン 0.20.5 以降のプライベートワーカーは、デフォルトでタイムスタンプを先頭に持つログ行を生成します。 ユーザーは、ログビューアのツールバーの設定メニューでオプションを切り替えることにより、ログビューアでこれらのタイムスタンプを表示または非表示にすることができる。

表示されるタイムスタンプは、ユーザーのブラウザ設定に基づいてローカライズされ、Workerから受け取った生のタイムスタンプ値は、ホバー時にツールチップとして提供されます。

ログ・レベル

ログ・ビューワは、ログ行を解析して関連するログ・レベルを検出し、ログを消費しやすくするために、それに応じてログ行を装飾する。 対応している形式は以下の通りです。

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

• timestamp は労働者によって提供される
• level の一つである debug``info``notice``warning``error trace
  • debug ログ trace はデフォルトで非表示になっています
  • 明示的な level のないログ行は、 info とみなされますが、ユーザがサポートされているログ形式を使用していない場合、UIで冗長性を避けるためにログレベルバッジは表示されません
• message はその行にあるその他の内容で、書式設定などのためのANSIコードを含むことができる。

例えば、以下のスニペットは、 warning レベルのログ行を出力する：

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

表示されるログレベルは、ログビューアツールバーの設定メニューで変更できます。

ロググループ

ログレベルに加えて、ログビューアは、ログ内の折りたたみ可能なグループもサポートする。 対応している形式は以下の通りです。

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

group 、グループの始まりを示す。 message の内容は、グループの現在の状態（展開または折りたたみなど）を示すインジケータとともに、グループのタイトル/概要として表示されます。 サマリーをクリックすると、グループの状態が切り替わる。

ログが表示されるとき、ステップがまだ進行中でない限り、グループはデフォルトで折りたたまれた状態で表示される。 ユーザーは必要に応じてグループを展開したり折りたたんだりすることができ、その状態はユーザーが別のビューに移動するまで維持される。

group、 endgroup、およびログレベルコマンドは相互に排他的である。 ただし、グループ内のログは通常通りログレベルを使用できる。

グループのネストはサポートされていません。 group コマンドは、それ以前に終了していないグループを暗黙のうちに終了させる。

例えば、以下のスニペットは、 info レベルのメッセージを多数含む、要約「Additional config」を持つロググループを出力する：

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