OpenShift Pipelines의 가시성

Red Hat OpenShift Pipelines 1.20

OpenShift Pipelines의 관찰 기능

Red Hat OpenShift Documentation Team

초록

이 문서에서는 OpenShift Pipelines의 가시성 기능에 대한 정보를 제공합니다.

1장. OpenShift Pipelines 관찰 기능에 Tekton 결과 사용
링크 복사

Tekton Results는 모든 파이프라인 실행 및 작업 실행에 대한 전체 정보를 보관하는 서비스입니다. 필요에 따라 PipelineRun 및 TaskRun 리소스를 정리하고 Tekton Results API 또는 opc 명령줄 유틸리티를 사용하여 YAML 매니페스트 및 로깅 정보에 액세스할 수 있습니다.

1.1. Tekton Results 개념
링크 복사

Tekton Results 아카이브는 파이프라인 실행 및 작업 실행 결과 및 레코드 형태로 실행됩니다.

실행을 완료하는 모든 PipelineRun 및 TaskRun CR(사용자 정의 리소스)에 대해 Tekton Results는 레코드를 생성합니다.

결과는 하나 또는 여러 레코드를 포함할 수 있습니다. 레코드는 항상 정확히 하나의 결과의 일부입니다.

결과적으로 파이프라인 실행에 해당하며 PipelineRun CR 자체 및 파이프라인 실행의 일부로 시작된 모든 TaskRun CR에 대한 레코드가 포함됩니다.

파이프라인 실행을 사용하지 않고 작업 실행이 직접 시작된 경우 이 작업 실행에 대한 결과가 생성됩니다. 이 결과에는 동일한 작업 실행에 대한 레코드가 포함됩니다.

각 결과에는 PipelineRun 또는 TaskRun CR이 생성된 네임스페이스와 CR의 UUID가 포함된 이름이 있습니다. 결과 이름의 형식은 < namespace_name>/results/<parent_run_uuid>입니다. 이 형식에서 < parent_run_uuid >는 파이프라인 실행 또는 직접 시작된 작업 실행의 UUUD 형식입니다.

결과 이름 예

results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed

results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed

Copy to Clipboard

Toggle word wrap

각 레코드에는 레코드가 포함된 결과의 이름과 레코드가 해당하는 PipelineRun 또는 TaskRun CR의 UUID가 포함됩니다. 결과 이름의 형식은 < namespace_name>/results/<parent_run_uuid>/results/<run_uuid > 입니다.

레코드 이름 예

results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621

results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621

Copy to Clipboard

Toggle word wrap

이 레코드에는 실행이 완료된 후 존재했던 TaskRun 또는 PipelineRun CR의 전체 YAML 매니페스트가 포함됩니다. 이 매니페스트에는 실행 사양, 실행에 지정된 주석, 실행 결과에 대한 특정 정보(예: 완료 시간 및 실행이 성공했는지 여부)가 포함되어 있습니다.

TaskRun 또는 PipelineRun CR이 있는 동안 다음 명령을 사용하여 YAML 매니페스트를 볼 수 있습니다.

oc get pipelinerun <cr_name> -o yaml

$ oc get pipelinerun <cr_name> -o yaml

Copy to Clipboard

Toggle word wrap

Tekton Results는 TaskRun 또는 PipelineRun CR이 삭제된 후 이 매니페스트를 유지하고 있으며 이를 보고 검색할 수 있도록 합니다.

완료 후 실행되는 파이프라인의 YAML 매니페스트 예

  kind: PipelineRun
  spec:
    params:
      - name: message
        value: five
    timeouts:
      pipeline: 1h0m0s
    pipelineRef:
      name: echo-pipeline
    taskRunTemplate:
      serviceAccountName: pipeline
  status:
    startTime: "2023-08-07T11:41:40Z"
    conditions:
      - type: Succeeded
        reason: Succeeded
        status: "True"
        message: 'Tasks Completed: 1 (Failed: 0, Cancelled 0), Skipped: 0'
        lastTransitionTime: "2023-08-07T11:41:49Z"
    pipelineSpec:
      tasks:
        - name: echo-task
          params:
            - name: message
              value: five
          taskRef:
            kind: Task
            name: echo-task-pipeline
      params:
        - name: message
          type: string
    completionTime: "2023-08-07T11:41:49Z"
    childReferences:
      - kind: TaskRun
        name: echo-pipeline-run-gmzrx-echo-task
        apiVersion: tekton.dev/v1
        pipelineTaskName: echo-task
  metadata:
    uid: 62c3b02e-f12b-416c-9771-c02af518f6d4
    name: echo-pipeline-run-gmzrx
    labels:
      tekton.dev/pipeline: echo-pipeline
    namespace: releasetest-js5tt
    finalizers:
      - chains.tekton.dev/pipelinerun
    generation: 2
    annotations:
      results.tekton.dev/log: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4/logs/c1e49dd8-d641-383e-b708-e3a02b6a4378
      chains.tekton.dev/signed: "true"
      results.tekton.dev/record: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4/records/62c3b02e-f12b-416c-9771-c02af518f6d4
      results.tekton.dev/result: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4
    generateName: echo-pipeline-run-
    managedFields:
      - time: "2023-08-07T11:41:39Z"
        manager: kubectl-create
        fieldsV1:
          f:spec:
            .: {}
            f:params: {}
            f:pipelineRef:
              .: {}
              f:name: {}
          f:metadata:
            f:generateName: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:40Z"
        manager: openshift-pipelines-controller
        fieldsV1:
          f:metadata:
            f:labels:
              .: {}
              f:tekton.dev/pipeline: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:49Z"
        manager: openshift-pipelines-chains-controller
        fieldsV1:
          f:metadata:
            f:finalizers:
              .: {}
              v:"chains.tekton.dev/pipelinerun": {}
            f:annotations:
              .: {}
              f:chains.tekton.dev/signed: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:49Z"
        manager: openshift-pipelines-controller
        fieldsV1:
          f:status:
            f:startTime: {}
            f:conditions: {}
            f:pipelineSpec:
              .: {}
              f:tasks: {}
              f:params: {}
            f:completionTime: {}
            f:childReferences: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
        subresource: status
      - time: "2023-08-07T11:42:15Z"
        manager: openshift-pipelines-results-watcher
        fieldsV1:
          f:metadata:
            f:annotations:
              f:results.tekton.dev/log: {}
              f:results.tekton.dev/record: {}
              f:results.tekton.dev/result: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
    resourceVersion: "126429"
    creationTimestamp: "2023-08-07T11:41:39Z"
    deletionTimestamp: "2023-08-07T11:42:23Z"
    deletionGracePeriodSeconds: 0
  apiVersion: tekton.dev/v1

  kind: PipelineRun
  spec:
    params:
      - name: message
        value: five
    timeouts:
      pipeline: 1h0m0s
    pipelineRef:
      name: echo-pipeline
    taskRunTemplate:
      serviceAccountName: pipeline
  status:
    startTime: "2023-08-07T11:41:40Z"
    conditions:
      - type: Succeeded
        reason: Succeeded
        status: "True"
        message: 'Tasks Completed: 1 (Failed: 0, Cancelled 0), Skipped: 0'
        lastTransitionTime: "2023-08-07T11:41:49Z"
    pipelineSpec:
      tasks:
        - name: echo-task
          params:
            - name: message
              value: five
          taskRef:
            kind: Task
            name: echo-task-pipeline
      params:
        - name: message
          type: string
    completionTime: "2023-08-07T11:41:49Z"
    childReferences:
      - kind: TaskRun
        name: echo-pipeline-run-gmzrx-echo-task
        apiVersion: tekton.dev/v1
        pipelineTaskName: echo-task
  metadata:
    uid: 62c3b02e-f12b-416c-9771-c02af518f6d4
    name: echo-pipeline-run-gmzrx
    labels:
      tekton.dev/pipeline: echo-pipeline
    namespace: releasetest-js5tt
    finalizers:
      - chains.tekton.dev/pipelinerun
    generation: 2
    annotations:
      results.tekton.dev/log: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4/logs/c1e49dd8-d641-383e-b708-e3a02b6a4378
      chains.tekton.dev/signed: "true"
      results.tekton.dev/record: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4/records/62c3b02e-f12b-416c-9771-c02af518f6d4
      results.tekton.dev/result: releasetest-js5tt/results/62c3b02e-f12b-416c-9771-c02af518f6d4
    generateName: echo-pipeline-run-
    managedFields:
      - time: "2023-08-07T11:41:39Z"
        manager: kubectl-create
        fieldsV1:
          f:spec:
            .: {}
            f:params: {}
            f:pipelineRef:
              .: {}
              f:name: {}
          f:metadata:
            f:generateName: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:40Z"
        manager: openshift-pipelines-controller
        fieldsV1:
          f:metadata:
            f:labels:
              .: {}
              f:tekton.dev/pipeline: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:49Z"
        manager: openshift-pipelines-chains-controller
        fieldsV1:
          f:metadata:
            f:finalizers:
              .: {}
              v:"chains.tekton.dev/pipelinerun": {}
            f:annotations:
              .: {}
              f:chains.tekton.dev/signed: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
      - time: "2023-08-07T11:41:49Z"
        manager: openshift-pipelines-controller
        fieldsV1:
          f:status:
            f:startTime: {}
            f:conditions: {}
            f:pipelineSpec:
              .: {}
              f:tasks: {}
              f:params: {}
            f:completionTime: {}
            f:childReferences: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
        subresource: status
      - time: "2023-08-07T11:42:15Z"
        manager: openshift-pipelines-results-watcher
        fieldsV1:
          f:metadata:
            f:annotations:
              f:results.tekton.dev/log: {}
              f:results.tekton.dev/record: {}
              f:results.tekton.dev/result: {}
        operation: Update
        apiVersion: tekton.dev/v1
        fieldsType: FieldsV1
    resourceVersion: "126429"
    creationTimestamp: "2023-08-07T11:41:39Z"
    deletionTimestamp: "2023-08-07T11:42:23Z"
    deletionGracePeriodSeconds: 0
  apiVersion: tekton.dev/v1

