Tekton Hub to Artifact Hub Proxy

A transition proxy that bridges Tekton Hub API calls to Artifact Hub. For migration assistance only - users should transition to using Artifact Hub directly.

🔄

API Translation

Converts Tekton Hub API endpoints to Artifact Hub format automatically

🗂️

Catalog Mapping

Configurable mapping between Tekton Hub and Artifact Hub catalog names

📦

Version Conversion

Handles conversion between simplified semver (0.1) and full semver (0.1.0)

⚡

High Performance

Built with Go for optimal performance and includes intelligent caching with 1h0m0s TTL to Artifact Hub

Available API Endpoints

GET/v1/catalogs

GET/v1/resources

GET/v1/resource/{catalog}/{kind}/{name}

GET/v1/resource/{catalog}/{kind}/{name}/{version}

GET/health

🧪 Testing with Tekton Hub Resolver

Configure your Tekton Hub Resolver to use this proxy, then test with a simple PipelineRun:

1. Configure Tekton Hub Resolver:

kubectl set env -n tekton-pipelines-resolvers deployments.app/tekton-pipelines-remote-resolvers TEKTON_HUB_API=https://tknhub.pipelinesascode.com/

2. Test with Example PipelineRun:

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  generateName: hub-test-
spec:
  pipelineSpec:
    tasks:
      - name: fetch-repo
        taskRef:
          resolver: hub
          params:
            - name: kind
              value: task
            - name: name
              value: tkn
            - name: version
              value: "0.4"
            - name: type
              value: tekton
            - name: catalog
              value: tekton

🚀 Testing with Pipelines-as-Code

Note: Latest Pipelines-as-Code versions automatically use Artifact Hub. This configuration is only needed for older versions that cannot be upgraded:

Add to PaC ConfigMap:

hub-url: https://tknhub.pipelinesascode.com/
hub-catalog-type: tektonhub

See PaC Settings Documentation for complete configuration details.

⚠️ Cache Notice

Important: This proxy caches Artifact Hub responses for 1h0m0s to improve performance. If tasks or pipelines are updated in Artifact Hub, you may see stale data until the cache expires. For critical updates, switch to use https://artifacthub.io/ directly.

Service gratuitously provided by pipelinesascode.com

Not affiliated with Tekton or Artifact Hub projects

No guarantee of uptime or SLAs • Use at your own risk

Source code: chmouel/tekton-hub-proxy • For a best effort support contact @chmouel on X