어노테이션에 액세스

파이프라인 정의 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 환경에 추가할 수 있습니다.

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 이상인 개인 워커는 기본적으로 타임스탬프가 접두사로 붙은 로그 행을 생성합니다. 사용자는 로그 뷰어 상단의 툴바에 있는 설정 메뉴에서 옵션을 토글하여 로그 뷰어에서 이러한 타임스탬프를 표시하거나 숨길 수 있습니다.

표시되는 타임스탬프는 사용자의 브라우저 설정에 따라 현지화되며, 마우스오버 시 툴팁으로 워커로부터 받은 원시 타임스탬프 값이 제공됩니다.

로그 레벨

로그 뷰어는 로그 줄을 구문 분석하여 연관된 로그 수준을 감지하고 그에 따라 로그 소모성을 돕기 위해 로그 줄을 장식합니다. 지원되는 형식은 아래에 설명되어 있습니다.

<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 수준의 여러 메시지가 포함된 요약 '추가 구성'이 있는 로그 그룹을 출력합니다:

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