Copy to Clipboard

Toggle word wrap

모든 결과 및 레코드에 해당 이름으로 액세스할 수 있습니다. CEL(Common Expression Language) 쿼리를 사용하여 YAML 매니페스트를 포함하여 포함된 정보로 결과 및 레코드를 검색할 수도 있습니다.

파이프라인 또는 작업의 일부로 실행된 모든 툴의 로깅 정보를 LokiStack으로 쉽게 전달하도록 Tekton Results를 구성할 수 있습니다. 그런 다음 Tekton Results 레코드와 연결된 작업 실행 정보를 로깅하기 위해 Tekton Results를 쿼리할 수 있습니다.

파이프라인 실행 및 작업 실행 이름으로 결과 및 로그를 쿼리할 수도 있습니다.

1.2. Tekton 결과 구성
링크 복사

OpenShift Pipelines를 설치한 후 Tekton 결과는 기본적으로 활성화됩니다.

그러나 파이프라인 실행 및 작업 실행에 대한 로깅 정보를 저장하고 액세스하려면 이 정보를 LokiStack으로 전달하도록 구성해야 합니다.

필요한 경우 Tekton 결과에 대한 추가 구성을 완료할 수 있습니다.

1.2.1. 로깅 정보를 위한 LokiStack 전달 구성
링크 복사

Tekton Results를 사용하여 작업 실행에 대한 로깅 정보를 쿼리하려면 OpenShift Container Platform 클러스터에 LokiStack 및 OpenShift Logging을 설치하고 LokiStack으로 로깅 정보 전달을 구성해야 합니다.

로깅 정보에 대해 LokiStack 전달을 구성하지 않으면 Tekton Results는 이 정보를 저장하거나 명령줄 인터페이스 또는 API에서 제공하지 않습니다.

사전 요구 사항

OpenShift CLI(oc) 유틸리티를 설치했습니다.
클러스터 관리자로 OpenShift Container Platform 클러스터에 로그인되어 있습니다.

프로세스

LokiStack 전달을 구성하려면 다음 단계를 완료합니다.

OpenShift Container Platform 클러스터에서 Loki Operator를 사용하여 LokiStack을 설치하고 OpenShift Logging Operator도 설치합니다.

OpenShift Logging 버전 6 또는 버전 5를 설치할지 여부에 따라 다음 YAML 매니페스트 중 하나를 사용하여 ClusterLogForwarder 사용자 정의 리소스(CR)에 대한 ClusterLogForwarder.yaml 매니페스트 파일을 생성합니다.

OpenShift Logging 버전 6을 설치한 경우 ClusterLogForwarder CR의 YAML 매니페스트

apiVersion: observability.openshift.io/v1
kind: ClusterLogForwarder
metadata:
  name: collector
  namespace: openshift-logging
spec:
  inputs:
  - application:
      selector:
        matchExpressions:
          - key: app.kubernetes.io/managed-by
            operator: In
            values: ["tekton-pipelines", "pipelinesascode.tekton.dev"]
    name: only-tekton
    type: application
  managementState: Managed
  outputs:
  - lokiStack:
      labelKeys:
        application:
          ignoreGlobal: true
          labelKeys:
          - log_type
          - kubernetes.namespace_name
          - openshift_cluster_id
      authentication:
        token:
          from: serviceAccount
      target:
        name: logging-loki
        namespace: openshift-logging
    name: default-lokistack
    tls:
      ca:
        configMapName: openshift-service-ca.crt
        key: service-ca.crt
    type: lokiStack
  pipelines:
  - inputRefs:
    - only-tekton
    name: default-logstore
    outputRefs:
    - default-lokistack
  serviceAccount:
    name: collector

apiVersion: observability.openshift.io/v1
kind: ClusterLogForwarder
metadata:
  name: collector
  namespace: openshift-logging
spec:
  inputs:
  - application:
      selector:
        matchExpressions:
          - key: app.kubernetes.io/managed-by
            operator: In
            values: ["tekton-pipelines", "pipelinesascode.tekton.dev"]
    name: only-tekton
    type: application
  managementState: Managed
  outputs:
  - lokiStack:
      labelKeys:
        application:
          ignoreGlobal: true
          labelKeys:
          - log_type
          - kubernetes.namespace_name
          - openshift_cluster_id
      authentication:
        token:
          from: serviceAccount
      target:
        name: logging-loki
        namespace: openshift-logging
    name: default-lokistack
    tls:
      ca:
        configMapName: openshift-service-ca.crt
        key: service-ca.crt
    type: lokiStack
  pipelines:
  - inputRefs:
    - only-tekton
    name: default-logstore
    outputRefs:
    - default-lokistack
  serviceAccount:
    name: collector

Copy to Clipboard

Toggle word wrap

OpenShift Logging 버전 5를 설치한 경우 ClusterLogForwarder CR의 YAML 매니페스트

apiVersion: "logging.openshift.io/v1"
kind: ClusterLogForwarder
metadata:
  name: instance
  namespace: openshift-logging
spec:
  inputs:
  - name: only-tekton
    application:
      selector:
        matchLabels:
          app.kubernetes.io/managed-by: tekton-pipelines
  pipelines:
    - name: enable-default-log-store
      inputRefs: [ only-tekton ]
      outputRefs: [ default ]

apiVersion: "logging.openshift.io/v1"
kind: ClusterLogForwarder
metadata:
  name: instance
  namespace: openshift-logging
spec:
  inputs:
  - name: only-tekton
    application:
      selector:
        matchLabels:
          app.kubernetes.io/managed-by: tekton-pipelines
  pipelines:
    - name: enable-default-log-store
      inputRefs: [ only-tekton ]
      outputRefs: [ default ]

Copy to Clipboard

Toggle word wrap

다음 명령을 입력하여 openshift-logging 네임스페이스에서 ClusterLogForwarder CR을 생성합니다.
```
oc apply -n openshift-logging ClusterLogForwarder.yaml
```
```
$ oc apply -n openshift-logging ClusterLogForwarder.yaml
```
Copy to Clipboard Toggle word wrap

다음 명령을 사용하여 TektonConfig CR(사용자 정의 리소스)을 편집합니다.

oc edit TektonConfig config

$ oc edit TektonConfig config

Copy to Clipboard

Toggle word wrap

결과 사양을 다음과 같이 변경합니다.

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    loki_stack_name: logging-loki 
    loki_stack_namespace: openshift-logging

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    loki_stack_name: logging-loki


    loki_stack_namespace: openshift-logging

Copy to Clipboard

Toggle word wrap

