oblien/openship：README に基づく導入ガイド

oblien/openship の README はプロジェクトを「Self-hosted deployment platform」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「README」には次の説明があります。Open-source, self-hostable deployment platform with built-in CI/CD. Point it at a repo , it builds, ships, routes, and TLS-terminates your app. Drive it from a desktop app, web dashboard, or CLI.。これは範囲の説明であり、本番検証の結果ではありません。

README の「Team / always-on , self-hosted server」にある内容から、用途が合うかを先に判断できます。Everywhere else → bare mode (macOS, Windows, or Linux without Docker). A single lightweight process with an embedded database , an always-on control plane that deploys apps out to a server (SSH) or Cloud, like the desktop app but always on。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。On Linux with Docker → Compose mode (the default). Brings up the full stack , Postgres, Redis, API, dashboard, and a containerized OpenResty edge on :80/:443 , from published images.。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「Quick Start」など複数の箇所に分かれています。確認できる情報は次の通りです。| If you're… | Run Openship as | Where your apps run | |---|---|---| | Solo, one machine, no ops | Desktop app | A server you connect over SSH, or Openship Cloud | | A team , or you want push-to-deploy / to host apps on your own box |。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 curl -fsSL https://get.openship.io | sh # install (or: npm i -g openship) openship # guided setup, then control panel 実行可能なコマンドがない場合は手順を作らず、「Solo , desktop app」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「Quick Start」には> [!TIP] > Solo? Use the desktop app. It runs Openship's control plane on your own machine only while the app is open , nothing is left running on an always-on server, nothing is exposed publicly.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはDesktop app , full GUI, real-time logs, one-click everything. Best for solo.ともあります。