Skip to content

stellar: add cloud operator deployment guides for hosted relayer#190

Open
stevep0z wants to merge 5 commits into
mainfrom
feat/stellar-relayer-guides
Open

stellar: add cloud operator deployment guides for hosted relayer#190
stevep0z wants to merge 5 commits into
mainfrom
feat/stellar-relayer-guides

Conversation

@stevep0z

@stevep0z stevep0z commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds operator deployment guides for infrastructure teams running a self-hosted Stellar Channels relayer service. This PR includes a detailed GCP guide, with an AWS guide also coming in this PR.

Type of Change

  • New documentation

What

New guide: Hosted Stellar Relayer on GCP: Operator Deployment Guide

Covers end-to-end provisioning of the full GCP infrastructure stack:

  • Cloud Run (autoscaling) behind an External HTTPS Load Balancer with Google-managed SSL
  • Memorystore Redis (STANDARD_HA) for state and job scheduling
  • Pub/Sub topics/subscriptions for the distributed transaction pipeline
  • Secret Manager + Cloud KMS (ED25519) for secrets and signing
  • Artifact Registry remote repo proxying the ECR image
  • Optional Cloudflare Worker for API-key issuance, rate limiting, and analytics
  • Optional Cloud Functions for balance monitoring

Targeted at GCP-fluent operators who are new to the OZ relayer stack. Sized for production workloads (~2M+ tx/day across ~2,500 relayers).

An AWS operator deployment guide will also be added to this PR.

Both guides are added to the Stellar navigation under Relayer 1.5.x → Guides.

Why

Operators deploying the Stellar Channels service in their own cloud environments currently have no dedicated reference for standing up the full infrastructure stack. These guides close that gap.

Related Issues

N/A

Additional Notes

Guides written with significant contributions from @collins-w, @tirumerla, and team!

@stevep0z stevep0z requested a review from a team as a code owner June 23, 2026 18:24
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for openzeppelin-docs-v2 ready!

Name Link
🔨 Latest commit 58886a8
🔍 Latest deploy log https://app.netlify.com/projects/openzeppelin-docs-v2/deploys/6a3f6f1b2a63ba0008d2b223
😎 Deploy Preview https://deploy-preview-190--openzeppelin-docs-v2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

stevep0z added 2 commits June 23, 2026 17:48
Add step-by-step operator deployment guide for running the hosted Stellar
Channels service on AWS (ECS Fargate, ElastiCache, SQS, KMS, SSM). Includes
architecture diagrams, configuration reference, operational playbook,
debugging guide with sync/async path mental model, security model, and gotchas.

Update nav to list the AWS guide alongside the existing GCP guide.
@stevep0z stevep0z requested a review from tirumerla June 27, 2026 00:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant