Skip to content

Commit 704abf3

Browse files
committed
docs: strengthen oabctl recommendation in Option 1 after live E2E
Verified oabctl ingress on us-east-1 (2026-07-07): - One provisions the full stack in ~2.5min - Replaces all 7 manual AWS CLI steps - Two pitfalls documented: us-east-1e AZ unsupported, configFrom required Switches from 'automation tip' to 'Recommended' callout at Option 1 top.
1 parent a466815 commit 704abf3

1 file changed

Lines changed: 22 additions & 4 deletions

File tree

docs/refarch/running-telegram-line-on-aws.md

Lines changed: 22 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,28 @@ traffic to your Fargate task's `:8080` without paying for an ALB.**
5050
This is the cheapest AWS-native path. It replaces a $16+/month ALB with a ~$1/month
5151
API Gateway HTTP API and uses Cloud Map for service discovery instead of hardcoded IPs.
5252

53-
> **Automation tip**: The `oabctl` operator (see [`operator/README.md`](../../operator/README.md))
54-
> automates this exact Option 1 setup — API Gateway + VPC Link + Cloud Map +
55-
> security group — via a declarative `spec.ingress` block. Once you understand the
56-
> manual steps below, consider using `oabctl apply` for production deployments.
53+
> **✅ Recommended: use `oabctl`** — one `oabctl apply -f` command provisions this
54+
> entire Option 1 stack (Cloud Map → VPC Link → API Gateway → routes → stage) in
55+
> ~2.5 minutes, replacing all 7 manual steps below. Tested and verified on
56+
> `us-east-1` (2026-07-07).
57+
>
58+
> ```bash
59+
> # Minimal manifest (save as bot.yaml, then oabctl apply -f bot.yaml):
60+
> spec:
61+
> ingress:
62+
> type: apigateway
63+
> paths:
64+
> - /webhook/telegram
65+
> ```
66+
>
67+
> See [`docs/oabctl.md`](../oabctl.md#ingress--inbound-webhooks-telegram--line)
68+
> for the full ingress reference. Known pitfalls:
69+
> - `us-east-1e` (use1-az3) does **not** support API Gateway VPC Link — avoid
70+
> subnets in that AZ.
71+
> - `configFrom` (S3 config path) is required even for infra-only testing.
72+
>
73+
> The manual CLI steps below are preserved for readers who want to understand
74+
> the underlying AWS plumbing or who are not using `oabctl`.
5775
5876
### Architecture Diagram
5977

0 commit comments

Comments
 (0)