Tekton Hub 配置
目录
概述核心配置区域Catalog Refresh 配置默认刷新间隔修改刷新间隔禁用自动刷新Categories 配置默认 Categories添加自定义 Categories应用 category 更改在资源中使用 categoriesHub Resolver 配置前提条件启用 Hub ResolverHub Resolver 配置自定义 Hub 端点应用配置测试 Hub Resolver常见配置问题Hub Resolver 问题Catalog Refresh 问题Category 配置问题概述
本指南介绍 Tekton Hub 实例的基本配置,包括安装和核心系统设置。你将了解如何配置 Tekton Hub 部署的基础方面。
重要:如果你是通过
TektonConfig部署Tekton Hub,请在TektonConfig资源中修改 catalog 配置,而不是直接编辑ConfigMap。直接对ConfigMap所做的修改会被Tekton Operatorcontroller 覆盖。
命名空间说明:在本指南中,
<tekton-pipelines>用作你的Tekton Hub命名空间占位符。请将其替换为你的实际命名空间名称。默认安装使用tekton-pipelines命名空间。
核心配置区域
本指南涵盖 Tekton Hub 配置的关键主题:
- Catalog Refresh:资源自动同步
- Categories:资源分类与组织
- Hub Resolver:与
Tekton Pipelines集成
Catalog Refresh 配置
默认刷新间隔
默认情况下,Tekton Hub 每 30 分钟刷新一次 catalog,以从已配置的仓库中获取最新资源。
修改刷新间隔
可以通过修改 tekton-hub-api ConfigMap 中的 CATALOG_REFRESH_INTERVAL 设置来配置刷新间隔。
支持的时间单位:
s(秒):30s、60sm(分钟):15m、30m、45mh(小时):1h、2h、12hd(天):1d、2dw(周):1w、2w
示例配置:
禁用自动刷新
若要完全跳过自动刷新,请将间隔设置为空或 "0":
Categories 配置
默认 Categories
Tekton Hub 提供以下标准 categories 用于资源组织:
- Automation
- Build Tools
- CLI
- Cloud
- Code Quality
- Continuous Integration
- Deployment
- Developer Tools
- Image Build
- Integration & Delivery
- Git
- Kubernetes
- Messaging
- Monitoring
- Networking
- Openshift
- Publishing
- Security
- Storage
- Testing
- Script
添加自定义 Categories
你可以通过修改 tekton-hub-api ConfigMap 中的 CATEGORIES 部分来添加自定义 categories:
Category 指南:
- 使用清晰、具有描述性的名称
- 采用首字母大写格式
- 避免与现有 categories 重复
- 保持名称简洁但有意义
应用 category 更改
更新 categories 后:
-
应用更新后的 ConfigMap:
-
刷新 Hub 配置:
在资源中使用 categories
catalog 中的资源可以通过注解引用这些 categories:
Hub Resolver 配置
Hub resolver 使用户能够在 TaskRun 和 PipelineRun 中引用 Hub 资源。正确配置对于 catalog 资源解析至关重要。
前提条件
Tekton Pipelinesv0.41.0 或更高版本- 已安装内置远程 resolvers
- 已启用 Beta 功能(如果使用 beta resolver 功能)
启用 Hub Resolver
通过在 feature-flags ConfigMap 中设置特性标志来启用 Hub resolver:
Hub Resolver 配置
通过 hubresolver-config ConfigMap 配置 Hub resolver 默认值:
自定义 Hub 端点
在大多数情况下,你应保持默认的
TEKTON_HUB_API端点(http://tekton-hub-api.tekton-pipelines:8000/)不变。 只有在你明确需要与外部 hub API 集成时,才应修改此端点。
对于自定义 Tekton Hub 实例,请通过 resolver deployment 中的环境变量配置 API 端点:
应用配置
更新 resolver 配置后:
-
应用 ConfigMap 更改:
-
重启 resolver deployment:
测试 Hub Resolver
使用一个简单的 TaskRun 测试 resolver 配置:
常见配置问题
Hub Resolver 问题
问题:无法通过 Hub resolver 解析资源
解决方案:
- 验证
Hubresolver 是否已启用:kubectl get cm feature-flags -n <tekton-pipelines> -o yaml - 检查 resolver 配置:
kubectl get cm hubresolver-config -n <tekton-pipelines> - 确保
Hub配置中的 catalog 名称与 resolver 参数一致
Catalog Refresh 问题
问题:catalog 未自动更新
解决方案:
- 检查刷新间隔设置:
CATALOG_REFRESH_INTERVAL - 验证 catalog 仓库的可访问性
- 查看
APIpod 日志中的同步错误 - 手动重启
APIpod:kubectl delete pod app=tekton-hub-api -n <tekton-pipelines>
Category 配置问题
问题:资源未显示在预期的 categories 中
解决方案:
- 验证 category 是否存在于
Hub配置中 - 检查资源注解是否与已配置的 categories 匹配
- 在更改 categories 后重启
APIpod