プロジェクトを評価する開発者
Docker EngineとComposeプラグインを備えたホストに加え、プロジェクトの最新のデプロイ手順を参照できることが必要です。ファイルを作成する前に、そのリリースで必要なサービスと環境変数を確認してください。
公式にサポートされている設定と、別の場所で見つけた古い設定例を区別できます。
セルフホスティングガイド
予期せぬ問題を減らしてmixpost dockerをセットアップ
mixpost dockerのデプロイは、コピーした設定ファイルではなく、プロジェクトの最新の手順から始めましょう。このガイドを使ってホストを計画し、公式手順に従ってスタックを起動し、再起動後も投稿できることを確認してください。
前提条件
コンテナを起動する前に、ホスト、ドメイン、バックアップの管理担当者を決めてください。こうした確認は、どのComposeコマンドを使うかより重要です。
初めてセルフホスティングする方
サーバーはあるものの、ドメインの割り当てやHTTPSの計画はまだできていません。ソーシャルチャネルを接続する前に、アプリケーションへのアクセス経路を決めてください。
一時的なアドレスを使って外部サービスのコールバックを設定せずに済みます。
コミュニティマネージャー
コンテナでのインストールによって、ソーシャルネットワークに要求する権限が変わるかを確認したい場合は、サーバーのセットアップとは別に、各接続とその権限範囲を確認してください。
ホスティング方法の選択とチャネルの認可を、別々の判断として扱えます。
少人数チームの運用担当者
永続データ、シークレットの保管場所、更新の担当者が必要です。ボリュームの保存場所と、復元をどうテストするかを記録してください。
動作するだけのコンテナを、一度きりのデモではなく、継続して運用できるサービスにできます。
最初から最後までの手順
選択したリリースのドキュメントを正確な情報源として参照してください。サービス名や必須設定は変更される場合があります。以下は作業の流れであり、Composeファイルの代わりではありません。
-
1
ホストと設定を準備する
Docker EngineとComposeプラグインをインストールし、現行のMixpostドキュメントからリンクされているデプロイ用ファイルを入手します。必須の環境設定を確認し、安定して使えるドメインを選び、秘密情報を公開リポジトリに置かないでください。ホストに永続データとバックアップ用の十分な空き容量があることも確認します。
-
2
スタックを起動して状態を確認する
ドキュメントに記載されたComposeファイルがあるディレクトリでdocker compose up -dを実行します。docker compose psで各サービスが稼働し続けているか確認し、終了したサービスがあればdocker compose logsでログを調べます。コンテナが稼働しているだけで、想定したドメインからアプリケーションにアクセスできると判断しないでください。
-
3
アクセスとデータの永続性を確認する
HTTPSアドレスからアプリケーションを開き、公式ドキュメントに記載されたセットアップを完了します。テスト投稿を公開せずに作成し、スタックを再起動して、下書きが残っていることを確認します。使用したリリースと設定を記録し、本番利用を始める前にバックアップからの復元をテストしてください。
選択肢の比較表
デプロイ方法を比較する際は、「選択肢」「管理上の責任」「適した用途」の3列にすると便利です。ローカルでのテストは手軽な確認に向いています。一方、サーバーへのデプロイにはHTTPS、バックアップ、継続的なメンテナンスが必要です。
稼働中のコンテナから使えるワークスペースへ
これらの画像は2つの確認段階を示すものであり、検証済みの単一環境のスクリーンショットではありません。次の段階に進む前に、HTTPSでのアクセス、再起動後のデータ保持、各チャネルに必要な権限を確認してください。コンテナが正常に稼働しているだけでは、予約投稿が機能するとは限りません。
スタックが稼働中ワークフローを検証済み問題が起きたら
コンテナのログは調査の出発点であり、それだけで原因を特定できるわけではありません。すべてのサービスを繰り返し再起動するのではなく、問題が起きている確認段階から調べてください。
1
アプリケーションにアクセスできません
コンテナが稼働していても、ドメイン、プロキシ、TLS証明書、または公開ポートの設定が間違っている可能性があります。使用する予定の公開アドレスとローカル接続の両方をテストしてください。
代わりに行うこと
公式ドキュメントのネットワークに関する指針とプロキシ設定を比較し、サービスログで起動時のエラーを確認してください。
2
再起動後にデータが消えます
書き込み可能なコンテナのファイルシステムは、バックアップにも、ドキュメントに記載された構成に必要な永続ストレージの代わりにもなりません。
代わりに行うこと
ドキュメントに記載されたボリュームのマッピングを確認し、重要な作業を保存する前にテスト用の下書きでデータが保持されることを確かめてください。
3
チャネルの接続または投稿に失敗します
Dockerでは、ソーシャルプラットフォームへのアクセス権を付与したり、間違ったコールバックURLを修正したりできません。各ネットワークには、それぞれ認証と公開に関する要件があります。
代わりに行うこと
公開URLを確認し、必要に応じて影響を受けたチャネルを再接続して、そのネットワークの最新の要件を確認してください。
4
更新後にインストール環境が動作しなくなります
リリースノートを読まずにイメージを入れ替えると、設定や依存サービスとの整合性が取れなくなる可能性があります。
代わりに行うこと
永続データをバックアップし、正常に動作していたリリースを記録して、ドキュメントに記載されたアップグレード手順に従い、ロールバック計画を用意してください。
保守しやすい構成を維持する
サーバーの詳細情報をチェックリストにまとめ、すべてのコマンドと設定をプロジェクトの最新ドキュメントと照らし合わせて確認してください。更新、バックアップ、チャネルの再接続の担当者も決めてください。アプリケーションをコンテナで実行しても、これらの作業がなくなるわけではありません。
Mixpost Dockerに関するFAQ
インストールするリリース向けに公開されているComposeのデプロイ手順を使用してください。古い例が今も適合すると決めつけず、必要なファイルと設定をプロジェクトから入手してください。Docker Composeはコンテナを管理しますが、ドメインやバックアップの設定は行いません。
Docker EngineとComposeプラグインを利用できるホストに加え、現行のデプロイガイドで求められる設定が必要です。公開サイトとして運用する場合は、固定ドメイン、HTTPS、永続ストレージ、バックアップ先を用意してください。選択したデプロイ構成に含まれるサービスを基に、ホストの容量と性能を確認してください。
コンテナのステータスで分かるのは、プロセスが実行中かどうかだけです。サービスログ、設定したアドレス、プロキシのルーティング、TLS、デプロイ構成で必要なポートを確認してください。訪問者やプラットフォームからのコールバックが使用するのと同じ公開URLでサイトをテストしてください。
正しく設定された永続ストレージに保存されたデータは、通常の再起動では消えないはずですが、テストせずにそうだと決めつけないでください。下書きを保存してスタックを再起動し、下書きが残っていることを確認してください。コンテナとは別にバックアップを維持してください。
いいえ。アプリケーションの実行とソーシャルチャネルの認証は別の手順です。権限とコールバックについて、現行のMixpostの手順と各ネットワーク固有の手順に従い、予約投稿に使用する前に各接続をテストしてください。