William Valentin
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# Milestone 6 (P3): Deployment Targets (Nix + Fly/Railway/Render)
|
|
|
|
Date: 2026-02-16
|
|
|
|
## Goals
|
|
|
|
- Provide a Nix flake/package that builds `dist/` and preserves `dist/gateway/ui` adjacency.
|
|
- Provide an optional NixOS module for running Flynn as a systemd service.
|
|
- Add first-class docs and templates for Fly.io / Railway / Render.
|
|
- Ensure PaaS network binding works (`server.localhost: false`) and port binding works (`PORT` env override).
|
|
|
|
## Implementation
|
|
|
|
### Nix
|
|
|
|
- Added `flake.nix` with:
|
|
- `packages.flynn` / `packages.default`
|
|
- `apps.default` (`nix run`)
|
|
- `devShells.default` (`nix develop`)
|
|
- `overlays.default` (exposes `pkgs.flynn`)
|
|
- `nixosModules.flynn`
|
|
- Added Nix package definition: `nix/package.nix` (builds via `pnpm build`).
|
|
- Added NixOS module: `nix/module.nix` (`services.flynn.*`).
|
|
- Added docs: `docs/deployment/NIX.md`.
|
|
|
|
### PaaS
|
|
|
|
- Added a PaaS-friendly config template: `config/paas.yaml` (`server.localhost: false`).
|
|
- Updated `Dockerfile` to ship a default config at `/config/config.yaml` so the image is runnable without a bind-mount.
|
|
- Added templates:
|
|
- Fly.io: `deploy/flyio/fly.toml`
|
|
- Railway: `deploy/railway/railway.toml`
|
|
- Render: `deploy/render/render.yaml`
|
|
- Added docs: `docs/deployment/PAAS.md`.
|
|
|
|
## Acceptance Notes
|
|
|
|
- `pnpm build` still copies gateway UI to `dist/gateway/ui` (required adjacency).
|
|
- `PORT` env override is implemented in `src/config/loader.ts` (completed earlier on 2026-02-16).
|
|
- For PaaS/container routing, use `server.localhost: false` (baked into `config/paas.yaml`).
|
|
|