theam / theam/facility

Simplify deployment into an easily installable cloud-agnostic bundle

Open
#19 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority:normal type:infra
Dominant language
TypeScript
Stars
71
Forks
64
Avg merge
15h 38m
Merged PRs (30d)
66

Description

Problem

The self-host path today is a multi-hour, AWS-specific Terraform runbook (ECS, RDS, CloudFront, Secrets Manager, one-shot bootstrap tasks). That is a hard blocker for adoption: someone evaluating the platform should reach a working governed run in minutes, not in an afternoon of infrastructure work.

Scope

  • Define the minimal deployable unit (api + worker + gateway + web + Postgres) and ship it as a cloud-agnostic bundle: one docker compose up (or equivalent) driven by a single configuration file.
  • Automate what is manual today: migrations, master key, operator bootstrap, and GitHub App creation (the App manifest flow can register the App, its permissions and its webhook programmatically — see #34).
  • Keep the Terraform path as the "production reference" profile; the bundle is the adoption path.
  • Keep tenancy assumptions out of the bundle so it can also serve as a substrate for hosted deployments.

Acceptance

  • Someone with Docker and a GitHub organization gets a working governed run on a test repository in under 15 minutes, following one documentation page.
  • No step requires reading Terraform.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the existing Terraform production-reference path and the deployment assumptions for the api, worker, gateway, web, and Postgres components. Review the GitHub App manifest flow described in #34, then define the bundle and its single configuration entry point. Done means a documentation page enables a Docker-equipped user with a GitHub organization to reach a governed test-repository run in under 15 minutes without reading Terraform.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, github, postgresql, terraform, typescript
Domain
backend, cloud, databases, devops, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.