1: LokiStack CR의 이름, 일반적으로 logging-loki.
2: LokiStack이 배포된 네임스페이스의 이름(일반적으로 openshift-logging ).

1.2.2. 외부 데이터베이스 서버 구성
링크 복사

Tekton 결과는 PostgreSQL 데이터베이스를 사용하여 데이터를 저장합니다. 기본적으로 설치에는 내부 PostgreSQL 인스턴스가 포함됩니다. 배포에 이미 존재하는 외부 PostgreSQL 서버를 사용하도록 설치를 구성할 수 있습니다.

프로세스

다음 명령을 입력하여 PostgreSQL 서버에 연결하기 위한 인증 정보를 사용하여 시크릿을 생성합니다.

oc create secret generic tekton-results-postgres \
  --namespace=openshift-pipelines \
  --from-literal=POSTGRES_USER=<user> \
  --from-literal=POSTGRES_PASSWORD=<password>

$ oc create secret generic tekton-results-postgres \
  --namespace=openshift-pipelines \
  --from-literal=POSTGRES_USER=<user> \
  --from-literal=POSTGRES_PASSWORD=<password>

Copy to Clipboard

Toggle word wrap

다음 명령을 사용하여 TektonConfig CR(사용자 정의 리소스)을 편집합니다.

oc edit TektonConfig config

$ oc edit TektonConfig config

Copy to Clipboard

Toggle word wrap

결과 사양을 다음과 같이 변경합니다.

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    is_external_db: true
    db_host: database.example.com 
    db_port: 5342

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    is_external_db: true
    db_host: database.example.com


    db_port: 5342

Copy to Clipboard

Toggle word wrap

1: PostgreSQL 서버의 호스트 이름을 제공합니다.
2: PostgreSQL 서버의 포트 번호를 제공합니다.

1.2.3. Tekton 결과에 대한 보존 정책 구성
링크 복사

기본적으로 Tekton Results는 파이프라인 실행, 작업 실행, 이벤트 및 로그를 무기한 저장합니다. 이로 인해 스토리지 리소스를 불필요하게 사용하지 않고 데이터베이스 성능에 영향을 미칠 수 있습니다.

클러스터 수준에서 Tekton 결과에 대한 보존 정책을 구성하여 이전 결과 및 관련 레코드 및 로그를 제거할 수 있습니다.

프로세스

다음 명령을 사용하여 TektonConfig CR(사용자 정의 리소스)을 편집합니다.

oc edit TektonConfig config

$ oc edit TektonConfig config

Copy to Clipboard

Toggle word wrap

결과 사양을 다음과 같이 변경합니다.

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    options:
      configMaps:
        config-results-retention-policy:
          data:
            runAt: "3 5 * * 0" 
            maxRetention: "30"

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  result:
    options:
      configMaps:
        config-results-retention-policy:
          data:
            runAt: "3 5 * * 0"


            maxRetention: "30"

Copy to Clipboard

Toggle word wrap

1: 데이터베이스에서 정리 작업을 실행할 때 cron 형식으로 지정합니다. 이 예제에서는 매주 일요일 오전 5:03에 작업을 실행합니다.
2: 데이터베이스에 데이터를 보관할 일 수를 지정합니다. 이 예에서는 30일 동안 데이터를 유지합니다.

1.3. 결과 및 레코드에 대한 Tekton 결과 쿼리
링크 복사

opc 명령줄 유틸리티를 사용하여 결과 및 레코드에 대한 Tekton 결과를 쿼리할 수 있습니다. opc 명령줄 유틸리티를 설치하려면 tkn 명령줄 유틸리티에 대한 패키지를 설치합니다. 이 패키지 설치에 대한 자세한 내용은 tkn 설치를 참조하십시오.

레코드 이름과 결과를 사용하여 해당 레코드에서 데이터를 검색할 수 있습니다.

CEL(Common Expression Language) 쿼리를 사용하여 결과 및 레코드를 검색할 수 있습니다. 이러한 검색에는 결과 또는 레코드의 UUID가 표시됩니다. 제공된 예제를 사용하여 공통 검색 유형에 대한 쿼리를 생성할 수 있습니다. 참조 정보를 사용하여 다른 쿼리를 생성할 수도 있습니다.

1.3.1. Tekton 결과 쿼리를 위한 opc 유틸리티 환경 준비
링크 복사

Tekton Results를 쿼리하려면 먼저 opc 유틸리티에 대한 환경을 준비해야 합니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
OpenShift CLI(oc)를 사용하여 OpenShift Container Platform 클러스터에 로그온했습니다.

프로세스

다음 명령을 입력하여 RESULTS_API 환경 변수를 Tekton Results API의 경로로 설정합니다.

export RESULTS_API=$(oc get route tekton-results-api-service -n openshift-pipelines --no-headers -o custom-columns=":spec.host"):443

$ export RESULTS_API=$(oc get route tekton-results-api-service -n openshift-pipelines --no-headers -o custom-columns=":spec.host"):443

Copy to Clipboard

Toggle word wrap

다음 명령을 입력하여 Tekton Results API에 대한 인증 토큰을 생성합니다.
```
oc create token <service_account>
```
```
$ oc create token <service_account>
```
Copy to Clipboard Toggle word wrap
& lt;service_account >를 OpenShift Pipelines가 파이프라인 실행 및 작업이 실행된 네임스페이스에 대한 읽기 액세스 권한이 있는 OpenShift Container Platform 서비스 계정의 이름으로 바꿉니다.
이 명령이 출력하는 문자열을 저장합니다.
선택 사항: Tekton Results API를 사용하여 자동 인증을 위해 ~/.config/tkn/results.yaml 파일을 생성합니다. 파일에는 다음 내용이 포함되어야 합니다.
```
address: <tekton_results_route> 
token: <authentication_token> 
ssl:
   roots_file_path: /home/example/cert.pem 
   server_name_override: tekton-results-api-service.openshift-pipelines.svc.cluster.local 
 service_account:
   namespace: service_acc_1 
   name: service_acc_1 
```
```
address: <tekton_results_route> 
```
1
```
token: <authentication_token> 
```
2
```
ssl:
   roots_file_path: /home/example/cert.pem 
```
3
```
   server_name_override: tekton-results-api-service.openshift-pipelines.svc.cluster.local 
```
4
```
 service_account:
   namespace: service_acc_1 
```
5
```
   name: service_acc_1 
```
6
Copy to Clipboard Toggle word wrap
1
Tekton Results API의 경로입니다. RESULTS_API 에 설정한 것과 동일한 값을 사용합니다.
2
oc create token 명령으로 생성된 인증 토큰입니다. 이 토큰을 제공하는 경우 service_account 설정을 재정의하고 opc 는 이 토큰을 사용하여 인증합니다.
3
API 엔드포인트에 대해 구성한 SSL 인증서가 있는 파일의 위치입니다.
4
OpenShift Pipelines에 대한 사용자 정의 대상 네임스페이스를 구성한 경우 openshift-pipelines 를 이 네임스페이스의 이름으로 교체합니다.
5 6
Tekton Results API를 사용하여 인증하는 서비스 계정의 이름입니다. 인증 토큰을 제공한 경우 service_account 매개변수를 제공할 필요가 없습니다.
또는 ~/.config/tkn/results.yaml 파일을 생성하지 않으면 --authtoken 옵션을 사용하여 각 opc 명령에 토큰을 전달할 수 있습니다.

1.3.2. 이름으로 결과 및 레코드 쿼리
링크 복사

해당 이름을 사용하여 결과 및 레코드를 나열하고 쿼리할 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치하고 Tekton 결과를 쿼리할 수 있는 환경을 준비합니다.
jq CLI를 설치하셨습니다.
로깅 정보를 쿼리하려면 LokiStack으로 로그 전달을 구성했습니다.

프로세스

네임스페이스에서 생성된 파이프라인 실행 및 작업 실행에 해당하는 모든 결과의 이름을 나열합니다. 다음 명령을 실행합니다.

opc results result list --addr ${RESULTS_API} <namespace_name>

$ opc results result list --addr ${RESULTS_API} <namespace_name>

Copy to Clipboard

Toggle word wrap

명령 예

opc results result list --addr ${RESULTS_API} results-testing

$ opc results result list --addr ${RESULTS_API} results-testing

Copy to Clipboard

Toggle word wrap

출력 예

