Skip to content

Commit 191fcf6

Browse files
baijumclaude
andcommitted
docs: reference towlion/infra in tutorial and ecosystem
Add automated provisioning tip to tutorial Step 2 and add Infrastructure CLI section to ecosystem docs. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 194ebe0 commit 191fcf6

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

docs/ecosystem.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ The Towlion GitHub organization serves as a catalog of deployable applications.
88
towlion/
99
.github # Organization profile, community health files, and reusable workflows
1010
platform # Architecture docs and platform tools
11+
infra # Infrastructure provisioning CLI (OpenTofu)
1112
app-template # Template for bootstrapping new apps
1213
todo-app # Todo CRUD application
1314
wit # Work Item Tracker (Kanban board)
@@ -32,6 +33,17 @@ The meta repository for the ecosystem. Contains:
3233
- Developer CLI (`cli/towlion`) — see [CLI reference](cli.md)
3334
- Infrastructure scripts (blue-green deploy, backup verification, credential rotation)
3435

36+
### Infrastructure CLI ([`towlion/infra`](https://github.com/towlion/infra))
37+
38+
CLI tool for provisioning Towlion servers on DigitalOcean or AWS using [OpenTofu](https://opentofu.org). Creates a Debian server with:
39+
40+
- Firewall (ports 22, 80, 443)
41+
- 50 GB data volume mounted at `/data`
42+
- SSH key pair
43+
- Optional DNS zone with root and wildcard A records
44+
45+
Usage: `./towlion-infra init --provider <aws|digitalocean>` then `./towlion-infra apply`.
46+
3547
### Application Template ([`towlion/app-template`](https://github.com/towlion/app-template))
3648

3749
A [GitHub Template Repository](https://github.com/towlion/app-template) for creating new applications. Includes:

docs/tutorial.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,14 @@ ssh root@YOUR_SERVER_IP
4949

5050
You should see a shell prompt. If this works, you are ready to bootstrap.
5151

52+
!!! tip "Automated provisioning"
53+
Instead of creating a server manually, you can use [towlion/infra](https://github.com/towlion/infra) to provision a Debian server with a single command:
54+
```bash
55+
./towlion-infra init --provider digitalocean
56+
./towlion-infra apply --domain example.com
57+
```
58+
This creates a server with the correct firewall rules, a data volume, SSH key, and optional DNS — ready for bootstrap. See the [infra README](https://github.com/towlion/infra) for setup and usage.
59+
5260
## Step 3: Bootstrap the server
5361

5462
SSH into your server as root. Download and run the bootstrap script — no `git` required:

0 commit comments

Comments
 (0)