快速开始

本指南将现有的 Tekton 安装连接到 Artifact Hub Shim,并从内置 catalog 解析一个 Task。

前提条件

  • Artifact Hub Shim 已安装并准备就绪。
  • 已安装受支持的 Alauda Container Platform Pipelines 发行版。当前发布的版本为 v4.14.0。在 4.10、4.6 和 4.0 系列上的支持将在 v4.10.2、v4.6.4 和 v4.0.17 之后提供。
  • ACP 集群符合 Release Notes 中的最低补丁版本要求。
  • 你可以编辑 TektonConfig,并在测试命名空间中创建一个 TaskRun。

流程概览

步骤操作预期结果
1验证 Artifact Hub ShimAPI 报告运行正常且已就绪。
2配置 Tektonhub resolver 使用集群内的 shim Service。
3验证 resolver生成的 resolver ConfigMap 包含 shim URL。
4解析一个 TaskTaskRun 的进度超出远程解析阶段。

验证 Artifact Hub Shim

以下命令使用默认命名空间和 Service 名称:

kubectl get deployment,service -n artifacthub-shim-system

kubectl get --raw \
  '/api/v1/namespaces/artifacthub-shim-system/services/http:artifacthub-shim-api:80/proxy/readyz'

就绪响应应包含 "status":"ready"。就绪响应表示 API 已发布 catalog 快照。

配置 Tekton

集成 Artifact Hub Shim 的标准 ACP 安装可能已经包含以下设置。如果缺少这些值,或插件使用自定义命名空间,请将适用字段合并到 TektonConfig.spec.pipeline 中:

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pipeline:
    enable-hub-resolver: true
    hub-resolver-config:
      artifact-hub-api: http://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local
      default-artifact-hub-task-catalog: catalog
      default-artifact-hub-pipeline-catalog: catalog-pipelines
      default-kind: task
      default-tekton-hub-catalog: catalog
      default-type: artifact

保留与 hub resolver 无关的现有 spec.pipeline 字段。 对于 Pipelines as Code 和非默认安装,请参阅 配置 Tekton 集成。

验证 Resolver 配置

查找 Tekton 目标命名空间并检查已协调的 ConfigMap:

RESOLVER_NAMESPACE="$(kubectl get tektonconfig config \
  -o jsonpath='{.spec.targetNamespace}')"

kubectl get configmap hubresolver-config \
  -n "${RESOLVER_NAMESPACE}" \
  -o jsonpath='{.data.artifact-hub-api}{"\n"}'

预期输出:

http://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local

同时验证 resolver 功能已启用:

kubectl get configmap resolvers-feature-flags \
  -n "${RESOLVER_NAMESPACE}" \
  -o jsonpath='{.data.enable-hub-resolver}{"\n"}'

预期输出:

true

解析内置 Task

创建一个 TaskRun,引用 run-script Task 的 0.1 版本。如果打包的 catalog 提供其他版本,请将 0.1 替换为列出的版本。

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  generateName: artifacthub-shim-quick-start-
spec:
  taskRef:
    resolver: hub
    params:
      - name: type
        value: artifact
      - name: catalog
        value: catalog
      - name: kind
        value: task
      - name: name
        value: run-script
      - name: version
        value: "0.1"
  params:
    - name: script
      value: echo artifacthub-shim-ready

将清单保存为 taskrun.yaml,将其应用到测试命名空间,并检查结果:

kubectl apply -n <test-namespace> -f taskrun.yaml
kubectl get taskrun -n <test-namespace>

远程解析成功后,Tekton 会创建 TaskRun pod。如果 TaskRun 仍处于解析错误状态,请参阅 Hub Resolver 无法解析资源。

后续步骤

商标和归属

Tekton™ 是 The Linux Foundation 的商标。

Red Hat® 和 OpenShift® 是 Red Hat, Inc. 在美国和其他国家/地区的注册商标。

Alauda 是独立供应商。本产品与 The Linux Foundation 或 Red Hat, Inc. 无关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,本文使用这些商标仅用于标识目的。