Name                                                          Start                                   Update
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed  2023-06-29 02:49:53 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/ad7eb937-90cc-4510-8380-defe51ad793f  2023-06-29 02:49:38 +0530 IST           2023-06-29 02:50:06 +0530 IST
results-testing/results/d064ce6e-d851-4b4e-8db4-7605a23671e4  2023-06-29 02:49:45 +0530 IST           2023-06-29 02:49:56 +0530 IST

Name                                                          Start                                   Update
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed  2023-06-29 02:49:53 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/ad7eb937-90cc-4510-8380-defe51ad793f  2023-06-29 02:49:38 +0530 IST           2023-06-29 02:50:06 +0530 IST
results-testing/results/d064ce6e-d851-4b4e-8db4-7605a23671e4  2023-06-29 02:49:45 +0530 IST           2023-06-29 02:49:56 +0530 IST

Copy to Clipboard

Toggle word wrap

다음 명령을 입력하여 결과에서 모든 레코드 이름을 나열합니다.

opc results records list --addr ${RESULTS_API} <result_name>

$ opc results records list --addr ${RESULTS_API} <result_name>

Copy to Clipboard

Toggle word wrap

명령 예

opc results records list --addr ${RESULTS_API} results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed

$ opc results records list --addr ${RESULTS_API} results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed

Copy to Clipboard

Toggle word wrap

출력 예

Name                                                                                                   Type                                    Start                                   Update
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621  tekton.dev/v1.TaskRun              2023-06-29 02:49:53 +0530 IST           2023-06-29 02:49:57 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/5de23a76-a12b-3a72-8a6a-4f15a3110a3e  results.tekton.dev/v1alpha2.Log         2023-06-29 02:49:57 +0530 IST           2023-06-29 02:49:57 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/57ce92f9-9bf8-3a0a-aefb-dc20c3e2862d  results.tekton.dev/v1alpha2.Log         2023-06-29 02:50:05 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9a0c21a-f826-42ab-a9d7-a03bcefed4fd  tekton.dev/v1.TaskRun              2023-06-29 02:49:57 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/04e2fbf2-8653-405f-bc42-a262bcf02bed  tekton.dev/v1.PipelineRun          2023-06-29 02:49:53 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e6eea2f9-ec80-388c-9982-74a018a548e4  results.tekton.dev/v1alpha2.Log         2023-06-29 02:50:05 +0530 IST           2023-06-29 02:50:05 +0530 IST

Name                                                                                                   Type                                    Start                                   Update
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621  tekton.dev/v1.TaskRun              2023-06-29 02:49:53 +0530 IST           2023-06-29 02:49:57 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/5de23a76-a12b-3a72-8a6a-4f15a3110a3e  results.tekton.dev/v1alpha2.Log         2023-06-29 02:49:57 +0530 IST           2023-06-29 02:49:57 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/57ce92f9-9bf8-3a0a-aefb-dc20c3e2862d  results.tekton.dev/v1alpha2.Log         2023-06-29 02:50:05 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9a0c21a-f826-42ab-a9d7-a03bcefed4fd  tekton.dev/v1.TaskRun              2023-06-29 02:49:57 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/04e2fbf2-8653-405f-bc42-a262bcf02bed  tekton.dev/v1.PipelineRun          2023-06-29 02:49:53 +0530 IST           2023-06-29 02:50:05 +0530 IST
results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e6eea2f9-ec80-388c-9982-74a018a548e4  results.tekton.dev/v1alpha2.Log         2023-06-29 02:50:05 +0530 IST           2023-06-29 02:50:05 +0530 IST

Copy to Clipboard

Toggle word wrap

다음 명령을 입력하여 레코드에서 파이프라인 실행 또는 작업 실행에 대한 YAML 매니페스트를 검색합니다.

opc results records get --addr ${RESULTS_API} <record_name> \
  | jq -r .data.value | base64 -d | \
  xargs -0 python3 -c 'import sys, yaml, json; j=json.loads(sys.argv[1]); print(yaml.safe_dump(j))'

$ opc results records get --addr ${RESULTS_API} <record_name> \
  | jq -r .data.value | base64 -d | \
  xargs -0 python3 -c 'import sys, yaml, json; j=json.loads(sys.argv[1]); print(yaml.safe_dump(j))'

Copy to Clipboard

Toggle word wrap

명령 예

opc results records get --addr ${RESULTS_API} \
  results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621 | \
  jq -r .data.value | base64 -d | \
  xargs -0 python3 -c 'import sys, yaml, json; j=json.loads(sys.argv[1]); print(yaml.safe_dump(j))'

$ opc results records get --addr ${RESULTS_API} \
  results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/records/e9c736db-5665-441f-922f-7c1d65c9d621 | \
  jq -r .data.value | base64 -d | \
  xargs -0 python3 -c 'import sys, yaml, json; j=json.loads(sys.argv[1]); print(yaml.safe_dump(j))'

Copy to Clipboard

Toggle word wrap

선택 사항: 로그 레코드 이름을 사용하여 레코드에서 실행되는 작업의 로깅 정보를 검색합니다. 로그 레코드 이름을 가져오려면 레코드를 레코드 이름에 로그 로 바꿉니다. 다음 명령을 실행합니다.

opc results logs get --addr ${RESULTS_API} <log_record_name> | jq -r .data | base64 -d

$ opc results logs get --addr ${RESULTS_API} <log_record_name> | jq -r .data | base64 -d

Copy to Clipboard

Toggle word wrap

명령 예

opc results logs get --addr ${RESULTS_API} \
  results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/logs/e9c736db-5665-441f-922f-7c1d65c9d621 | \
  jq -r .data | base64 -d

$ opc results logs get --addr ${RESULTS_API} \
  results-testing/results/04e2fbf2-8653-405f-bc42-a262bcf02bed/logs/e9c736db-5665-441f-922f-7c1d65c9d621 | \
  jq -r .data | base64 -d

Copy to Clipboard

Toggle word wrap

1.3.3. 결과 검색
링크 복사

CEL(Common Expression Language) 쿼리를 사용하여 결과를 검색할 수 있습니다. 예를 들어 성공하지 못한 파이프라인 실행에 대한 결과를 찾을 수 있습니다. 그러나 관련 정보의 대부분은 결과 개체에 포함되지 않습니다; 이름, 완료 시간 및 기타 데이터로 검색하고 레코드를 검색합니다.

사전 요구 사항

opc 유틸리티를 설치하고 Tekton 결과를 쿼리할 수 있는 환경을 준비합니다.

프로세스

다음 명령을 입력하여 CEL 쿼리를 사용하여 결과를 검색합니다.

opc results result list --addr ${RESULTS_API} --filter="<cel_query>" <namespace-name>

$ opc results result list --addr ${RESULTS_API} --filter="<cel_query>" <namespace-name>

Copy to Clipboard

Toggle word wrap

& lt;namespace_name >을 파이프라인 실행 또는 작업 실행이 생성된 네임스페이스로 바꿉니다.

Expand

표 1.1. 결과에 대한 CEL 쿼리 예
목적	CEL 쿼리
실패한 모든 실행의 결과	`!(summary.status == SUCCESS)`
모든 파이프라인이 주석 `ann1` 및 `ann2`가 포함된 결과	`summary.annotations.contains('ann1') && summary.annotations.contains('ann2') && summary.type=='PIPELINE_RUN'`

1.3.4. 레코드 검색
링크 복사

CEL(Common Expression Language) 쿼리를 사용하여 레코드를 검색할 수 있습니다. 각 레코드에는 파이프라인 실행 또는 작업 실행에 대한 전체 YAML 정보가 포함되어 있으므로 다양한 기준으로 레코드를 찾을 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치하고 Tekton 결과를 쿼리할 수 있는 환경을 준비합니다.

프로세스

다음 명령을 입력하여 CEL 쿼리를 사용하여 레코드를 검색합니다.
```
opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <namespace_name>/result/-
```
```
$ opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <namespace_name>/result/-
```
Copy to Clipboard Toggle word wrap
& lt;namespace_name >을 파이프라인 실행 또는 작업 실행이 생성된 네임스페이스로 바꿉니다. 또는 다음 명령을 입력하여 단일 결과 내에서 레코드를 검색합니다.
```
opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <result_name>
```
```
$ opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <result_name>
```
Copy to Clipboard Toggle word wrap
& lt;result_name >을 결과의 전체 이름으로 바꿉니다.

Expand

