ガイド

機能ごとに 1 ページです。各ガイドはまず仕組みを説明する短い 仕組み の節から始まり、続いてその仕組みで実現できるタスクのコピーして使えるレシピが並びます。フラグやフィールドの網羅的な一覧が必要な場合は、関連項目 のリンクから CLI リファレンスとリファレンスのページへ進んでください。

Cornus を初めて使いますか? まずはクイックスタートを読み、その後ここへ戻って目的に合うレシピを探してください。複数の機能を組み合わせるエンドツーエンドのシナリオは、クックブックを参照してください。

ガイドを探す

サーバーをセットアップする

望みの構成でサーバーを動かします。ローカル (Docker、containerd、bare、Incus、またはクラスターを駆動)、SSH 経由のリモートホスト、クラスター内、コンテナとして。それぞれ短い手順書が一つずつあります。前提条件、コマンド、そしてうまくいったかの確認方法です。

イメージをビルドする

Dockerfile をビルドして同梱レジストリへプッシュし、ビルド引数を渡し、キャッシュ / シークレット / SSH マウントを使い、名前付きビルドコンテキストを追加します。リモートサーバー上で遅延転送付きのビルドを実行し、リモートビルドキャッシュをインポート、エクスポートし、ルートレスでビルドする方法も扱います。

ワークロードをデプロイする

Compose プロジェクトまたは直接記述したデプロイスペックを Docker ホスト、ベアメタルの containerd ホスト、Incus ホスト、Kubernetes にデプロイします。削除、切り離し、スケール、ロールアウト、ワークロード内でのコマンド実行、クライアントローカルディレクトリのマウント、公開・非公開ポートへの接続も扱います。

Compose、devcontainers、docker CLI

Compose プロジェクトの起動・停止、サービスの確認と再ビルド、複数の Compose ファイル / 環境変数ファイル / プロファイルの使用、Dev Container の実行、Docker API プロキシ経由で Cornus サーバーを操作する通常の docker CLI の使い方を説明します。

Compose の拡張と互換性

Compose サービスが宣言できる x-cornus-* フィールドとプロジェクトレベルの既定値の効き方、compose-spec の provider: サービス、up --watch が何をリロードするか、そして cornus と docker compose が同一でないフラグのすべて (実装済み、受け付けるが尊重しないもの、意図的に異なるもの) を説明します。

ブラウザー UI

cornus web がブラウザーに表示するもの。ファイルエクスプローラーのローカルルート、ブラウザーとターミナルを並べるタイル型ワークスペース、メトリクスダッシュボード、イングレスセクション、agent クライアントが操作する MCP エンドポイント、そして別のマシンから、あるいは一つのブラウザープロキシ設定で UI へ到達する方法を説明します。

リモートクラスターで作業する

コマンドの接続先をリモートサーバーに設定し、接続プロファイルを作成し、クラスター内のサーバーへ自動でポート転送します。自身の Kubernetes へのアクセス権から短期間有効な資格情報を発行し、コンテキストを切り替え、サーバー経由で通信をルーティングする方法も扱います。

サーバーをコンテナで実行する

サーバー自体を、管理対象の docker ホスト上のコンテナとして実行します。必要なバインドマウントとその理由、自身のパスとホストのパスの対応関係をどう判別するか、構成を確定する前に確認する方法、そしてコンテナ化されたサーバーからワークロードへ到達する方法を扱います。

ネットワークと conduit

セッションの conduit モードがポートごとの転送と 1 つの SOCKS5 スプリットトンネルプロキシをどう選ぶかを説明し、続いてローカルポートの転送、プロキシの実行、ブラウザーの設定 1 つで Compose スタック全体へ到達する方法、DNS なしでワークロードのイングレスホストへ到達する方法を扱います。

ワークロード間 hub

到達可能なネットワークを共有しないワークロードをつなぐスター型ハブの中継モデル、ポリシーの行列、複数レプリカのレジストリを説明し、続いて CLI からスポークとして参加する方法と、デプロイスペックでサービスをエクスポート / インポートする方法を扱います。

トンネル

サーバーがトンネルをホストする仕組みと各バックエンドに必要なものを説明し、続いて ngrok、SSH、Cloudflare、Tailscale の各バックエンドの段階的な設定手順を扱います。

イングレス

ホスト名の解決方法、ルーティングとサーバー側のドメインポリシーの仕組みを説明し、続いて Kubernetes バックエンドでワークロードに公開 HTTP(S) ホスト名を割り当てます。自動導出または明示的なホスト名、cert-manager による TLS、自前の証明書、パス / ポート / クラスに基づくルーティングを扱います。

エグレス

3 つのエグレスモードと 4 つの経路を説明し、続いて VPN、企業プロキシ、外部ネットワークから隔離されたクラスターで利用するために、ルートルールまたは PAC ポリシースクリプトを用いて、リモートワークロードの外向きトラフィックを呼び出し元のネットワーク経由でルーティングします。

資格情報

ソースバックエンド、配送方法、信頼のモデルを説明し、続いて LLM API キーや AWS STS の資格情報を含む、呼び出し元が発行したシークレットを、イメージ、仕様、Pod 仕様に埋め込まずにワークロードへ仲介します。

レジストリとストレージ

ファイルシステム、メモリ内、S3、GCS / Azure ストレージ上でレジストリを稼働させ、イメージをプッシュ、プルし、匿名プルを許可します。クラスターランタイムにレジストリを通知し、外部レジストリを使い、ガベージコレクションで領域を回収する方法も扱います。

セキュリティと認証

ベアラー検証と呼び出し元 ID の仕組みを説明し、続いてベアラートークンを必須にし、JWT を発行し、JWKS による検証を行い、ID ごとの認可を伴う mTLS を有効化します。書き込みを保護しつつ匿名プルを許可する方法も扱います。

オブザーバビリティ

OpenTelemetry のトレース、メトリクス、ログを有効にし、Prometheus /metrics エンドポイントを追加し、ログを設定し、liveness probe と readiness probe を構成します。あるいは組み込みストアを有効にして、自分のワークロード のログ、トレース、メトリクスを、検索可能かつコンテナより長く残る形で、バックエンドを一切運用せずに Grafana から照会できます。

出力モード

CLI の進捗と結果の表示形式を選びます。auto、fancy、plain、json (エージェントとスクリプト向けの NDJSON) と、色出力の制御を扱います。