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

パイプライン定義 yaml ファイルのタスクからアノテーションにアクセスできます。 以下の例は、devops.cloud.ibm.com/build-number アノテーションにアクセスする方法を示しています。 このアノテーションを環境変数として提供するには、表1の実行アノテーションの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 環境に次のように追加できます。

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

基本機能

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

ツールバー

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

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

タイムスタンプ

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

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

ログ・レベル

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

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

• timestamp は労働者によって提供される
• level は,,, のいずれかである、 error warning notice info debug
  • debug ログはデフォルトで非表示
  • 明示的な 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::'