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.

Cache Mode Selection

Choose your cache backend based on deployment scale and requirements:

CR Cache (default): Development and small deployments (<100 repositories)
DB Cache: Production deployments requiring scale and reliability

Important

If using DB Cache, you must configure database settings for both Porch Server and Repository Controller before deployment. See Cache Configuration for complete setup instructions including database initialization.

Optional Pre-deployment Configuration

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

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