Catalog Deployment

Mon, 01 Jan 0001 00:00:00 +0000

This guide covers deploying Porch in production environments using the Nephio catalog.

Configuration Planning

Before deploying Porch, determine which features you need:

Optional Pre-deployment Configuration

These optional features must be configured before deployment if you need them:

Porch Server

Cache Configuration - Switch to database cache (requires deployment args)
Cert-Manager Webhooks - Enable cert-manager webhook integration (requires deployment env vars)
Jaeger Tracing - Enable distributed tracing (requires deployment env vars)
Git Custom TLS - Enable custom TLS certificates for Git repositories (requires --use-git-cabundle=true arg)

Function Runner

Private Registries - Configure private container registries (requires deployment args and volume mounts)

Post-deployment Configuration

These features can be configured after deployment:

Local Development Environment

Mon, 01 Jan 0001 00:00:00 +0000

This guide provides instructions for setting up a local development environment using Kind (Kubernetes in Docker) for developing, testing, and exploring Porch.

Prerequisites

Docker - For running containers and Kind cluster
kubectl - Kubernetes command-line tool
kind - Local Kubernetes clusters using Docker

Setup

1. Create Kind Cluster

From the Porch repository root directory:

./scripts/setup-dev-env.sh

This script:

Creates a Kind cluster named porch-test
Installs MetalLB load balancer
Deploys Gitea Git server
Generates PKI resources for testing
Builds the porchctl CLI binary

2. Deploy Porch

Choose your cache backend:

Deployments on Porch Documentation