コード販売基盤の自前構築チェックリスト:ドメイン・コンテナ・データベース・バックアップ
プログラムが起動するのは導入の出発点にすぎません。ライセンスキーや引換コードを販売する自前基盤では、注文の追跡、在庫の重複割当防止、継続的な決済通知受領、サーバー破損後の復旧も必要です。本稿は1台のサーバー上の一般的な構成で役割を説明します。未確認のバージョンを指定したり、不明なワンクリック導入スクリプトを提供したりせず、具体的なコマンドは選んだプロジェクトの正式資料に従ってください。
この記事の目次
最小構成を描いてからサーバー仕様を決める
- アクセス入口ドメインとHTTPSリバースプロキシ
- 業務アプリケーション商品・注文・ログイン・決済通知
- 永続データ非公開ネットワーク内のデータベースと管理された在庫
- バックグラウンドジョブ納品・メール・再試行・定期照合
低トラフィックのサイトは単一ホストで始められますが、共通障害点があることを理解してください。コンテナで分離しても、壊れたディスクは自動復旧しません。容量設計では実際の並列処理、DB接続数、在庫量、ジョブ時間を観察し、トップページの閲覧数だけで推測しないでください。
まず対応データベース、実行環境、キュー、永続化ディレクトリーを確認します。テストと本番を分離し、テスト用コードと決済鍵も分けて、訓練で実際の商品が納品されないようにします。
ドメイン・HTTPS・通知入口をまとめて検証する
ドメインを実際の入口へ向け、証明書が使用ホスト名を含むことと更新監視を確認します。ブラウザーでトップを開けても、決済サービスから通知先へ到達できるとは限りません。プロキシ規則、アクセス認証、ファイアウォールが機械リクエストを異なる扱いにする場合があります。
通知入口ではHTTPメソッド、本文サイズ、タイムアウト、応答規則を個別に確認します。ログインページへ転送したり、人間判定ページを返したりせず、便宜上すべての管理保護を解除することもしません。許可が必要なら必要なパスだけを調整し、バックエンドの署名検証を残します。
管理画面には強い認証と最小権限を使い、機密操作では再確認を要求します。内部注文番号で入口、アプリケーション、ジョブのログをつなぎつつ、コード全体、セッショントークン、決済鍵を記録しないようにします。「リクエスト未到達」か「業務未処理」かの切り分けは、ページの再読み込みを繰り返すより有効です。
実行中のファイルを手直しせず、再現可能なコンテナ設定を使う
イメージの出所とテスト済みの明確なバージョンまたはダイジェストを記録し、旧版設定を残します。本番で随時変わるタグに依存せず、ホスト上で一時変更したプログラムを正式版として扱いません。再現可能とは、別のマシンでも同じ検証済みアプリケーションを得られることです。
Dockerの本番導入ガイドは、本番要件に合わせたバインド、ログ、再起動方針の調整を勧めています。専用の上書き設定を使えますが、結合後の内容を先に理解してください。以下は確認コマンドの例で、ファイル名は自分のプロジェクトに合わせて変更します。
docker compose -f compose.yaml -f compose.production.yaml config --quiet
docker compose -f compose.yaml -f compose.production.yaml ps
再起動ポリシーはサービスの利用可能性を保証しません。プロセスが動いていてもDBへ接続できない場合があるため、業務ヘルスチェック、リソース制限、外部アラートが必要です。再起動の反復で根本エラーを隠さないようにします。
データベースを非公開にし、永続化ディレクトリーを個別に記録する
データベースは通常、業務コンテナだけがアクセスできればよく、ポートをインターネットへ公開する必要はありません。保守には管理された経路と専用アカウントを使います。アプリには実行に必要な権限だけを与え、スキーマ移行には別の権限を使うことで、アプリの脆弱性がDB全体の管理権限へ直結する危険を減らせます。
コンテナは置き換えられても、注文や在庫がコンテナ削除とともに消えてはいけません。DB、アップロードファイル、必要な暗号鍵、ジョブ状態の保存場所を個別に記録します。Dockerのボリュームドキュメントはボリュームのライフサイクルを説明しています。ボリュームはデータを永続化しますが、ホストストレージの故障には影響されるため、遠隔地バックアップの自動的な代わりにはなりません。
金額の単位と精度を明確にし、注文時刻は統一して保存し、画面で適切に変換します。コードの平文表示、出力、サポート担当の閲覧には権限を設けます。アプリ層で暗号化するなら、復号用情報も管理された復元手順に含めます。暗号化DBだけをバックアップして鍵を失えば、納品を復元できません。
鍵・コンテナ権限・管理入口をまとめて制限する
決済鍵、DBパスワード、メール認証情報をイメージ、公開リポジトリー、問い合わせ画像へ書き込まないでください。コンポーネント別に異なる認証情報を配り、更新手順を記録します。Compose secretsを使う場合、名前を宣言するだけでなく、アプリが実際にファイルから読み取れる必要があります。
DockerのCompose secretsガイドはサービス単位のアクセス許可を説明しています。通常ファイルを元にする場合、ホスト側ファイルも保護が必要で、secretの宣言によって元ファイルが自動暗号化されるわけではありません。認証情報を含むバックアップにも暗号化とアクセス制御が必要です。
アプリの要件に合わせてコンテナ権限を最小化し、特権モードを避け、Docker管理ソケットを業務コンテナへマウントしないようにします。OWASPのコンテナセキュリティチェックリストは、ソケットへのアクセスがホスト管理のリスクを広げると指摘しています。管理パネルも、珍しいポート番号だけを保護策にしてはいけません。
納品と通知を復旧可能なバックグラウンド処理にする
支払い確認、在庫割当、メール送信は別の段階です。DBには支払いの事実と納品待ちジョブを残し、メールサービスが一時停止しても受領済み支払いを消さないようにします。ジョブには少なくとも注文番号、処理状態、試行回数、次回再試行時刻を記録します。
再試行可能なエラーにはバックオフと上限を設け、上限超過後は手動対応リストへ移します。在庫切れや金額不一致は無限再試行では解決しません。外部の納品APIには安定した業務用冪等キーを使い、ワーカー再起動後の重複有効化を防ぎます。
入金済み未納品、長時間処理中、通知失敗が続く注文を定期照合します。稳付payのオンチェーン監視は設定した承認条件の達成後に通知しますが、在庫割当とデジタル商品の納品は加盟店システムの担当です。加盟店管理画面は開発中のため、実際に提供する資料と問い合わせ対応に基づいて連携してください。
隔離環境での復元によりバックアップの有効性を証明する
許容できるデータ損失期間と復旧時間を先に決め、バックアップ頻度を定めます。たとえば1日1回なら、障害時に当日の新規注文が欠ける可能性があり、「データが失われない」わけではありません。DBエンジンに合った整合性のある方式を使い、書き込み中のデータディレクトリーを適当にコピーして復元可能と判断しないでください。
PostgreSQLのSQLダンプの説明は論理バックアップと復元を紹介しています。他のDBならその公式手順を使います。必要な設定、ファイル、管理下の鍵も対象にし、別の場所のコピーと保持期間を定めてください。
復元訓練は隔離環境で行い、最初に実際のメール、決済通知、自動納品を止めます。最近の注文、在庫の関連、管理者権限、ジョブ状態を確認し、復旧時間を記録します。DBを過去時点へ戻した後は、販売済みコードを再割当しないよう決済側記録で再照合します。
障害訓練と本番導入チェックで仕上げる
障害例1:更新でDB項目を追加した後、旧イメージに戻すだけでは起動しなくなったケースです。ロールバックはプログラムだけでなくスキーマ互換性も確認する必要があります。更新前に移行計画、バックアップ、復元手順を検証し、本番でその場しのぎの推測をしないようにします。
障害例2:アプリのヘルスチェックは成功し続けても、ワーカーが止まり、顧客は支払い後に「処理中」しか見られないケースです。トップページの成功応答だけでなく、入口、DB接続、ジョブ滞留、最古の待機時間を個別に監視すべきです。
- ドメイン・証明書更新・通知経路を外部から検証済み。
- DBに不要な公開ポートがなく、認証情報を本番環境と分けて管理している。
- コンテナ再作成後もデータが残り、重要ディレクトリーとバージョンを記録している。
- 重複通知・最後の在庫・在庫切れ・メール失敗・遅延入金のテストが通っている。
- 隔離環境でバックアップを復元し、決済記録とコード状態が一致している。
- 更新担当者・アラート受信者・手動納品手順が明確。
少量の商品と管理された注文で観察を始め、段階的に増やします。自前構築の価値は納品プロセス全体を理解・管理できることにありますが、継続的な保守時間も確保する必要があります。
参考資料・技術ドキュメント
以下の公式資料は、プロトコルと実装原理の確認に使用しています。コードと事例は技術説明のためのもので、具体的な環境と正式な連携仕様はそれぞれ検証してください。