> For the complete documentation index, see [llms.txt](https://livlog-llc.gitbook.io/engineering-handbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://livlog-llc.gitbook.io/engineering-handbook/riburoguno/5-development-operations/deployment-operations.md).

# デプロイ・運用一覧

## 目的

このページでは、リブログが運営する主なプロダクトについて、公開先、構成、デプロイ方法、データ更新方法、運用上の注意点を、外部公開できる範囲で整理します。

全体像を把握するための一覧であり、内部構成、接続先、認証情報、詳細な作業手順は記載しません。確認できていない項目やプロダクトごとに異なる項目は断定せず、詳細を各プロダクトまたは各リポジトリの文書で管理します。

## 一覧

| プロダクト                                                                                | 種別                | 公開先                                                             | 主な構成                                                                | DB                     | データ更新                                | デプロイ方法                                                     | 備考                                           |
| ------------------------------------------------------------------------------------ | ----------------- | --------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------- | ------------------------------------ | ---------------------------------------------------------- | -------------------------------------------- |
| [CotoGoto](/engineering-handbook/riburoguno/2-products/cotogoto-technology-stack.md) | Webサービス / API     | [Web](https://cotogoto.ai/)                                     | Java / Kotlinを中心としたWebアプリケーション、API、バッチ処理                            | RDB、ドキュメントDB           | 会話・作業記録などをアプリケーションから更新               | サーバーサイドの実行単位ごとにデプロイ。詳細はプロダクト側で管理                           | 外部連携を含むため、設定と秘密情報を分離する                       |
| [CHROCO](/engineering-handbook/riburoguno/2-products/chroco-technology-stack.md)     | Webサービス           | [Web](https://chroco.ooo/)                                      | Javaを中心としたWebアプリケーション                                               | RDB                    | タイムライン、ブックマークなどをアプリケーションから更新         | サーバーサイドWebアプリケーションとしてデプロイ。詳細はプロダクト側で管理                     | URL解析や画像保存などの外部連携に注意する                       |
| [旅旅](/engineering-handbook/riburoguno/2-products/tabi2auto-technology-stack.md)      | Webメディア / Webサービス | [Web](https://tabi2.lol/)                                       | Javaを中心としたWebアプリケーション、記事、地図、地域データ                                   | プロダクト側の文書で管理           | 記事、地点、ランキングなどを更新                     | 構成に応じてWebアプリケーションとコンテンツを公開。詳細はプロダクト側で管理                    | 外部データの利用条件と更新日を確認する                          |
| [季語彩集](/engineering-handbook/riburoguno/2-products/kiigo-saishu-technology-stack.md) | 静的Webアプリ / 辞書サイト  | [Web](https://kigosai.com/)                                     | Riot.js、@riotjs/route、Vite、Tailwind CSS、Flowbite、SCSS、Axios、外部季語API | リポジトリ内にはDBなし。外部API側で管理 | フロントエンド、外部API、季語データ、広告・計測設定を必要に応じて更新 | 静的ホスティングと相性のよい構成。`_redirects` はNetlify互換だが本番基盤はプロダクト側で確認する | 秘密情報をフロントエンドへ含めず、公開後のAPI接続、リダイレクト、広告・計測を確認する |
| その他のWebサービス                                                                          | Webサービス / アプリ     | [プロダクト一覧](/engineering-handbook/riburoguno/2-products.md)の関連URL | プロダクトにより異なる                                                         | プロダクトにより異なる            | アプリケーションまたはデータを更新                    | 詳細は各プロダクトで管理                                               | 外部公開用のため、内部構成の詳細は記載しない                       |
| 静的サイト / データ可視化                                                                       | 静的サイト             | GitHub Pages / Netlifyなど、プロダクトにより異なる                            | HTML / JavaScript / CSS / GeoJSON / CSVなど                           | 原則なし。要件により外部データを利用     | ファイル、記事、地図データなどを更新                   | Git pushまたはホスティングサービスの公開手順                                 | 地図、記事、可視化を小さく公開する用途と相性がよい                    |

## デプロイ方法を選ぶ基準

* 静的ファイルだけで実現できる場合は、静的ホスティングを優先する
* 認証、DB更新、秘密情報を使う外部API連携が必要な場合は、サーバーサイドを利用する
* デプロイ手順は再現可能にし、特定の担当者だけが分かる状態を避ける
* 本番用の認証情報はコードや文書に含めず、環境変数やSecretsで管理する
* 新しい公開方法は、小さな環境で更新と切り戻しを確認してから採用する

## データ更新時の確認

* データの取得元、利用条件、更新日を確認する
* 変換前のデータと公開用データの役割を分ける
* GeoJSON、CSV、JSONなど、再利用可能な形式を優先する
* DBを更新する場合は、必要に応じてバックアップと復旧方法を確認する
* 生成処理やAIを使った場合は、公開前に人間が内容を確認する
* 個人情報や非公開データが公開物へ混入していないことを確認する

## 運用上の共通確認

* 公開URL、独自ドメイン、SSL証明書の有効性
* デプロイとデータ更新の最終実施日
* 外部API、地図、画像、ホスティングサービスの仕様や利用条件
* バックアップと切り戻しの必要性
* エラーログや通知の確認方法
* 利用している依存関係の更新必要性
* 公開物に秘密情報や個人情報が含まれていないこと

この一覧は、プロダクトの追加や公開方法の変更に合わせて更新します。詳細手順は各プロダクト側で管理し、このページには比較と判断に必要な概要だけを残します。