표 1.2. 레코드에 대한 CEL 쿼리의 예
목적	CEL 쿼리
실패한 모든 작업 실행 또는 파이프라인 실행 기록	`!(data.status.conditions[0].status == 'True')`
`TaskRun` 또는 `PipelineRun` CR(사용자 정의 리소스)의 이름이 `run1`인 레코드	`data.metadata.name == 'run1'`
`run1`이라는 `PipelineRun` CR에 의해 시작된 모든 작업 실행에 대한 레코드	`data_type == 'TASK_RUN' && data.metadata.labels['tekton.dev/pipelineRun'] == 'run1'`
`pipeline1`이라는 `Pipeline` CR에서 생성된 모든 파이프라인 실행 및 작업 실행 기록	`data.metadata.labels['tekton.dev/pipeline'] == 'pipeline1'`
`pipeline1`이라는 `Pipeline` CR에서 생성된 모든 파이프라인 실행 레코드	`data.metadata.labels['tekton.dev/pipeline'] == 'pipeline1' && data_type == 'PIPELINE_RUN'`
`TaskRun` CR 이름이 `hello`로 표시된 모든 작업 실행 레코드	`data.metadata.name.startsWith('hello') && data_type=='TASK_RUN'`
완료하는 데 5분 이상 걸리는 모든 파이프라인 실행 레코드	`data.status.completionTime - data.status.startTime > duration('5m') && data_type == 'PIPELINE_RUN'`
2023년 10월 7일에 완료된 모든 파이프라인 실행 및 작업 실행 기록	`data.status.completionTime.getDate() == 7 && data.status.completionTime.getMonth() == 10 && data.status.completionTime.getFullYear() == 2023`
세 개 이상의 작업을 포함하는 모든 파이프라인 실행 레코드	`size(data.status.pipelineSpec.tasks) >= 3 && data_type == 'PIPELINE_RUN'`
`ann1`이 포함된 주석이 있는 모든 파이프라인 실행 레코드	`data.metadata.annotations.contains('ann1') && data_type == 'PIPELINE_RUN'`
`ann1` 이 포함된 주석과 `PipelineRun` CR의 이름이 `hello`로 시작된 모든 파이프라인 실행 레코드	`data.metadata.annotations.contains('ann1') && data.metadata.name.startsWith('hello') && data_type == 'PIPELINE_RUN'`

1.3.5. 결과 검색에 대한 참조 정보
링크 복사

결과를 위해 CEL(Common Expression Language) 쿼리에서 다음 필드를 사용할 수 있습니다.

Expand

표 1.3. 결과에 대해 CEL 쿼리에서 사용할 수 있는 필드
EL 필드	설명
`상위`	`PipelineRun` 또는 `TaskRun` CR(사용자 정의 리소스)이 생성된 네임스페이스입니다.
`uid`	결과에 대한 고유 식별자입니다.
`annotations`	`PipelineRun` 또는 `TaskRun` CR에 추가된 주석입니다.
`summary`	결과에 대한 요약입니다.
`create_time`	결과 생성 시간입니다.
`update_time`	결과 마지막 업데이트 시간입니다.

summary.status 필드를 사용하여 파이프라인 실행이 성공했는지 확인할 수 있습니다. 이 필드에는 다음과 같은 값이 있을 수 있습니다.

알 수 없음
SUCCESS
FAILURE
TIMEOUT
취소됨

참고

이 필드의 값을 제공하기 위해 " 또는 ' 와 같은 인용 문자를 사용하지 마십시오.

1.3.6. 레코드 검색에 대한 참조 정보
링크 복사

CEL(Common Expression Language) 쿼리에서 다음 필드를 사용할 수 있습니다.

Expand

표 1.4. CEL 쿼리에서 레코드에 사용할 수 있는 필드
EL 필드	설명	값
`name`	레코드 이름
`data_type`	레코드 유형 식별자	Tekton `.dev/v1.TaskRun` 또는 `TASK_RUNtekton.dev/v1.PipelineRun` 또는 `PIPELINE_RUNresults.tekton.dev/v1alpha2.Log`
`data`	작업 실행 또는 파이프라인 실행에 대한 YAML 데이터입니다. 로그 레코드에서 이 필드에는 로깅 출력이 포함됩니다.

data 필드에 작업 실행 또는 파이프라인 실행에 대한 전체 YAML 데이터가 포함되어 있으므로 CEL 쿼리에서 이 데이터의 모든 요소를 사용할 수 있습니다. 예를 들어 data.status.completionTime 에는 작업 실행 또는 파이프라인 실행의 완료 시간이 포함됩니다.

1.4. 파이프라인 실행 및 작업 실행 이름으로 결과 및 로그 쿼리
링크 복사

opc 명령줄 유틸리티를 사용하여 파이프라인 실행 및 작업 목록에 대한 Tekton Results를 쿼리한 다음 파이프라인 실행 및 작업 실행 이름을 사용하여 매니페스트 및 로그 정보를 검색할 수 있습니다.

이 접근 방식에서는 결과 및 레코드에 대한 쿼리와 비교하여 opc 명령줄 유틸리티의 다른 구성이 필요합니다.

중요

파이프라인 실행 및 작업 실행의 이름으로 결과 및 로그를 쿼리하는 것은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

1.4.1. 파이프라인 실행 및 작업 실행 이름으로 결과를 쿼리하기 위한 opc 유틸리티 구성
링크 복사

파이프라인 실행 및 작업 실행 이름을 통해 Tekton 결과에서 결과를 쿼리하려면 먼저 opc 유틸리티를 구성해야 합니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
OpenShift CLI(oc)를 사용하여 OpenShift Container Platform 클러스터에 로그온했습니다.

프로세스

다음 명령을 입력하여 Tekton Results API에 대한 인증 토큰을 생성합니다.
```
oc create token <service_account>
```
```
$ oc create token <service_account>
```
Copy to Clipboard Toggle word wrap
& lt;service_account >를 OpenShift Pipelines가 파이프라인 실행 및 작업이 실행된 네임스페이스에 대한 읽기 액세스 권한이 있는 OpenShift Container Platform 서비스 계정의 이름으로 바꿉니다.
이 명령이 출력하는 문자열을 저장합니다.
다음 단계 중 하나를 완료합니다.
- 다음 명령을 입력하여 opc 유틸리티를 대화식으로 구성합니다.
  $ opc results config set
  Copy to Clipboard Toggle word wrap
  유틸리티가 표시되는 프롬프트에 응답합니다. 토큰 의 경우 생성한 인증 토큰을 입력합니다.
- 다음 명령을 입력하여 명령에서 opc 유틸리티를 구성합니다.
  $ opc results config set --host="https://tekton-results.example.com" --token="<token>"
  Copy to Clipboard Toggle word wrap
  호스트 이름을 Tekton Results 경로의 정규화된 도메인 이름으로 바꿉니다. & lt;token >을 생성한 인증 토큰으로 바꿉니다.

검증

다음 명령을 입력하여 opc 유틸리티에 대해 설정한 구성을 볼 수 있습니다.

opc results config view

$ opc results config view

Copy to Clipboard

Toggle word wrap

출력 예

api-path: ""
apiVersion: results.tekton.dev/v1alpha2
host: https://tekton-results.openshiftapps.com
insecure-skip-tls-verify: "true"
kind: Client
token: sha256~xyz

api-path: ""
apiVersion: results.tekton.dev/v1alpha2
host: https://tekton-results.openshiftapps.com
insecure-skip-tls-verify: "true"
kind: Client
token: sha256~xyz

Copy to Clipboard

Toggle word wrap

1.4.2. 파이프라인 실행 이름 및 식별자 목록 보기
링크 복사

opc 유틸리티를 사용하여 네임스페이스에서 파이프라인 실행의 이름 및 식별자 목록을 볼 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
파이프라인 실행 및 작업 실행 이름을 통해 Tekton 결과에서 결과를 쿼리하도록 opc 유틸리티를 구성했습니다.

프로세스

