OpenShift Pipelines 中的可观察性

先决条件

• 已安装 openssl 命令行工具。

• 如果您不需要使用外部 PostgreSQL 服务器，请输入以下命令，使用名为 result 的数据库用户以及 openshift-pipelines 命名空间中的随机密码：

  $ oc create secret generic tekton-results-postgres \
    --namespace=openshift-pipelines \
    --from-literal=POSTGRES_USER=result \
    --from-literal=POSTGRES_PASSWORD=$(openssl rand -base64 20)

  注意

  在这个命令中，在后续逗号中，如果您为 OpenShift Pipelines 配置了自定义目标命名空间，请使用此命名空间的名称而不是 openshift-pipelines。

• 如果要使用外部 PostgreSQL 数据库服务器来存储 Tekton Results 数据，请输入以下命令创建带有此服务器的凭证的 secret：

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

  将 <user > 替换为 Tekton Results 必须使用的 PostgreSQL 用户的用户名。将 <password > 替换为同一帐户的密码。

• Red Hat OpenShift Pipelines 集群中的持久性卷声明(PVC)
• Google Cloud Storage
• S3 存储桶存储

• 要使用 PVC，请完成以下步骤：

  1. 使用 PVC 的以下定义，创建名为 pvc.yaml 的文件：

       apiVersion: v1
       kind: PersistentVolumeClaim
       metadata:
         name: tekton-logs
       spec:
         accessModes:
         - ReadWriteOnce
         resources:
           requests:
             storage: 1Gi

  2. 输入以下命令应用定义：

     $ oc apply -n openshift-pipelines -f pvc.yaml

• 要使用 Google Cloud Storage，请完成以下步骤：

  1. 使用 gcloud 命令创建应用凭据文件。有关在文件中提供应用程序凭证的说明，请参阅 Google Cloud 文档中的使用 gcloud CLI 提供的用户凭证。

  2. 输入以下命令从应用程序凭证文件创建 secret：

     $ oc create secret generic gcs-credentials \
       --from-file=$HOME/.config/gcloud/application_default_credentials.json \
       -n openshift-pipelines

     根据需要调整应用程序凭证文件的路径和文件名。

• 要使用 S3 存储桶存储，请完成以下步骤：

  1. 使用以下内容创建名为 s3_secret.yaml 的文件：

       apiVersion: v1
       kind: Secret
       metadata:
         name: my_custom_secret
         namespace: tekton-pipelines
       type: Opaque
       stringData:
         S3_BUCKET_NAME: bucket1 1
         S3_ENDPOINT: https://example.localhost.com 2
         S3_HOSTNAME_IMMUTABLE: "false"
         S3_REGION: region-1 3
         S3_ACCESS_KEY_ID: "1234" 4
         S3_SECRET_ACCESS_KEY: secret_key 5
         S3_MULTI_PART_SIZE: "5242880"

     1 1

     S3 存储桶的名称

     2 2

     S3 API 端点 URL

     3

     S3 区域

     4

     S3 访问密钥 ID

     5

     S3 secret 访问密钥

  2. 输入以下命令从文件创建 secret：

     $ oc create secret generic s3-credentials \
       --from-file=s3_secret.yaml -n openshift-pipelines

• 要配置 LokiStack 转发，请完成以下步骤：

  1. 在 OpenShift Container Platform 集群中，使用 Loki Operator 安装 LokiStack，同时安装 OpenShift Logging Operator。

  2. 根据您安装了 OpenShift Logging 版本 6 或版本 5，为 ClusterLogForwarder 自定义资源(CR)创建一个 ClusterLogForwarder.yaml 清单文件，包含以下 YAML 清单之一：

     如果安装了 OpenShift Logging 版本 6，ClusterLogForwarder CR 的 YAML 清单

     apiVersion: observability.openshift.io/v1
     kind: ClusterLogForwarder
     metadata:
       name: collector
       namespace: openshift-logging
     spec:
       inputs:
       - application:
           selector:
             matchLabels:
               app.kubernetes.io/managed-by: tekton-pipelines
         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

     如果安装了 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 ]

  3. 要在 openshift-logging 命名空间中创建 ClusterLogForwarder CR，以集群管理员用户身份使用 OpenShift CLI (oc)登录到 OpenShift Container Platform 集群，然后输入以下命令：

     $ oc apply -n openshift-logging ClusterLogForwarder.yaml

先决条件

• 已安装 Tekton 结果。
• 已安装 opc 工具。

先决条件

• 已安装 Tekton 结果。
• 已安装 opc 工具，并准备好其环境来查询 Tekton Results。
• 安装了 jq 软件包。

先决条件

• 已安装 Tekton 结果。
• 已安装 opc 工具，并准备好其环境来查询 Tekton Results。

流程

• 输入以下命令使用 CEL 查询来搜索结果：

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

先决条件

• 已安装 Tekton 结果。
• 已安装 opc 工具，并准备好其环境来查询 Tekton Results。

流程

• 输入以下命令使用 CEL 查询搜索记录：

  $ opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <namespace_name>/result/-

  将 &lt ;namespace_name > 替换为管道运行或任务运行的命名空间。或者，输入以下命令搜索单个结果中的记录：

  $ opc results records list --addr ${RESULTS_API} --filter="<cel_query>" <result_name>

  将 <result_name > 替换为结果的全名。

• UNKNOWN
• SUCCESS
• 失败
• TIMEOUT （超时）
• CANCELLED