Guides

Guides

「目的から引ける」ハウツー集。dip/Homebrew/Rails Guidesのような、タスク志向のページ群のインデックス。将来的にはページを分割してもよい。

Outline

• dip からの移行
  • interaction: はそのまま使える（primary spelling が dip と同じ）
  • commands: エイリアスとの違い、両方書くとエラーになる点
  • dip の機能で wip がまだカバーしていないもの（Roadmapのwip provisionなど）
• Docker Compose ユーザー向けガイド
  • compose.yml をそのまま使う2つの道（mode: compose vs mode: compose-native）の選び方
  • compose-native がサポートしないCompose機能（health check, 長形式volumes, スケーリング等）と回避策
• 起動が遅い場合の対処（bind mount問題）
  • 症状の見分け方（--debugログでCPU/メモリが低いのに固まって見える）
  • 原因（virtiofs経由のbind mountとZeitwerk等の多数stat/open）
  • sync: ブロックの導入手順（最小構成 → 除外パターンのカスタマイズ）
  • sync.build で専用rsyncイメージを用意する例
• 常時sync運用（wip sync --watch）
  • 2ターミナル運用（wip up -d + wip sync --watch）のワークフロー
  • 逆方向書き込み（コンテナ→ホスト）が消える注意点とexclude/delete: falseでの回避
• 落ちたコンテナの自動復帰（wip up --watch）
  • restart: の設定例
  • イベントベースではなくポーリングであることの限界（他ターミナルでのwip stopとの競合）
• マルチアーキ対応イメージの用意（CPU architecture mismatch対応）
  • docker buildx での multi-arch ビルド例
• CI/自動化での wip 利用（構想）
  • 非TTY環境での挙動、--no-interactiveの使い所