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

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_KEYPOSTGRES_PASSWORDALLOWED_HOSTSなどの値が必要です。動画チュートリアルにあるサンプルパスワードをそのまま使用しないでください。

Tandoor 2ではコンテナ構成が変更されている

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

まずバックアップしてから更新する

アップストリームで案内されている現在の更新手順は次のとおりです。

docker compose down
docker compose pull
docker compose up -d

ただし、最初にリリースノートを確認してください。Tandoorでは、マイグレーション後にサポートされたデータベースのダウングレード手段はないと警告しています。

家族が遠隔アクセスする場合はHTTPSを使用する

LAN外からレシピにアクセスする必要がある場合は、アプリケーションのポートを直接転送するのではなく、認証付きHTTPSまたはプライベートなリモートアクセス経由でTandoorを公開してください。

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

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

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

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

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

2つ目の復旧手段としてレシピをエクスポートする

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

よくある質問

TandoorはまだBigBearCasaOSにありますか?

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

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

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

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

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

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

LAN内だけで使用する場合は必要ありませんが、リモートアクセスにはHTTPSとプロキシの利用が推奨されます。