Tekton CI/CD Pipeline

Key Features

• Tekton Dashboard web interface for visual pipeline monitoring and task execution tracking
• Cloud-native pipeline execution using Kubernetes pods with automatic resource cleanup
• Local Docker registry integration for storing and serving container images during builds
• KinD cluster providing full Kubernetes API compatibility for realistic pipeline testing
• Tekton Triggers support for webhook-based pipeline automation from Git repositories
• Custom Resource Definitions for defining reusable Tasks, Pipelines, and PipelineRuns
• Built-in workspace volume management for sharing data between pipeline steps
• RBAC integration using Kubernetes service accounts for secure pipeline execution

Common Use Cases

• 1Learning Tekton Pipelines syntax and concepts without requiring cloud Kubernetes clusters
• 2Developing and testing custom Tekton Tasks before deploying to production environments
• 3Prototyping multi-stage CI/CD workflows for containerized applications with local image builds
• 4Training development teams on cloud-native CI/CD practices using Kubernetes primitives
• 5Building internal platform engineering demos showcasing Tekton capabilities to stakeholders
• 6Testing Tekton Catalog tasks and community-contributed pipeline components locally
• 7Validating pipeline security policies and RBAC configurations in isolated environments

Prerequisites

• Docker Desktop or Docker Engine with at least 8GB RAM allocated for KinD cluster operation
• kubectl CLI tool installed and configured for Kubernetes cluster management
• tkn CLI tool for creating and managing Tekton pipeline resources from command line
• Basic understanding of Kubernetes concepts including pods, services, and custom resources
• Familiarity with YAML syntax for writing Tekton Task and Pipeline definitions
• Local ports 5000, 6443, and 9097 available for registry, Kubernetes API, and dashboard access

docker-compose.yml

1services: 
2  kind: 
3    image: kindest/node:v1.28.0
4    container_name: tekton-cluster
5    privileged: true
6    ports: 
7      - "${API_PORT:-6443}:6443"
8      - "${DASHBOARD_PORT:-9097}:30097"
9    volumes: 
10      - kind_data:/var/lib/containerd
11
12  registry: 
13    image: registry:2
14    container_name: tekton-registry
15    restart: unless-stopped
16    ports: 
17      - "${REGISTRY_PORT:-5000}:5000"
18    volumes: 
19      - registry_data:/var/lib/registry
20
21volumes: 
22  kind_data: 
23  registry_data: 

.env Template

1# Tekton CI/CD
2API_PORT=6443
3DASHBOARD_PORT=9097
4REGISTRY_PORT=5000

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

kind:
  image: kindest/node:v1.28.0
  container_name: tekton-cluster
  privileged: true
  ports:
    - ${API_PORT:-6443}:6443
    - ${DASHBOARD_PORT:-9097}:30097
  volumes:
    - kind_data:/var/lib/containerd

registry:
  image: registry:2
  container_name: tekton-registry
  restart: unless-stopped
  ports:
    - ${REGISTRY_PORT:-5000}:5000
  volumes:
    - registry_data:/var/lib/registry

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  kind:
5    image: kindest/node:v1.28.0
6    container_name: tekton-cluster
7    privileged: true
8    ports:
9      - "${API_PORT:-6443}:6443"
10      - "${DASHBOARD_PORT:-9097}:30097"
11    volumes:
12      - kind_data:/var/lib/containerd
13
14  registry:
15    image: registry:2
16    container_name: tekton-registry
17    restart: unless-stopped
18    ports:
19      - "${REGISTRY_PORT:-5000}:5000"
20    volumes:
21      - registry_data:/var/lib/registry
22
23volumes:
24  kind_data:
25  registry_data:
26EOF
27
28# 2. Create the .env file
29cat > .env << 'EOF'
30# Tekton CI/CD
31API_PORT=6443
32DASHBOARD_PORT=9097
33REGISTRY_PORT=5000
34EOF
35
36# 3. Start the services
37docker compose up -d
38
39# 4. View logs
40docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/tekton-cicd-stack/run | bash

Troubleshooting