デプロイ
GMPay Edgeは、2つの生産サイクルをサポートしています。
- SQLite と永続的なローカルデータディレクトリを使用し、Docker またはサービスマネージャーを用いたソースデプロイ方式で、Bun/Nitro を自 host する。
- Cloudflare Workers:D1、KV、R2、キュー、および Cron トリガー。
これらの実行環境は、すべて同じ商取引API、チェックアウト、管理者コンソール、バックグラウンドジョブ、および/installフローにアクセスできます。
Docker Compose (推奨)
公開されている GHCR パッケージ は、linux/amd64 および linux/arm64 をサポートしており、登録は不要です。
以下の内容を compose.yml として保存してください。
services:
gmpay-edge:
image: ghcr.io/gmwalletapp/gmpay-edge:latest
restart: unless-stopped
ports:
- "3000:3000"
environment:
GMPAY_DATA_DIR: /var/lib/gmpay
volumes:
- gmpay-data:/var/lib/gmpay
volumes:
gmpay-data:サービスを開始してください。
docker compose pull
docker compose up -dlatest タグは最新の安定版を指します。同じバージョンを再現してデプロイするには、1.0.0 のような完全なバージョン番号を指定します。
GMPAY_DATA_DIR には、SQLite、アップロードされたファイル、プライベートオブジェクト、キューの状態、およびその他の実行時データが含まれています。コンテナを更新または再作成する際には、gmpay-data ボリュームを保持し、バックアップしてください。
バックアップ、復元、またはデプロイの移行を行う前に、Bun データ操作 を必ず読んでください。
サービスを検証し、ログを調査してください。
curl --fail http://127.0.0.1:3000/healthz
docker compose ps
docker compose logs --follow gmpay-edgeデータを保持したまま更新する:
docker compose pull
docker compose up -dDockerコマンド
Composeが利用できない場合は、コンテナを直接実行してください。
docker volume create gmpay-data
docker run --detach --name gmpay-edge --restart unless-stopped \
--publish 3000:3000 \
--env GMPAY_DATA_DIR=/var/lib/gmpay \
--volume gmpay-data:/var/lib/gmpay \
ghcr.io/gmwalletapp/gmpay-edge:latestソースから Bun でデプロイ
ソースから直接、プロダクションサーバーを実行できます。Dockerを使用せずに、GitとBun 1.3以降をインストールしてください。PM2をプロセスマネージャーとして選択した場合のみ、Node.jsが必要です。
git clone https://github.com/GMWalletApp/gmpay-edge.git
cd gmpay-edge
bun install --frozen-lockfile
bun run build:bun
sudo install -d -o "$USER" -g "$USER" /var/lib/gmpay
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMPAY_DATA_DIR=/var/lib/gmpay \
bun run start:bun最後のコマンドは前景色で実行されます。本番環境では、systemd、Supervisor、PM2、または別のサービスマネージャーで実行してください。GMPAY_DATA_DIR は、Dockerボリュームと同様に、保存しバックアップしてください。
PM2
PM2 自体は Node.js と npm が必要ですが、GMPay Edge は Bun で動作します。PM2 が生成されたサーバーを Node.js で起動しようとするのを防ぐため、 --interpreter bun オプションを明示的に指定してください。
npm install --global pm2
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMPAY_DATA_DIR=/var/lib/gmpay \
pm2 start .output/server/index.mjs \
--name gmpay-edge --interpreter bun
pm2 save
pm2 startuppm2 startup で表示されたコマンドを実行し、再度 pm2 save を実行してください。pm2 logs gmpay-edge と curl --fail http://127.0.0.1:3000/healthz を使用して、サービスの動作を確認してください。
ソースのデプロイを更新する:
pm2 stop gmpay-edge
git pull --ff-only
bun install --frozen-lockfile
bun run build:bun
pm2 restart gmpay-edge --update-envCloudflare Workers
デプロイボタン
このガイド付きの仕組みは、wrangler.jsonc で宣言されたバインディングを適用し、D1 のマイグレーションを実行し、Worker を構築します。
- ビルドコマンド:
bun run build - デプロイコマンド:
wrangler deploy
デプロイ後、WorkerのURLで/installを開き、インスタンスを初期化してください。
Wrangler CLI
bun install
bunx wrangler login
bun run deployもし D1 を手動で準備する必要がある場合:
bunx wrangler d1 create gmpay-edge
bun run db:migrate:remoteデータベースのIDを生成しないでください。デプロイメントフックは、D1、KV、R2、およびキューという名前のリソースを作成または再利用し、D1のベースラインを適用し、公開前にワーカーを構築します。
地域開発
要件:
- バージョン 1.3 以降
- 開発環境:Wrangler for the Workers を利用した地域環境
bun install
bun run devbun run dev は、ローカルの gmpay-edge D1 データベースへの未完了のマイグレーションを実行し、http://localhost:3000 でアプリケーションを起動します。
初回インストール
DockerまたはBunが起動したら、http://your-host:3000/installを開いてください。Workersのデプロイ後には、WorkerのURLで/installを開きます。最初のルートユーザーを作成する前に、検出された公開アドレスと許可されているホストを確認してください。
インストールにより、以下のものが作成されます:
- 最初のユーザー。
- 保護された
rootロール。 - 実行時の秘密
- 支払い遅延
- 公開されているテレグラムのコマンドと、テレグラムのデフォルト設定。
Telegram Bot の作成や Telegram へのアクセスは、コンテナ環境変数ではなく、管理インターフェースで管理されます。セキュリティとメール設定も、同様に管理インターフェースで行います。