Orizm CLI
Orizm CLI(orizm)は、Orizm のプロジェクトをターミナルから操作する開発者向けのコマンドラインツールです。スキーマの適用、SDK の型生成、コンテンツ・APIキー・ユーザー・バケット・Webhook の管理までを、ひとつのコマンドで扱えます。
npm install --save-dev @orizm/cliインストールすると orizm コマンドが使えます。パッケージマネージャー経由で実行する場合は pnpm exec orizm ... や npx orizm ... のように呼び出します。
v2 から移行する場合は、コマンド体系と認証方式が変わっています。CLI移行ガイド (v2→v3) を参照してください。
基本的な流れ
Orizm CLI は「認証する → ディレクトリをプロジェクトにリンクする → 操作する」の 3 ステップで使います。
- 認証 —
orizm auth loginでブラウザからサインインします。CI など自動化環境ではORIZM_API_KEYを使います。詳しくは 認証 を参照してください。 - リンク —
orizm linkで、作業ディレクトリを操作対象のプロジェクトに結び付けます。以降のコマンドはこのプロジェクトを既定の対象にします。詳しくは プロジェクトのリンク を参照してください。 - 操作 —
orizm schema pushやorizm content listなど、目的のコマンドを実行します。
はじめて使うときは クイックスタート が最短経路です。
コマンドの全体像
コマンドは orizm <名詞> <動詞> の形に統一されています(例: orizm schema push、orizm key consumer list)。各カテゴリーの詳細は コマンドリファレンス を参照してください。
| カテゴリー | コマンド | 用途 |
|---|---|---|
| auth | orizm auth login / logout / status | サインインとセッション確認 |
| link | orizm link | ディレクトリとプロジェクトの結び付け |
| org | orizm org list | 所属組織の一覧 |
| project | orizm project list / get / create / update / delete | プロジェクトのライフサイクル |
| schema | orizm schema push / list / get / validate / erd | スキーマ定義の適用と参照 |
| codegen | orizm codegen cms / consumer | SDK 型コードの生成 |
| key | orizm key consumer ... / orizm key management ... | APIキーの管理 |
| project-user | orizm project-user ... | プロジェクトユーザー(RBAC)の管理 |
| content | orizm content list / get / create / update / delete | テーブルコンテンツの操作 |
| bucket | orizm bucket list / orizm bucket object ... | バケットとオブジェクトの操作 |
| webhook | orizm webhook list / get / create / update / delete | Webhook の管理 |
グローバルフラグ
すべてのコマンドで次のフラグが使えます。
| フラグ | 説明 |
|---|---|
--json | 結果を機械可読な JSON で標準出力に出します。 |
--debug | デバッグログを標準エラー出力に出します(環境変数 ORIZM_DEBUG でも有効化できます)。 |
--no-color | カラー出力を抑制します(環境変数 NO_COLOR も尊重します)。 |
プロジェクトを対象とするコマンドでは、対象を一時的に切り替える --project <name> も使えます。出力の扱いやスクリプトでの利用については 出力とスクリプティング を参照してください。
Last updated on