Skiff2 Documentation

Skiff2 is a tool for deploying web applications on GCP at AI2. It provisions GCP projects, sets up load balancers, manages SSL certificates, and wires up DNS — so you can focus on building.

What you get​

When your project is onboarded to Skiff2, you automatically receive:

• A dedicated GCP project with Cloud Run, Container Registry, and Secret Manager enabled
• A load balancer with HTTPS termination
• SSL certificates for all your domains
• DNS records on allen.ai, apps.allenai.org and pandajungle.org
• GitHub Actions variables pre-configured in your repo for CI/CD
• Shared GitHub Actions for building and deploying your services

How it works​

1. You add a project-config.json to the skiff-commodore repo and open a PR
2. On merge, Terraform provisions your GCP project and sets GitHub Actions variables on your repo
3. You add a skiff2.json to your repo and set up GitHub Actions workflows using the shared actions
4. On push to main, your services are built, pushed to Container Registry, and deployed to Cloud Run

Next steps​

• Getting Started — step-by-step onboarding walkthrough
• skiff-template — a ready-to-use FastAPI + React starter wired up for Skiff2
• Migrating from Skiff1 — guide for converting an existing skiff1 repo
• skiff2.json Reference — configuring your services
• project-config.json Reference — project registration options
• GitHub Actions Reference — shared CI/CD actions