すべての記事
Getting Started
CICDoo とは はじめに: オンボーディングウィザード ダッシュボードとインフラマップConcepts
本番、ステージング、開発の各ステージ ドメイン、サブドメイン、SSL Odoo のバージョンとエディション(Community と Enterprise) ワークスペースとチームでの共同作業Servers
サーバーの追加 サーバーのドメインと DNS ロードバランサーを使う 踏み台サーバー経由で接続する サーバーの操作: デプロイ、ログ、チャート Deleting a serverProjects & Git
プロジェクトの作成 GitHub の接続 Project GitHub settings and webhook GitLab の接続 ブランチとインスタンス プロジェクトのタグ付けと絞り込み アプリノードによる高可用性 Project environments, extensions and deletionInstances & Console
インスタンスの作成 インスタンスの再起動、停止、削除 ステージ間でのブランチのマージ Web IDE とリモートアクセス SSH access to instances インスタンス設定の説明 デプロイとジョブキューAgent Tasks
エージェントタスクとは エージェントタスクの設定 タスクの実行と結果の確認 エージェント時間と追加購入 Agent insights and task filtersMonitoring & Backups
インスタンスのモニタリング バックアップと復元 S3 storage, uploads and bulk backup actions アラート通知(メールと SMS)Workspaces & Permissions
ワークスペースメンバーの招待 メンバーの権限とリソースへのアクセス メンバーがリソースを表示または使用できない Audit log and server activityAccount & Security
二要素認証(2FA) プロフィールと連携の設定 パスワードとアカウントの復旧 Instance security score and checks The Security page: every instance and member at a glanceBilling & Plans
プランと料金 アップグレードとサブスクリプションの管理 プロジェクトのサブスクリプションが未払いの場合 チャネルパートナープログラム Onboarding a client as a partnerSupport & Tickets
サポートチケットの作成 CICDoo チームのサポートを受けるTroubleshooting
トラブルシューティング: サーバーを接続できない トラブルシューティング: デプロイが失敗した トラブルシューティング: リポジトリ移動後に git push が 403 で失敗する トラブルシューティング: インスタンスが停止している、または遅い トラブルシューティング: ドメインまたは SSL の問題プロジェクトと Git
アプリノードによる高可用性
データベースを実行するプライマリプロジェクトと、それを提供するアプリノードで、1 つの本番 Odoo データベースを複数のサーバーで動かす方法を説明します。
仕組み
高可用性を使うと、1 つの Odoo データベースの本番環境を複数のサーバーで同時に動かせます。あるサーバーが応答しなくなると、訪問者はほかのサーバーに振り向けられます。
クラスターは、同じコードを実行するプロジェクトで構成されます:
- プライマリ: 本番インスタンスが Odoo とデータベースを実行するプロジェクトです。そのデータベースはアプリノードにだけ公開され、それ以外には公開されません。
- アプリノード: それぞれ別の本番サーバー上にあるほかのプロジェクトで、本番インスタンスは Odoo だけを実行し、プライマリのデータベースを使います。
- レプリカ:プライマリのデータベースのスタンバイコピーを自身のサーバーにも保持するアプリノード。プライマリが失われたときに引き継ぐ準備ができています。
訪問者はプライマリのアドレスを使います。CICDoo はそのアドレスをプライマリと応答しているすべてのアプリノードに向け、数分ごとに各ノードを確認します。応答しなくなったノードは、回復するまでアドレスから外されます。
データベース自体は 1 台のサーバー、つまりプライマリのサーバーで動作します。アプリノードは Odoo 側を冗長化します。データベースも保護するには、レプリカを追加してください。プライマリのサーバーが失われた場合はレプリカを昇格させ、サイトはそのコピーから運用を続けます。下記の "レプリカとフェイルオーバー" を参照してください。
始める前に
- 同じコード: クラスター内のすべてのプロジェクトは、同じリポジトリ、デフォルトブランチ、Odoo のバージョン、エディションを使う必要があります。Time Machine がオンの場合は、固定されたコミットも一致している必要があります。
- 別々のサーバー: 各アプリノードには、プライマリやほかのノードとは異なる、専用の本番サーバーが必要です。
- Cloudflare プロキシ: ノード間でトラフィックを分散する機能は、現在 Cloudflare プロキシが有効なサーバーで動作します。アプリノードが返すすべてのページがプライマリのデータベースと通信するため、同じリージョンのサーバーを使ってください。
- 共有ファイルストア: クラスター内のすべてのサーバーは、Odoo のファイルストア用に同じ共有ストレージをマウントする必要があります。これがないと、あるノード経由でアップロードした添付ファイルがほかのノードにはなく、別のノードにたどり着いた訪問者はログアウトされます。設定に手助けが必要な場合はサポートにお問い合わせください。
- データベース接続: 各アプリノードは、プライマリのデータベースに独自の接続を開きます。ノードを追加するにつれて、プライマリの本番インスタンスのコンソールにある 設定 タブの PostgreSQL 設定 で max_connections を引き上げてください。
- レプリカの数:レプリカごとに専用の本番サーバーが必要です。PostgreSQL の既定設定では、1 つのプライマリで約 9 台のレプリカに供給でき、各レプリカは遅れている間、プライマリのディスク上に最大 20 GB の変更を保持させることがあります。
高可用性の設定は、プロジェクト設定 の 詳細設定 タブにある 高可用性 カードにあります。プロジェクトの設定を変更する権限が必要です。
プライマリを設定する
データベースを実行するプロジェクトを開き、プロジェクト設定 > 詳細設定 に移動して、高可用性 で 役割 を プライマリ(アプリ + データベース) に設定します。適用 をクリックして確定します。
本番インスタンスが再起動します。再起動後、そのデータベースはクラスターのアプリノードからの接続を受け付けます。サーバー同士がプライベートネットワークを共有していない限り、サーバー間の接続は暗号化されます。
本番インスタンスは、同梱の専用データベースを使う必要があります。本番インスタンスが外部データベースを指しているプロジェクトは、プライマリになれません。
アプリノードを追加する
通常どおりノード用のプロジェクトを作成します。同じリポジトリとデフォルトブランチ、同じバージョンとエディション、そして専用の本番サーバーを使います。そのプロジェクトにあるステージングと開発のインスタンスはすべて削除してください。アプリノードは本番だけを実行し、ステージングと開発のブランチはプライマリのプロジェクトに置きます。
次に、ノードの プロジェクト設定 > 詳細設定 を開き、役割 を アプリノード(プライマリのデータベースを使用) に設定し、データベースの提供元 でプライマリを選んで、適用 をクリックして確定します。選択肢に表示されるのは、同じワークスペースにあり同じコードを実行しているプライマリだけです。
ノードはすぐには起動しません。まずプライマリのサーバーがノードを許可する必要があり、これは次回の確認時に行われ、通常は 5 分以内です。それまでカードには "プライマリがこのノードを許可するのを待っています。" と表示され、許可されるとすぐにノードが自動で起動します。ノードが応答し始めて数分後に、訪問者を受け付け始めます。
プライマリでは、高可用性 カードにアプリノードの一覧と、データベースサーバーが現在のアクセスリストを適用済みかどうかが表示されます。
レプリカとフェイルオーバー
レプリカは、プライマリのデータベースのスタンバイコピーも実行するアプリノードです。プライマリはすべての変更をストリーミングで送るため、コピーの遅れは通常数秒程度です。レプリカ上の Odoo は、他のアプリノードと同様にプライマリのデータベースを使って訪問者に応答します。
追加するには、アプリノードとまったく同じ方法でプロジェクトを準備し、役割 を レプリカ(アプリノード + データベースのスタンバイコピー) に設定して、データベースの提供元 でプライマリを選び、適用 をクリックします。プライマリは PostgreSQL 13 以降(Odoo 15 以降の既定)で動作している必要があり、レプリカも同じ PostgreSQL バージョンを使う必要があります。参加すると、レプリカのプロジェクト自身のデータベースはコピーに置き換えられます。古いデータは削除されず、サーバー上の別の場所に退避されます。大きなデータベースでは最初のコピーに時間がかかります。
レプリカの 高可用性 カードにコピーの状態が表示されます。
- コピー中:最初のコピーを作成しています。
- 新しいプライマリに切り替え中:別のレプリカが昇格し、このコピーはそちらに切り替えています。既存のデータを保持したままなので、通常はすぐに終わります。
- ストリーミング中:コピーがプライマリに追従しています。
- 遅延中:コピーが数百 MB 以上遅れているか、一時的に追従を停止しています。
- 破損:コピーに必要な変更をプライマリがもう保持していません。コピーを再構築 をクリックして新しいコピーを作成してください。
プライマリのサーバーが失われた場合は、レプリカの 高可用性 カードを開き、プライマリに昇格 をクリックして、確認のためプロジェクト名を入力します。レプリカのデータベースがクラスターのデータベースになり、レプリカがプライマリになり、他のすべてのノードはそれに接続して再起動します。サイトのアドレスは変わりません。旧プライマリはアプリノードになります。サーバーが戻ると自身のデータベースなしで起動し、その形で再起動するまで訪問者を受け付けません。コピーが最後に追いついた後に旧プライマリで行われた変更は失われるため、プライマリを復旧できない場合にのみ昇格してください。昇格が自動で行われることはありません。他のレプリカはコピーを保持したまま、新しいプライマリに切り替わります。昇格したレプリカより先に進んでいたレプリカは、それに合わせて巻き戻され、それができない場合にのみデータベースを再コピーします。レプリカのカードに別のレプリカのコピーのほうが新しかったと表示された場合は、そちらを昇格してください。失う変更が少なくなります。
レプリカはプライマリの PostgreSQL 設定を使用します。プライマリの本番インスタンスの PostgreSQL 設定 を変更したら、レプリカを再起動してください。
レプリカから読み取る
Odoo 18 以降では、クラスター内のどのプロジェクトも読み取り専用の処理をレプリカに送れます。一覧とフォームのビュー、グループ化ビュー、レポート、エクスポートが対象です。書き込みはすべて引き続きプライマリに送られ、書き込みが必要だと分かったリクエストは自動的にプライマリで再実行されます。これによりプライマリのデータベースサーバーの負荷が下がります。
プロジェクトの プロジェクト設定 > 詳細設定 を開き、高可用性 カードの 読み取り専用クエリ でレプリカを選んで 適用 をクリックします。レプリカは自身のコピーから読み取ることもできます。レプリカが許可するとプロジェクトが再起動します。通常は 5 分以内です。
レプリカからの読み取りは、プライマリより少し遅れることがあります。レプリカが遅れたり、停止したり、破損したりすると、CICDoo は読み取り側に対してレプリカを閉じ、Odoo は再起動せずに自動でプライマリに戻ります。レプリカが再びストリーミングを始めてから約 30 分以内に、読み取りはレプリカに戻ります。
アプリノードで変わること
- 本番インスタンスには専用のデータベースがありません。データベースの設定は CICDoo が管理し、インスタンスの Odoo 設定では変更できません。
- スケジュールされたジョブ(Odoo の cron)はプライマリでのみ実行されます。
- バックアップはプライマリで取得されます。クラスターのデータベースのバックアップと復元は、プライマリのプロジェクトから行ってください。
- アプリノードのブランチにプッシュしても、それだけでは何も起きません。クラスターはプライマリから更新されます。
- アプリノードのコンソールでは、データベースシェル、バックアップ、PostgreSQL 設定が非表示になります。これらはプライマリにあります。レプリカはデータベースシェルを保持し、読み取り専用のコピーを開きます。
更新をデプロイする
いつもどおりプライマリのブランチにプッシュします。すると CICDoo がクラスター全体を順番に更新します:
- 各アプリノードを停止します。
- ほかのサーバーがデータベースを使っていない状態で、モジュールのアップグレードも含めてプライマリを更新します。
- 新しいコードで各アプリノードを再び起動します。
各ステップは、それが実行されるインスタンスの キュー タブで確認できます。プライマリの更新が失敗すると、アプリノードは再起動されず、そのキューのエントリに理由が表示されます。問題を修正して、もう一度デプロイしてください。
モジュールのアップグレードにはデータベースを占有する必要があるため、単一のインスタンスの場合と同じく、プライマリの更新中はサイトを利用できません。
クラスターから外れる
アプリノードを外すには、その 役割 を スタンドアロン(独自のデータベース) に戻し、適用 をクリックします。ノード自身のデータベースにはクラスターのデータがないため、本番インスタンスは停止します。再び起動する前に、バックアップを復元してください。
アプリノードが残っている間は、プライマリを変更できません。先にノードを外してください。
トラブルシューティング
- ノードが許可を待ち続ける: プライマリの本番インスタンスが実行中で、そのサーバーがオンラインであることを確認してください。プライマリになった後に一度再起動しないと、どのノードも許可されません。
- ノードは起動するが Odoo が立ち上がらない: ノードのログを開いてください。プライマリのデータベースが初期化されていないというメッセージがあれば、プライマリが最初の起動をまだ終えていません。
- アップロードやログインがノード間で訪問者についてこない: サーバーがファイルストアを共有していません。上の "始める前に" を参照してください。
- レプリカがコピー中のまま進まない:プライマリの本番インスタンスが動作しているか確認してください。プライマリがレプリカを許可するとコピーが始まり、キュー タブにあるレプリカの再起動で進行状況またはエラーを確認できます。
インスタンスとブランチの対応については ブランチとインスタンス を、別の機能であるサーバー単位のロードバランサー設定については ロードバランサーを使う を参照してください。
CICDoo で自社サーバー上で実行しましょう
サーバーを接続し、リポジトリを連携するだけ。デプロイ、バックアップ、監視は設定済みで、Odoo エンジニアにはメッセージひとつで相談できます。
まだ解決しませんか?アプリからチケットを作成するか、エンジニアに相談してください。