CLI リファレンス
cornus は、小さな OCI レジストリ、プロセス内の BuildKit ベースビルドエンジン、命令的デプロイエンジンをまとめた単一バイナリです。同じバイナリがサーバーとして動作し、ワークロードのビルド、プッシュ、デプロイ、到達を行うクライアントにもなります。
sh
cornus [global flags] <command> [command flags]コマンドツリーは kong で解析されます。組み込みの使用方法は cornus --help または cornus <command> --help で確認してください。
グローバルフラグ
これらのフラグはルートコマンドにあり、すべてのサブコマンドに適用されます。
| フラグ | 環境変数 | 既定値 | 説明 |
|---|---|---|---|
--data-dir | CORNUS_DATA | プラットフォームのデータディレクトリ | 永続データディレクトリ (レジストリ CAS + ビルドキャッシュ)。 |
--context | CORNUS_CONTEXT | 現在のコンテキスト | cornus クライアント設定で使う接続プロファイル (cornus configを参照)。設定の現在のコンテキストを上書きします。 |
--config-file | CORNUS_CONFIG | プラットフォームのユーザー設定ディレクトリ | cornus クライアント設定ファイルへのパス。$XDG_CONFIG_HOME を尊重するプラットフォームのユーザー設定ディレクトリが既定です。 |
--output | CORNUS_OUTPUT | auto | 出力レンダリング: auto、plain、fancy、json。出力モードを参照。 |
--context-file | CORNUS_CONTEXT_FILE | 自動検出 | 明示的なプロジェクトコンテキスト上書きファイル (JSON、YAML、TOML の bare Context)。指定しない場合、Cornus は上方向に cornus-context.{json,yaml,toml} を検索します。 |
--no-context-file | — | false | プロジェクトコンテキストの自動検出を無効にします。--context-file とは併用できません。 |
--trust-context-file | CORNUS_TRUST_CONTEXT_FILE | false | 自動検出したプロジェクトコンテキストファイルの endpoint、資格情報、TLS フィールドを許可します。信頼できる作業ツリーでのみ使用してください。 |
--no-color | — | false | 装飾付き出力の色を無効にします (レイアウトは維持)。NO_COLOR / CLICOLOR=0 でも有効です。 |
--output の値は次のとおりです。
auto- 端末では fancy、それ以外ではプレーン。plain- 決定的で色なし。fancy- 色とレイアウト。json- 機械可読な NDJSON。
完全な動作は出力モードを参照してください。
コマンド
| コマンド | 説明 |
|---|---|
cornus serve | cornus サーバー (レジストリ + ビルド + デプロイ) を実行します。 |
cornus build | コンテキストからイメージをビルドしてプッシュします。 |
cornus push | ローカルイメージをレジストリへプッシュします。 |
cornus deploy | デプロイスペックを適用します。 |
cornus exec | cornus サーバーを通じ、デプロイメント内でコマンドを実行します (docker exec)。 |
cornus port-forward | ローカル TCP ポートをデプロイメントのコンテナポートへ転送します。 |
cornus socks5 | 名前でワークロードへ到達するローカル SOCKS5 スプリットトンネルプロキシを実行します。 |
cornus tunnel | ホスト型トンネルによりデプロイメントのポートをパブリックインターネットへ公開します。 |
cornus ingress-tunnel | デプロイメントまたは Compose プロジェクトで宣言した ingress を単一のパブリックトンネルで公開します。 |
cornus config | リモート cornus サーバーへ到達するための接続プロファイル (コンテキスト) を管理します。 |
cornus setup | サーバー接続を対話形式で設定して検証します。 |
cornus auth | 短時間有効なクライアントセッション用の SSH 公開鍵を登録して管理します。 |
cornus compose | Compose / devcontainer プロジェクト向けの Docker Compose 互換クライアントです。 |
cornus web | ブラウザー UI とクライアント側 BFF を提供します (既定はループバック)。 |
cornus daemon | Docker API フロントエンドと統合バックグラウンドエージェントの制御です。 |
cornus hub | ワークロード間オーバーレイに spoke として参加します。 |
cornus activity | サーバーのアクティビティフライトレコードを読み取ります。 |
cornus storage | レジストリストレージを調査して移行します。 |
cornus observe | 保存済みのワークロードログ、トレース、メトリクスを照会します。 |
cornus token | bearer auth を持つサーバー向けの JWT を発行します。 |
cornus version / cornus health | cornus のバージョンを表示するか、実行中サーバーの health エンドポイントを確認します。 |