デプロイ
GMShop Edgeは、2種類の生産サイクルをサポートしています。
- Bun/ニトロ自Hosting:SQLite、プライベートローカルオブジェクト、耐久性のあるローカルキュー、および永続的なデータディレクトリを使用。Dockerまたは、サービスマネージャーを用いたソースデプロイメントを使用。
- Cloudflare Workers:D1、KV、R2、キュー、Cron トリガー、およびオプションのメール送信。
これらの実行環境は、共通のストアフロント、顧客アカウント、チェックアウト、履行、管理コンソール、サプライヤーAPI、Telegram連携、および/installフローにアクセスできます。
Docker Compose
公開の GHCR パッケージ は、linux/amd64 と linux/arm64 をサポートしています。以下の内容を compose.yml として保存してください。
services:
gmshop-edge:
image: ghcr.io/gmwalletapp/gmshop-edge:latest
restart: unless-stopped
ports:
- "3000:3000"
environment:
GMSHOP_DATA_DIR: /var/lib/gmshop
volumes:
- gmshop-data:/var/lib/gmshop
volumes:
gmshop-data:サービスを開始し、確認してください。
docker compose pull
docker compose up -d
curl --fail http://127.0.0.1:3000/healthz
docker compose ps
docker compose logs --follow gmshop-edgeこのコンテナは、root権限で動作します。GMSHOP_DATA_DIR には、gmshop.sqlite、プライベートなオブジェクト、耐久性のあるキューの状態、およびすべての実行時のデータが含まれています。コンテナが更新または再作成されるたびに、gmshop-data ボリュームを保持し、バックアップしてください。
GMSHOP_DATA_DIRは、唯一の公開されているBun環境変数です。/installまたは/adminを通じて、Origin、許可されるホスト、メール、支払い、サプライヤー、Telegram、および自動化の設定を構成してください。
Bunはシングルインスタンスのみをサポートしています。複数のレプリカでの展開や共有ネットワークストレージはサポートされていません。アップグレード、復元、または展開の移行を行う前に、Bun データ操作 を必ず読んでください。
ソースから Bun でデプロイ
ソースから直接、プロダクションサーバーを実行できます。Dockerを使用せずに、GitとBun 1.3以降をインストールしてください。PM2をプロセスマネージャーとして選択した場合のみ、Node.jsが必要です。
git clone https://github.com/GMWalletApp/gmshop-edge.git
cd gmshop-edge
bun install --frozen-lockfile
bun run build:bun
sudo install -d -m 0700 -o "$USER" -g "$USER" /var/lib/gmshop
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMSHOP_DATA_DIR=/var/lib/gmshop \
bun run start:bun最後のコマンドは前景色で実行されます。本番環境では、systemd、Supervisor、PM2、または別のサービスマネージャーで実行してください。GMSHOP_DATA_DIR のデータは、Dockerボリュームと同様に、保存しバックアップしてください。Bun 実行環境はシングルインスタンスのみをサポートしており、複数レプリカの展開や共有ネットワークストレージはサポートされていません。
PM2
PM2 自体は Node.js と npm が必要ですが、GMShop Edge は Bun で動作します。PM2 が生成されたサーバーを Node.js で起動しようとするのを防ぐため、--interpreter bun オプションを明示的に指定してください。
npm install --global pm2
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMSHOP_DATA_DIR=/var/lib/gmshop \
pm2 start .output/server/index.mjs \
--name gmshop-edge --interpreter bun
pm2 save
pm2 startuppm2 startup で表示されたコマンドを実行し、再度 pm2 save を実行してください。pm2 logs gmshop-edge と curl --fail http://127.0.0.1:3000/healthz を使用して、サービスの動作を確認してください。
ソースのデプロイを更新する:
pm2 stop gmshop-edge
git pull --ff-only
bun install --frozen-lockfile
bun run build:bun
pm2 restart gmshop-edge --update-envCloudflare Workers
デプロイボタン
このガイド付きの手順で、「Worker」プロジェクトを準備します。 展開後、/installを開き、以下の設定を確認してください。
gmshop-edgeをDBとして。- KV
gmshop-edge-cacheをCACHEとして。 - プライベート R2
gmshop-edge-filesをFILESとして扱う。 gmshop-edge-commerceをCOMMERCE_QUEUEとしてキューを作成し、gmshop-edge-commerce-dlqをその死キューとして設定します。- ワンミニュート・クローン、および、選択された場合、Cloudflare Send Email を「
EMAIL」として。
Wrangler CLI
bun install
bunx wrangler login
bun run deploypredeploy 連携は、指定されたリソースを作成または再利用し、リモートのマイグレーションを実行し、Worker を構築します。解決された D1/KV ID は、dist/server/wrangler.json にのみ注入されます。アカウント固有の ID は、ポータブルな wrangler.jsonc には書き込まれません。
初回インストール
DockerまたはBunが起動したら、http://your-host:3000/installを開いてください。Workersのデプロイ後には、WorkerのURLで/installを開き、検知された公開アドレスと許可されているホストを確認してから、最初のルート管理者を作成してください。
インストールにより、最初のルート管理者、保護された組み込みのストアロール、実行時の秘密、および必要な商業、為替、認証、および通知のデフォルト設定が作成されます。ただし、偽の製品、在庫、プロバイダーの資格情報、または支払い設定は作成されません。
インストール後:
/adminで生成されたシステム設定をレビューし、実行構成をバックアップしてください。- ブランディング、登録、認証、メール、EC、配送、顧客維持、およびプロバイダーの設定を構成する。
- 販売可能な商品と在庫、ファイル、または自動化設定を含む、販売可能な製品のドラフトを作成し、公開する前に、公開確認を実行してください。
- 支払いアダプターを設定し、実の販売者との受取注文を完了させてから、店舗を開設してください。
生産前に、正確なホスト/オリジンルール、実際の支払いおよび回収メール、在庫/ダウンロード/自動化の履行、キューの再試行と死信処理、払い戻し、期限切れの権利、バックアップ復元、両方のアプリケーションのローカライズ、テーマ、モバイル動作、キーボード操作、および管理者による復元について確認してください。