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

사전 요구 사항

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

검증

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

  $ opc results config view

  출력 예

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

사전 요구 사항

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

프로세스

• 파이프라인 실행을 보려면 다음 명령을 사용합니다.

  • 지정된 네임스페이스의 모든 파이프라인 실행을 보려면 다음 명령을 입력합니다.

    $ opc results pipelinerun list -n <namespace_name>

    선택적으로 --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)

  • 지정된 이름이 지정된 파이프라인과 관련된 파이프라인 실행을 보려면 다음 명령을 입력합니다.

    $ opc results pipelinerun list <pipeline_name> -n <namespace_name>

    명령은 <pipeline _name>을 포함하는 이름이 있는 파이프라인의 모든 파이프라인 실행을 나열합니다. 예를 들어 build를 지정하는 경우 명령은 build,build_123 또는 enhanced build 라는 파이프라인과 관련된 모든 파이프라인을 표시합니다.

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

사전 요구 사항

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

프로세스

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

  $ opc results taskrun list -n <namespace_name>

  선택적으로 --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

• 파이프라인 실행과 연결된 작업 실행 목록을 보려면 다음 명령을 입력합니다.

  $ opc results taskrun list --pipelinerun <pipelinerun_name> -n <namespace_name>

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

사전 요구 사항

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

프로세스

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

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

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

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

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

    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

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

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

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

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

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

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

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

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

사전 요구 사항

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

프로세스

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

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

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

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

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

    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

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

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

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

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

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

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

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

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