コミュニティソリューション

BigBearを使ってCasaOSにTandoor Recipesを安全にインストールする

A 2024 BigBearCasaOS tutorial showed Tandoor on CasaOS; the maintained BigBear store now lists a current Tandoor 2 package.

Tandoor Recipesは、保守されているBigBearCasaOSストアで現在も利用でき、現在のパッケージでは2024年の古いチュートリアルの状態とは異なり、上流のTandoorコンテナを使用しています。 BigBearでは現在、ghcr.io/tandoorrecipes/recipesを使用するTandoor 2.6.9が掲載されています。

信頼できるデプロイのため、Postgresデータベースとメディア/設定データを保護し、実際に使うシークレットキーと許可ホストを設定してください。Tandoorのデータベースマイグレーションは簡単にはダウングレードできないため、アップグレード前に上流のリリースノートを確認してください。

現在のBigBearパッケージを使用

保守されているBigBearCasaOSアプリストアには現在のTandoorパッケージが掲載されており、2024年の動画だけを参照するより確かな情報源です。

Tandoorが公式に推奨するDocker Compose

現在のTandoor Dockerガイドでは、Docker/Composeが公式に保守され、定期的にテストされているインストール方法とされています。

データベースを保護

本番環境のTandoorでは、推奨Compose構成でPostgreSQLを使用します。データベースのボリュームは永続ストレージに置き、アップグレード前にバックアップしてください。

レシピのメディアを保護

レシピ画像やアップロードしたメディアもデータの一部です。CasaOSのマニフェストで、メディアや静的ファイルのパスが永続化されていることを確認してください。使い捨てのコンテナファイルシステム内だけに保存しないでください。

強力なシークレットを設定

上流の設定では、SECRET_KEY、POSTGRES_PASSWORD、ALLOWED_HOSTSなどの値が必要です。動画チュートリアルの例示パスワードをそのまま使わないでください。

Tandoor 2でコンテナ構成が変更

Tandoor 2はWebコンテナ内にnginxを含み、内部でポート80を公開します。そのため、Tandoor 1のgunicorn/media構成を説明する古いチュートリアルは誤解を招く場合があります。

最初にバックアップを取ってから更新する

上流プロジェクトが案内している現在の更新手順は次のとおりです。

docker compose down
docker compose pull
docker compose up -d

ただし、先にリリースノートを確認してください。Tandoorによると、マイグレーション後にサポートされるデータベースのダウングレード方法はありません。

家族がリモートからアクセスする場合はHTTPSを使用

レシピにLAN外からアクセスする必要がある場合は、アプリケーションのポートをそのままポートフォワードせず、認証付きHTTPSまたはプライベートなリモートアクセスを介してTandoorにアクセスできるようにしてください。

Dockerのデプロイガイドは、CasaOSのカスタムアプリやコミュニティアプリにも適用されます。

レシピをインポートする前に初回起動を確認

初回起動時は、データベースのマイグレーションが完了するまで待ちます。UIが表示されない場合は、WebコンテナとPostgreSQLのログを確認してください。マイグレーションの実行中に、コンテナを何度も作り直さないでください。

専用のホストポートを使用

Tandoor 2は、Webコンテナに同梱されたnginxを通じてHTTPを提供します。CasaOSや別のアプリが選択したホストポートをすでに使用している場合は、Tandoorの内部ポートを編集せず、ホスト側のポート割り当てのみ変更してください。

第2の復旧手段としてレシピをエクスポート

データベースのバックアップが主な復旧手段ですが、レシピを定期的にエクスポートしておけば、アプリケーションのデータベースが破損した場合にコンテンツを復元する別の方法になります。エクスポートしたファイルは、同じコンテナスタックの外に保管してください。

よくある質問

Tandoorは現在もBigBearCasaOSにありますか?

はい。現在のリポジトリにはTandoor 2.6.9が掲載されています。

Tandoorではどのデータベースを使うべきですか?

公式のCompose構成ではPostgreSQLを使用します。

新しいイメージを取得して更新できますか?

はい。ただし、先にバックアップを取り、リリースノートを確認してください。データベースのマイグレーションは元に戻せない場合があります。

リバースプロキシは必要ですか?

LAN内のみでの使用には向きませんが、リモートアクセスにはHTTPS/プロキシの利用をおすすめします。