ソース開発とイメージビルド

開発環境を開始

Node.js 24+、pnpm 10.34.6、Docker Engine / Compose、rsync、mkcertを準備します。 リポジトリのルートから実行します:

pnpm install --frozen-lockfile
pnpm dev:prepare
pnpm dev

pnpm dev:prepareサービスを開始し、イメージやヘルプセンターを構築し、既存設定を保持しながら開発データベースを初期化します。 最初のランでは地元のCA mkcert信頼を求めることがあります。 pnpm devウォッチャーとログを接続します。pnpm dev:stop開発スタックを止めます。

デフォルトアドレス:Web http://localhost:18172 / https://localhost:18173、API http://localhost:4000、Runner http://localhost:4010。 ランチャーが報告した実際のアドレスを使いましょう。

ソースの入口

• ウェブワークスペースと管理
• API、権限、ビジネスロジック
• ランナーとタスクワーカー

建築、リポジトリ開発ガイド、貢献ガイドをご覧ください。 変更を提出する前に、影響を受けたテスト、タイプチェック、リント、ビルドを実行してください。

ソースからDockerイメージを構築する

docker compose --env-file .env.example build \
  migrate api runner runner-worker-image web

API Dockerfileはruntimeおよびmigrationターゲットを提供します。ランナーはcontrollerと、workerを提供します。 マルチアーキテクチャイメージの場合は、適切なDockerfileとターゲットを合わせたdocker buildx build --platform linux/amd64,linux/arm64を使用します。 通常の生産環境ではダイジェストピン留めの公開画像を好む。 メンテナーのgit production runbook(Git)プロダクションランブックは別のソースビルドワークフローをカバーしています。