파이프라인 실행을 보려면 다음 명령을 사용합니다.
- 지정된 네임스페이스의 모든 파이프라인 실행을 보려면 다음 명령을 입력합니다.
  $ opc results pipelinerun list -n <namespace_name>
  Copy to Clipboard Toggle word wrap
  선택적으로 --limit 명령줄 옵션을 지정합니다(예: --limit=10 ). 이 설정을 사용하면 opc 명령이 파이프라인 실행 이름을 포함하는 지정된 행 수를 표시한 다음 종료합니다. --single-page=false 명령줄 옵션을 추가하면 명령은 지정된 행 수를 표시한 다음 계속 또는 종료하라는 메시지를 표시합니다.
  선택적으로 --labels 명령줄 옵션을 지정합니다(예: --labels="app.kubernetes.io/name=test-app, app.kubernetes.io/component=database ). 이 설정을 사용하면 목록에 지정된 라벨 또는 주석이 있는 파이프라인 실행만 포함됩니다.
  opc 결과 pipelinerun list 명령의 출력 예
  NAME UID STARTED DURATION STATUS openshift-pipelines-main-release-tests-zscq8 78515e3a-8e20-43e8-a064-d2442c2ae845 1 week ago 5s Failed(CouldntGetPipeline) openshift-pipelines-main-release-tests-zrgv6 14226144-2d08-440d-a600-d602ca46cdf6 1 week ago 26m13s Failed openshift-pipelines-main-release-tests-jdc24 e34daea2-66fb-4c7d-9d4b-d9d82a07b6cd 1 week ago 5s Failed(CouldntGetPipeline) openshift-pipelines-main-release-tests-6zj7f 9b3e5d68-70ab-4c23-8872-e7ad7121e60b 1 week ago 5s Failed(CouldntGetPipeline) openshift-pipelines-main-release-tests-kkk9t 2fd28c48-388b-4e6a-9ec3-2bcd9dedebc3 1 week ago 5s Failed(CouldntGetPipeline)
  
  Copy to Clipboard Toggle word wrap
- 지정된 이름이 지정된 파이프라인과 관련된 파이프라인 실행을 보려면 다음 명령을 입력합니다.
  $ opc results pipelinerun list <pipeline_name> -n <namespace_name>
  Copy to Clipboard Toggle word wrap
  명령은 <pipeline _name>을 포함하는 이름이 있는 파이프라인의 모든 파이프라인 실행을 나열합니다. 예를 들어 build를 지정하는 경우 명령은 build,build_123 또는 enhanced build 라는 파이프라인과 관련된 모든 파이프라인을 표시합니다.
  선택적으로 --limit 명령줄 옵션을 지정합니다(예: --limit=10 ). 이 설정을 사용하면 opc 명령이 파이프라인 실행 이름을 포함하는 지정된 행 수를 표시한 다음 종료합니다. --single-page=false 명령줄 옵션을 추가하면 명령은 지정된 행 수를 표시한 다음 계속 또는 종료하라는 메시지를 표시합니다.

1.4.3. 작업 실행 이름 및 식별자 목록 보기
링크 복사

opc 유틸리티를 사용하여 네임스페이스 또는 파이프라인 dun과 연결된 작업 실행에서 작업 실행의 이름 및 식별자 목록을 볼 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
파이프라인 실행 및 작업 실행 이름을 통해 Tekton 결과에서 결과를 쿼리하도록 opc 유틸리티를 구성했습니다.

프로세스

네임스페이스에서 모든 작업 실행 목록을 보려면 다음 명령을 입력합니다.

opc results taskrun list -n <namespace_name>

$ opc results taskrun list -n <namespace_name>

Copy to Clipboard

Toggle word wrap

선택적으로 --limit 명령줄 옵션을 지정합니다(예: --limit=10 ). 이 설정을 사용하면 opc 명령이 파이프라인 실행 이름을 포함하는 지정된 행 수를 표시한 다음 종료합니다. --single-page=false 명령줄 옵션을 추가하면 명령은 지정된 행 수를 표시한 다음 계속 또는 종료하라는 메시지를 표시합니다.

선택적으로 --labels 매개변수를 지정합니다(예: --labels="app.kubernetes.io/name=test-app, app.kubernetes.io/component=database ). 이 설정을 사용하면 목록에 지정된 라벨 또는 주석이 있는 작업 실행만 포함됩니다.

네임스페이스의 opc 결과 pipelinerun list 명령의 출력 예

NAME                                           UID                                    STARTED      DURATION   STATUS
openshift-pipelines-main-release-tests-zrgv6-e2e-test             10d6952f-b926-4e4b-a976-519867969ce7   16d ago   12m41s     Failed
openshift-pipelines-main-release-tests-zrgv6-deploy-operator      ab41b63b-16ec-4a32-8b95-f2678eb5c945   16d ago   22s        Succeeded
openshift-pipelines-main-release-tests-zrgv6-provision-cluster    b374df00-5132-4633-91df-3259670756b3   16d ago   12m30s     Succeeded
operator-main-index-4-18-on-pull-request-ml4ww-show-sbom          c5b77784-cd87-4be8-bc12-28957762f382   16d ago   16s        Succeeded
openshift-c4ae3a5a28e19ffc930e7c2aa758d85c-provision-eaas-space   22535d8e-d360-4143-9c0c-4bd0414a22b0   16d ago   17s        Succeeded

NAME                                           UID                                    STARTED      DURATION   STATUS
openshift-pipelines-main-release-tests-zrgv6-e2e-test             10d6952f-b926-4e4b-a976-519867969ce7   16d ago   12m41s     Failed
openshift-pipelines-main-release-tests-zrgv6-deploy-operator      ab41b63b-16ec-4a32-8b95-f2678eb5c945   16d ago   22s        Succeeded
openshift-pipelines-main-release-tests-zrgv6-provision-cluster    b374df00-5132-4633-91df-3259670756b3   16d ago   12m30s     Succeeded
operator-main-index-4-18-on-pull-request-ml4ww-show-sbom          c5b77784-cd87-4be8-bc12-28957762f382   16d ago   16s        Succeeded
openshift-c4ae3a5a28e19ffc930e7c2aa758d85c-provision-eaas-space   22535d8e-d360-4143-9c0c-4bd0414a22b0   16d ago   17s        Succeeded

Copy to Clipboard

Toggle word wrap

파이프라인 실행과 연결된 작업 실행 목록을 보려면 다음 명령을 입력합니다.
```
opc results taskrun list --pipelinerun <pipelinerun_name> -n <namespace_name>
```
```
$ opc results taskrun list --pipelinerun <pipelinerun_name> -n <namespace_name>
```
Copy to Clipboard Toggle word wrap
선택적으로 --limit 명령줄 옵션을 지정합니다(예: --limit=10 ). 이 설정을 사용하면 opc 명령이 파이프라인 실행 이름을 포함하는 지정된 행 수를 표시한 다음 종료합니다. --single-page=false 명령줄 옵션을 추가하면 명령은 지정된 행 수를 표시한 다음 계속 또는 종료하라는 메시지를 표시합니다.

파이프라인 실행에 대한 opc results taskrun list 명령의 출력 예

NAME                                                              UID                                    STARTED   DURATION   STATUS
operator-main-index-4-18-on-pull-request-g95fk-show-sbom          5b405941-0d3e-4f8c-a68a-9ffcc481abf1   16d ago   13s        Succeeded
operator-main-index-4-18-on-pul2b222db723593a186d12f1b82f1a1fd9   89588ae7-aa36-4b62-97d1-5634ee201850   16d ago   36s        Succeeded
operator-fb80434867bc15d89fea82506058f664-fbc-fips-check-oci-ta   7598d44a-4370-459b-8ef0-ae4165c58ba5   16d ago   5m52s      Succeeded
operator-main-index-4-18-on-pull-request-g95fk-validate-fbc       fb80d962-807b-4b63-80cb-6a57d383755a   16d ago   1m26s      Succeeded
operator-main-index-4-18-on-pull-request-g95fk-apply-tags         8a34b46d-74a9-4f20-9e99-a285f7b258d6   16d ago   13s        Succeeded

NAME                                                              UID                                    STARTED   DURATION   STATUS
operator-main-index-4-18-on-pull-request-g95fk-show-sbom          5b405941-0d3e-4f8c-a68a-9ffcc481abf1   16d ago   13s        Succeeded
operator-main-index-4-18-on-pul2b222db723593a186d12f1b82f1a1fd9   89588ae7-aa36-4b62-97d1-5634ee201850   16d ago   36s        Succeeded
operator-fb80434867bc15d89fea82506058f664-fbc-fips-check-oci-ta   7598d44a-4370-459b-8ef0-ae4165c58ba5   16d ago   5m52s      Succeeded
operator-main-index-4-18-on-pull-request-g95fk-validate-fbc       fb80d962-807b-4b63-80cb-6a57d383755a   16d ago   1m26s      Succeeded
operator-main-index-4-18-on-pull-request-g95fk-apply-tags         8a34b46d-74a9-4f20-9e99-a285f7b258d6   16d ago   13s        Succeeded

Copy to Clipboard

Toggle word wrap

1.4.4. 파이프라인 실행에 대한 결과 정보 보기
링크 복사

opc 유틸리티를 사용하여 파이프라인 실행 시기와 방법, 파이프라인 실행에 대한 전체 매니페스트, 파이프라인 실행의 모든 로그에 대한 설명을 볼 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
파이프라인 실행 및 작업 실행 이름을 통해 Tekton 결과에서 결과를 쿼리하도록 opc 유틸리티를 구성했습니다.
파이프라인 실행의 이름 또는 UUID가 있습니다. ocp 결과 목록 pipelineruns 명령을 사용하여 결과를 사용할 수 있는 파이프라인 실행의 이름 및 UUID를 볼 수 있습니다.

프로세스

다음 명령을 사용하여 파이프라인 실행에 대한 결과 정보를 확인합니다.

파이프라인 실행 시기 및 방법에 대한 설명을 보려면 다음 명령을 입력합니다.

opc results pipelinerun describe -n <namespace_name> <pipelinerun_name>

$ opc results pipelinerun describe -n <namespace_name> <pipelinerun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 파이프라인 실행 UUID를 사용할 수 있습니다.

opc results pipelinerun describe -n <namespace_name> --uid <pipelinerun_uuid>

$ opc results pipelinerun describe -n <namespace_name> --uid <pipelinerun_uuid>

Copy to Clipboard

Toggle word wrap

opc 결과 pipelinerun describe 명령의 출력 예

Name: operator-main-index-4-18-on-pull-request-7kssl
Namespace: tekton-ecosystem-tenant
Service Account: appstudio-pipeline
Labels:
 app.kubernetes.io/managed-by=pipelinesascode.tekton.dev
 app.kubernetes.io/version=v0.33.0
Annotations:
 appstudio.openshift.io/snapshot=openshift-pipelines-main-b7jj6
 build.appstudio.openshift.io/repo=https://github.com/openshift-pipelines/operator?rev=ba5e62e51af0c88bc6c3fd4201e789bdfc093daa

📌 Status
STARTED          DURATION         STATUS
27d ago          9m54s            Succeeded

⏱ Timeouts
Pipeline:   2h0m0s

⚓ Params
  NAME                          VALUE
  • git-url                     https://github.com/pramodbindal/operator
  • revision                    ba5e62e51af0c88bc6c3fd4201e789bdfc093daa

🗂  Workspaces
  NAME                SUB PATH            WORKSPACE BINDING
  • workspace          ---                VolumeClaimTemplate
  • git-auth           ---                Secret (secret=pac-gitauth-ceqzjt)

📦 Taskruns
  NAME                                                                         TASK NAME
  • operator-main-index-4-18-on-pull-request-7kssl-init                        init
  • operator-main-index-4-18-on-pull-request-7kssl-clone-repository            clone-repository

Name: operator-main-index-4-18-on-pull-request-7kssl
Namespace: tekton-ecosystem-tenant
Service Account: appstudio-pipeline
Labels:
 app.kubernetes.io/managed-by=pipelinesascode.tekton.dev
 app.kubernetes.io/version=v0.33.0
Annotations:
 appstudio.openshift.io/snapshot=openshift-pipelines-main-b7jj6
 build.appstudio.openshift.io/repo=https://github.com/openshift-pipelines/operator?rev=ba5e62e51af0c88bc6c3fd4201e789bdfc093daa

📌 Status
STARTED          DURATION         STATUS
27d ago          9m54s            Succeeded

⏱ Timeouts
Pipeline:   2h0m0s

⚓ Params
  NAME                          VALUE
  • git-url                     https://github.com/pramodbindal/operator
  • revision                    ba5e62e51af0c88bc6c3fd4201e789bdfc093daa

🗂  Workspaces
  NAME                SUB PATH            WORKSPACE BINDING
  • workspace          ---                VolumeClaimTemplate
  • git-auth           ---                Secret (secret=pac-gitauth-ceqzjt)

📦 Taskruns
  NAME                                                                         TASK NAME
  • operator-main-index-4-18-on-pull-request-7kssl-init                        init
  • operator-main-index-4-18-on-pull-request-7kssl-clone-repository            clone-repository

Copy to Clipboard

Toggle word wrap

파이프라인 실행의 전체 YAML 매니페스트를 보려면 다음 명령을 입력합니다.

opc results pipelinerun describe -n <namespace_name> --output yaml <pipelinerun_name>

$ opc results pipelinerun describe -n <namespace_name> --output yaml <pipelinerun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 파이프라인 실행 UUID를 사용할 수 있습니다.

opc results pipelinerun describe -n <namespace_name> --output yaml --uid <pipelinerun_uuid>

$ opc results pipelinerun describe -n <namespace_name> --output yaml --uid <pipelinerun_uuid>

Copy to Clipboard

Toggle word wrap

파이프라인 실행과 관련된 로그를 보려면 다음 명령을 입력합니다.

opc results pipelinerun logs -n <namespace_name> <pipelinerun_name>

$ opc results pipelinerun logs -n <namespace_name> <pipelinerun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 파이프라인 실행 UUID를 사용할 수 있습니다.

opc results pipelinerun logs -n <namespace_name> --uid <pipelinerun_uuid>

$ opc results pipelinerun logs -n <namespace_name> --uid <pipelinerun_uuid>

Copy to Clipboard

Toggle word wrap

중요

opc 결과 pipelinerun 로그에 는 이 파이프라인 실행 내에서 완료된 작업 실행 로그가 포함되지 않습니다. 이러한 로그를 보려면 opc results taskrun list --pipelinerun 명령을 사용하여 이 파이프라인 실행에서 작업 실행의 이름을 찾고 파이프라인 실행 이름을 지정합니다. 그런 다음 opc results taskrun log 명령을 사용하여 작업 실행 로그를 확인합니다.

1.4.5. 작업 실행에 대한 결과 정보 보기
링크 복사

opc 유틸리티를 사용하여 작업 실행 시기와 방법, 작업 실행에 대한 전체 매니페스트 및 작업이 생성된 모든 로그를 볼 수 있습니다.

사전 요구 사항

opc 유틸리티를 설치했습니다.
파이프라인 실행 및 작업 실행 이름을 통해 Tekton 결과에서 결과를 쿼리하도록 opc 유틸리티를 구성했습니다.
작업 실행의 이름 또는 UUID가 있습니다. opc results taskrun list 명령을 사용하여 결과를 사용할 수 있는 작업 실행의 이름 또는 UUID를 볼 수 있습니다.
로그를 검색하려면 LokiStack으로 로그 전달을 구성했습니다.

프로세스

다음 명령을 사용하여 작업 실행에 대한 결과 정보를 확인합니다.

작업 실행 시기 및 방법에 대한 설명을 보려면 다음 명령을 입력합니다.

opc results taskrun describe -n <namespace_name> <taskrun_name>

$ opc results taskrun describe -n <namespace_name> <taskrun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 작업 실행 UUID를 사용할 수 있습니다.

opc results taskrun describe -n <namespace_name> --uid <taskrun_uuid>

$ opc results taskrun describe -n <namespace_name> --uid <taskrun_uuid>

Copy to Clipboard

Toggle word wrap

opc results taskrun describe 명령의 출력 예

Name: operator-main-index-4-18-on-push-gc699-build-images-0
Namespace: tekton-ecosystem-tenant
Service Account: appstudio-pipeline
Labels:
 tekton.dev/pipelineTask=build-images
 tekton.dev/task=buildah-remote-oci-ta
Annotations:
 pipelinesascode.tekton.dev/branch=main
 pipelinesascode.tekton.dev/check-run-id=40080193061

📌 Status
STARTED          DURATION         STATUS
28d ago          3m22s            Failed

⚓ Params
  NAME                          VALUE
  • PLATFORM                    linux-m2xlarge/arm64
  • IMAGE                       quay.io/redhat-user-workloads/tekton-ecosystem

Name: operator-main-index-4-18-on-push-gc699-build-images-0
Namespace: tekton-ecosystem-tenant
Service Account: appstudio-pipeline
Labels:
 tekton.dev/pipelineTask=build-images
 tekton.dev/task=buildah-remote-oci-ta
Annotations:
 pipelinesascode.tekton.dev/branch=main
 pipelinesascode.tekton.dev/check-run-id=40080193061

📌 Status
STARTED          DURATION         STATUS
28d ago          3m22s            Failed

⚓ Params
  NAME                          VALUE
  • PLATFORM                    linux-m2xlarge/arm64
  • IMAGE                       quay.io/redhat-user-workloads/tekton-ecosystem

Copy to Clipboard

Toggle word wrap

작업 실행의 전체 YAML 매니페스트를 보려면 다음 명령을 입력합니다.

opc results taskrun describe -n <namespace_name> --output yaml <taskrun_name>

$ opc results taskrun describe -n <namespace_name> --output yaml <taskrun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 작업 실행 UUID를 사용할 수 있습니다.

opc results taskrun describe -n <namespace_name> --output yaml --uid <taskrun_uuid>

$ opc results taskrun describe -n <namespace_name> --output yaml --uid <taskrun_uuid>

Copy to Clipboard

Toggle word wrap

작업 실행과 관련된 로그를 보려면 다음 명령을 입력합니다.

opc results taskrun logs -n <namespace_name> <taskrun_name>

$ opc results taskrun logs -n <namespace_name> <taskrun_name>

Copy to Clipboard

Toggle word wrap

또는 이름 대신 작업 실행 UUID를 사용할 수 있습니다.

opc results taskrun logs -n <namespace_name> --uid <taskrun_uuid>

$ opc results taskrun logs -n <namespace_name> --uid <taskrun_uuid>

Copy to Clipboard

Toggle word wrap

1.4.6. 명령줄 인수의 짧은 이름
링크 복사

opc 유틸리티를 사용하여 파이프라인 실행 및 작업 실행 이름으로 Tekton 결과에서 결과를 쿼리하는 경우 긴 명령줄 인수를 짧은 이름으로 교체할 수 있습니다.

Expand

표 1.5. 명령줄 매개변수의 짧은 이름
전체 매개변수 이름	짧은 매개변수 이름
`pipelinerun`	`pr`
`taskrun`	`tr`
`describe`	`축소`

법적 공지
링크 복사

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

OpenShift Pipelines의 가시성

OpenShift Pipelines의 관찰 기능

1장. OpenShift Pipelines 관찰 기능에 Tekton 결과 사용
링크 복사

1.1. Tekton Results 개념
링크 복사

1.2. Tekton 결과 구성
링크 복사

1.2.1. 로깅 정보를 위한 LokiStack 전달 구성
링크 복사

1.2.2. 외부 데이터베이스 서버 구성
링크 복사

1.2.3. Tekton 결과에 대한 보존 정책 구성
링크 복사

1.3. 결과 및 레코드에 대한 Tekton 결과 쿼리
링크 복사

1.3.1. Tekton 결과 쿼리를 위한 opc 유틸리티 환경 준비
링크 복사

1.3.2. 이름으로 결과 및 레코드 쿼리
링크 복사

1.3.3. 결과 검색
링크 복사

1.3.4. 레코드 검색
링크 복사

1.3.5. 결과 검색에 대한 참조 정보
링크 복사

1.3.6. 레코드 검색에 대한 참조 정보
링크 복사

1.4. 파이프라인 실행 및 작업 실행 이름으로 결과 및 로그 쿼리
링크 복사

1.4.1. 파이프라인 실행 및 작업 실행 이름으로 결과를 쿼리하기 위한 opc 유틸리티 구성
링크 복사

1.4.2. 파이프라인 실행 이름 및 식별자 목록 보기
링크 복사

1.4.3. 작업 실행 이름 및 식별자 목록 보기
링크 복사

1.4.4. 파이프라인 실행에 대한 결과 정보 보기
링크 복사

1.4.5. 작업 실행에 대한 결과 정보 보기
링크 복사

1.4.6. 명령줄 인수의 짧은 이름
링크 복사

법적 공지
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

OpenShift Pipelines의 가시성

OpenShift Pipelines의 관찰 기능

1장. OpenShift Pipelines 관찰 기능에 Tekton 결과 사용링크 복사링크가 클립보드에 복사되었습니다!

1.1. Tekton Results 개념링크 복사링크가 클립보드에 복사되었습니다!

1.2. Tekton 결과 구성링크 복사링크가 클립보드에 복사되었습니다!

1.2.1. 로깅 정보를 위한 LokiStack 전달 구성링크 복사링크가 클립보드에 복사되었습니다!

1.2.2. 외부 데이터베이스 서버 구성링크 복사링크가 클립보드에 복사되었습니다!

1.2.3. Tekton 결과에 대한 보존 정책 구성링크 복사링크가 클립보드에 복사되었습니다!

1.3. 결과 및 레코드에 대한 Tekton 결과 쿼리링크 복사링크가 클립보드에 복사되었습니다!

1.3.1. Tekton 결과 쿼리를 위한 opc 유틸리티 환경 준비링크 복사링크가 클립보드에 복사되었습니다!

1.3.2. 이름으로 결과 및 레코드 쿼리링크 복사링크가 클립보드에 복사되었습니다!

1.3.3. 결과 검색링크 복사링크가 클립보드에 복사되었습니다!

1.3.4. 레코드 검색링크 복사링크가 클립보드에 복사되었습니다!

1.3.5. 결과 검색에 대한 참조 정보링크 복사링크가 클립보드에 복사되었습니다!

1.3.6. 레코드 검색에 대한 참조 정보링크 복사링크가 클립보드에 복사되었습니다!

1.4. 파이프라인 실행 및 작업 실행 이름으로 결과 및 로그 쿼리링크 복사링크가 클립보드에 복사되었습니다!

1.4.1. 파이프라인 실행 및 작업 실행 이름으로 결과를 쿼리하기 위한 opc 유틸리티 구성링크 복사링크가 클립보드에 복사되었습니다!

1.4.2. 파이프라인 실행 이름 및 식별자 목록 보기링크 복사링크가 클립보드에 복사되었습니다!

1.4.3. 작업 실행 이름 및 식별자 목록 보기링크 복사링크가 클립보드에 복사되었습니다!

1.4.4. 파이프라인 실행에 대한 결과 정보 보기링크 복사링크가 클립보드에 복사되었습니다!

1.4.5. 작업 실행에 대한 결과 정보 보기링크 복사링크가 클립보드에 복사되었습니다!

1.4.6. 명령줄 인수의 짧은 이름링크 복사링크가 클립보드에 복사되었습니다!

법적 공지링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

1장. OpenShift Pipelines 관찰 기능에 Tekton 결과 사용
링크 복사

1.1. Tekton Results 개념
링크 복사

1.2. Tekton 결과 구성
링크 복사

1.2.1. 로깅 정보를 위한 LokiStack 전달 구성
링크 복사

1.2.2. 외부 데이터베이스 서버 구성
링크 복사

1.2.3. Tekton 결과에 대한 보존 정책 구성
링크 복사

1.3. 결과 및 레코드에 대한 Tekton 결과 쿼리
링크 복사

1.3.1. Tekton 결과 쿼리를 위한 opc 유틸리티 환경 준비
링크 복사

1.3.2. 이름으로 결과 및 레코드 쿼리
링크 복사

1.3.3. 결과 검색
링크 복사

1.3.4. 레코드 검색
링크 복사

1.3.5. 결과 검색에 대한 참조 정보
링크 복사

1.3.6. 레코드 검색에 대한 참조 정보
링크 복사

1.4. 파이프라인 실행 및 작업 실행 이름으로 결과 및 로그 쿼리
링크 복사

1.4.1. 파이프라인 실행 및 작업 실행 이름으로 결과를 쿼리하기 위한 opc 유틸리티 구성
링크 복사

1.4.2. 파이프라인 실행 이름 및 식별자 목록 보기
링크 복사

1.4.3. 작업 실행 이름 및 식별자 목록 보기
링크 복사

1.4.4. 파이프라인 실행에 대한 결과 정보 보기
링크 복사

1.4.5. 작업 실행에 대한 결과 정보 보기
링크 복사

1.4.6. 명령줄 인수의 짧은 이름
링크 복사

법적 공지
링크 복사