mcpField
T
tinyship-deploy

tinyship-deploy

github.com/tinyshipcnクラウド・DevOps576 回インストール1 週間前に更新
リポジトリ

tinyship-deploy について

TinyShipを本番環境へデプロイするためのスキルです。Docker、Vercel、Cloudflare Workers、VPSから対象を選び、リリース前の確認を進められます。

主な機能

  1. 01デプロイ先の選択ガイド
  2. 02本番環境のチェックリスト
  3. 03Dockerのデプロイ手順
  4. 04Vercelのデプロイ手順
  5. 05Cloudflare Workersのガイド
  6. 06VPSのデプロイガイド

活用シーン

  1. 01TinyShipのホスティング先の選定
  2. 02リリース前の本番設定確認
  3. 03TanStack StartアプリのCloudflare Workersへのデプロイ

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tinyshipcn/tinyship-skills --skill tinyship-deploy

インストール後、Claude Code で/tinyship-deployを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
cloudflare-deploy.md
docker-deploy.md
vercel-deploy.md

詳細

TinyShip のデプロイ

TinyShip を本番環境にデプロイするためのガイドです。

プラットフォームの選択

希望するデプロイ先をユーザーに確認します。

プラットフォーム最適な用途フレームワークのサポート
Dockerセルフホスト、本格的な制御3 つすべてのフレームワーク
VercelNext.js プロジェクト、設定不要Next.js（推奨）
Cloudflare Workersエッジデプロイ、グローバル展開TanStack Start のみ
VPS (PM2 + Nginx)従来型のホスティング3 つすべてのフレームワーク

該当するリファレンスファイルを読み、手順に従います。

デプロイ前チェックリスト（すべてのプラットフォーム）

デプロイする前に、次の項目を確認してください。

  1. 本番データベースの準備ができていること（PostgreSQL を推奨）
  2. 本番環境用の環境変数が設定されていること：
    • APP_BASE_URL — 本番ドメイン（例：https://app.example.com）
    • BETTER_AUTH_URL — APP_BASE_URL と同じ値
    • BETTER_AUTH_SECRET — 強力なランダムシークレット（openssl rand -hex 32 で生成）
    • DATABASE_URL — 本番データベースの接続文字列
  3. OAuth リダイレクト URIが本番ドメインに更新されていること
  4. 決済 Webhook URLが本番ドメインに更新されていること
  5. データベースのマイグレーションが完了していること：本番データベースに対して pnpm db:push を実行

Docker でのデプロイ

詳しい手順は references/docker-deploy.md をご覧ください。

概要：

# Build and run with Docker Compose
docker compose --profile next up -d  # or --profile nuxt / --profile tanstack

# Or build individual image
docker build -f apps/next-app/Dockerfile -t tinyship .

Vercel へのデプロイ

詳しい手順は references/vercel-deploy.md をご覧ください。

概要：

  1. GitHub にプッシュする
  2. Vercel Dashboard でプロジェクトをインポートする
  3. ルートディレクトリを apps/next-app に設定する
  4. 環境変数を設定する
  5. デプロイする

Cloudflare Workers

詳しい手順は references/cloudflare-deploy.md をご覧ください。

TanStack Start でのみ利用できます。D1 データベースと Wrangler CLI を使用します。 既知の問題については apps/tanstack-app/CF-NOTES.md をご覧ください。

VPS（PM2 + Nginx）

TinyShip リポジトリ内の docs/user-guide/deployment/traditional.md をご覧ください。

概要：

  1. アプリをビルドする：pnpm build:next（または nuxt/tanstack）
  2. PM2 をインストールする：npm install -g pm2
  3. PM2 で起動する：pm2 start .output/server/index.mjs --name tinyship
  4. ポート 7001 への Nginx リバースプロキシを設定する
  5. Let's Encrypt で SSL を設定する

デプロイ後

デプロイした後、次の項目を実施します。

  1. ヘルスチェックを確認する：curl https://yourdomain.com/api/health
  2. ログインフローをテストする
  3. すべてのプロバイダーの OAuth リダイレクト URI を更新する
  4. 決済 Webhook URL を更新する
  5. 決済が設定されている場合は、テスト決済を実行する
  6. 監視とアラートを設定する

TinyShip リポジトリ内のリファレンスファイル

  • docs/user-guide/deployment/overview.md — デプロイに関するドキュメントのインデックス
  • docs/user-guide/deployment/docker.md — Docker デプロイガイド
  • docs/user-guide/deployment/cloud.md — クラウドプラットフォームガイド
  • docs/user-guide/deployment/cloudflare-workers.md — CF Workers ガイド
  • docs/user-guide/deployment/traditional.md — VPS/PM2 ガイド
  • docker-compose.yml — Docker Compose の設定
  • apps/tanstack-app/CF-NOTES.md — Cloudflare Workers の既知の問題
  • apps/tanstack-app/wrangler.jsonc — Wrangler の設定

コメント

Markdown 対応