メインコンテンツへスキップ

qumod CLI

qumod を使うと、Qumo Deploy をターミナルから操作できます。コンソールでできることは コマンドラインでもできます。プロジェクトの作成、署名鍵の発行と失効、メンバーの招待、 使用量・請求・監査ログの確認などです。dev プロジェクト用に、自分のマシンでリレーを 動かすこともできます。 macOS、Linux、Windows 向けの単一の自己完結型バイナリで、ほかに何もインストールする 必要はありません。また、CI、スクリプト、コーディングエージェントなど、無人での実行を 前提に作られています。 チームに共有できる簡単な紹介は qumo-deploy.com/cli/qumod をご覧ください。

クイックスタート

1

インストール

インストーラーはダウンロードしたファイルをリリースの SHA256SUMS と照合し、 sudo は不要です。続いて新しいターミナルを開き、qumod が PATH に入った状態にします。 macOS と Linux では、その前にインストーラーが表示する export PATH=… の行をシェルの プロファイルに追加してください。インストーラーをもう一度実行すると最新リリースに 更新されます。バージョンの固定や手動ダウンロードについては インストール を参照してください。
2

サインイン

ブラウザでコンソールのデバイスページが開きます。ターミナルに表示されたコードを入力し、 承認してください。CI ではこの手順を省き、代わりに QUMO_TOKEN を設定します (認証 を参照)。
3

最初のコマンドを実行する

組織など省略した項目は、ターミナルに表示される一覧から選べます。

できること

プランや支払い方法の変更はコンソールで行います。各コマンドのフラグは コマンドリファレンス に記載されており、qumod help <command> でターミナルに 表示することもできます。

例

Free プランでは、dev プロジェクト用のリレーを自分で動かします。1 つのコマンドで署名鍵も 含めてセットアップし、もう 1 つのコマンドで起動します(Docker は不要です)。

自動化のための設計

  • --json は結果を 1 行に 1 ドキュメントの JSON として stdout に、エラーを stderr に出力します。
  • QUMO_TOKEN(または --token)を使うと、ブラウザなしでパーソナルアクセストークンにより認証します。
  • ターミナルがなければプロンプトを出しません。 --yes、--json を指定した場合や TTY がない場合、引数が足りないとプロンプトではなく使用法エラー(終了コード 2)になります。
GitHub Actions のワークフローは CI/CD とコーディングエージェント を参照してください。

ドキュメント一覧

インストール

インストーラー、バージョンの固定、手動ダウンロード、更新とアンインストール。

認証

qumod login によるブラウザでのサインイン、または CI やエージェント向けのトークン。

コマンドリファレンス

すべてのコマンド、フラグ、例。

CI/CD とコーディングエージェント

GitHub Actions と GitLab CI のレシピ、JSON 出力、終了コード。