Welcome to Shipyard

A complete infrastructure monorepo with a multi-tenant Kubernetes deployment platform, reusable Terraform modules, and production-ready infrastructure-as-code for AWS.

Get Started Architecture Overview

What’s Inside

Shipyard is a comprehensive infrastructure monorepo containing three major components

K8s Scheduler

Multi-tenant Kubernetes deployment platform with React frontend, OAuth, RBAC, and Stripe billing

Terraform Modules

Production-ready modules for VPC, EKS, RDS, Vault, and more

Infrastructure

Three-tier deployment system with full AWS infrastructure automation

Quick Start

Get up and running in minutes with local development

Clone the repository

Clone the Shipyard monorepo to your local machine:

git clone https://github.com/ops-north/shipyard.git
cd shipyard

Start local development environment

Use the automated setup script to create a local Kind cluster with all dependencies:

cd k8s-scheduler
make dev-local

This command creates a Kind cluster, deploys PostgreSQL, builds container images, and launches both the server and operator.

Access the platform

Open your browser and navigate to the local development server:

open http://localhost:8081

In dev mode, you’ll be automatically logged in as dev@localhost with no OAuth required.

Explore the components

What gets deployed locally?

PostgreSQL - Database for users, orgs, teams, deployments
Server (port 8081) - Go REST API with embedded React UI
Operator - Kubernetes controller watching UserDeployment CRs
Kind cluster - Local Kubernetes environment

Key Features

Production-ready infrastructure components and deployment automation

Multi-Tenancy & RBAC

Organization, team, and user-level access control with role-based permissions

HashiCorp Vault Integration

Three-tier secrets management with External Secrets Operator for K8s injection

Reusable Terraform Modules

Battle-tested modules for VPC, EKS, RDS, Vault, and EC2 with complete documentation

Modern Tech Stack

React 19, Go 1.24, Kubernetes operator pattern, and controller-runtime

Ready to Deploy?

Follow our comprehensive deployment guide to set up the full infrastructure on AWS with Terraform.

View Deployment Guide