convez.ai
SkillDevOps & InfraestruturaAvançado
tatematsu-k

Sandbox Hosting AWS

tatematsu-k/sandbox-hosting

Hospedagem HTML segura e efêmera na AWS, integrada ao Claude e Slack

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema de hospedagem de HTML com restrição por IP, construído em AWS (S3 + CloudFront + Lambda + DynamoDB). Integrável via Slack e Claude Code skill, oferecendo upload, publicação e expiração automática de conteúdo estático com autenticação por token.

Instalação

$npx convez-ai tatematsu-k/sandbox-hosting

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 dias
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Compartilhar protótipos HTML temporários dentro de equipes autorizadas
  • Hospedar previsualizações geradas por Claude com controle de acesso por IP
  • Criar um sistema de upload colaborativo acionado por comandos Slack

Veredito

Solução robusta e bem arquitetada para quem precisa hospedar conteúdo estático efêmero na AWS com segurança em nível de rede. Requer familiaridade com Terraform, Lambda e integração Slack/API Gateway; ideal para times DevOps e engenheiros de plataforma.

README

A tradução para o português deste README ainda está na fila.

Sandbox Hosting (AWS)

IP制限付きの個人向けHTMLホスティング。AWS S3 + CloudFront + Lambda + DynamoDB 構成。 Slack slash command と Claude Code skill からアップロードする。

アーキテクチャ

Viewer ──HTTPS──► CloudFront ──OAC──► S3 (private)
                       │
                       └─ CloudFront Function (viewer-request)
                            ├─ IP allowlist (CIDR/v4/v6)
                            └─ URI rewrite (/foo/ → /published/foo/index.html)

Slack / Claude Code ──HTTPS──► API Gateway HTTP API ──► Lambda (api)
                                                            │
                                                            ├─ S3 (read/write)
                                                            ├─ DynamoDB (meta)
                                                            └─ SSM Parameter Store (secrets)

EventBridge daily ──► Lambda (cron)
                          └─ scan DynamoDB → unpublish expired

エンドポイント

MethodPath認証用途
GEThttps://{cdn}/{path}/[file]CloudFront Function公開HTML/アセット配信
POSThttps://{api}/uploadBearer UPLOAD_TOKENClaude Code からアップロード
POSThttps://{api}/list同上サイト一覧
POSThttps://{api}/activate同上 (owner一致)再公開 / TTLリセット
POSThttps://{api}/delete同上 (owner一致)完全削除
POSThttps://{api}/slack/uploadSlack 署名slash command 受け口

ストレージレイアウト

S3 ${CONTENT_BUCKET}:

  • published/{path}/index.html 他のアセット
  • unpublished/{path}/... TTL切れ後の退避

DynamoDB ${META_TABLE}:

  • PK: path
  • GSI owner-index: PK=owner
  • Item: {path, owner, type, status, createdAt, updatedAt, ttlExpiresAt, files, source}

ローカル開発

npm install
npm run typecheck
npm test
npm run build   # esbuild で dist/{api,cron}/index.mjs を生成

デプロイ

初回(運用者)

aws configure            # アクセスキー or SSO
cd terraform
cp terraform.tfvars.example terraform.tfvars
# allowed_ips, alarm_email を編集
cd ..
./scripts/setup-aws.sh   # ビルド → terraform apply まで一括

apply 後、以下を手動で実施:

  1. Slack signing secret を SSM に投入 (初期値は REPLACE_ME のまま)

    aws ssm put-parameter --name "/sandbox-hosting/SLACK_SIGNING_SECRET" \
      --type SecureString --overwrite --value "<signing secret>"
    
  2. (任意)Slack bot token (files.slack.com のプライベートファイル取得時のみ必要)

    aws ssm put-parameter --name "/sandbox-hosting/SLACK_BOT_TOKEN" \
      --type SecureString --overwrite --value "xoxb-..."
    

    未設定(REPLACE_ME のまま)の場合、Slack 経路の zip 取得は public file のみ対応。

  3. UPLOAD_TOKEN を控える(Claude Code クライアントに配布)

    aws ssm get-parameter --name "/sandbox-hosting/UPLOAD_TOKEN" \
      --with-decryption --query 'Parameter.Value' --output text
    
  4. (任意)独自ドメインを当てる場合は var.public_base_url を実値で更新し、 ACM 証明書を us-east-1 に発行、CloudFront に紐付け(次フェーズで Terraform 拡張予定)

既知の制約

  • Slack 3秒タイムアウト: アップロード処理が cold start + S3 + DynamoDB で 3秒を超えると Slack 側がタイムアウト表示する。warm時は通常 < 1秒。
  • Slack <URL> 形式: Slack はテキスト中の URL を <https://...|表示名> で wrap することがあるが、現状の parseSlackText は raw URL のみ対応。file_url パラメータ経由を推奨。
  • Custom path concurrent upload: 同一 custom path に対する複数同時 upload は競合 → 最後勝ち。普通の運用では発生しない想定。
  • CloudFront Function サイズ上限 10KB: IP allowlist の CIDR が極端に多い(数百件超)と上限に当たる可能性。その場合は WAF IP set への移管を検討。

クライアント初期設定(各利用者)

./scripts/setup-client.sh
./scripts/healthcheck.sh

継続的インテグレーション

.github/workflows/:

  • ci.yml: PR / push で typecheck + vitest + terraform fmt/validate + shellcheck
  • pages.yml: docs/site/** の変更で運用ガイドを GitHub Pages へ自動 deploy
  • dependabot-auto-merge.yml: patch / minor の Dependabot PR を CI 通過後に squash auto-merge

本番デプロイは vercel deploy ではなくローカルから ./scripts/setup-aws.sh (または terraform -chdir=terraform apply)で実行する運用。

TTL ルール

  • auto path (timestamp_username): 90日後に EventBridge cron が unpublish
  • custom path: TTL対象外
  • POST /activate で再公開 + TTLリセット

テスト

npm run typecheck   # tsc
npm test            # vitest
npm run lint:tf     # terraform fmt -check
Ver o original no GitHub

Bom para

Relacionados