One Server

ドキュメント · リファレンス

CLI(oneend)

ターミナルや CI からプロジェクトを操作します。164 個のコマンドは CLI のコマンド定義(packages/cli/src/commands)からそのまま読み取られ、この一覧になります。 この一覧はサーバーのコードから生成されます。新しい機能ができると、すぐにここにも表示されます。

コマンドラインツール(oneend)

Supabase CLI や Vercel CLI のように、ターミナルと CI からこのプラットフォームを扱うツールです。同じトークンで /api/v1 を呼び出します。

npm install -g oneend        または npx oneend <コマンド>
oneend login                 コンソールのアカウント → API · MCP トークンで作ったトークンを入力します
oneend link                  このフォルダーをプロジェクトに接続します(.oneend/project.json)
oneend projects list|create        oneend status
oneend env ls|pull|push|set|rm     oneend deploy [--branch --commit | --dir --prod --prebuilt]
oneend deployments ls|inspect      oneend logs [--follow]     oneend rollback <id>
oneend functions ls|deploy|rm|invoke|download
oneend migration new|list|repair   oneend db push|pull
oneend gen types typescript
oneend branches list|create|merge|reset|delete
  • トークンは ~/.config/oneend/config.json に、本人だけが読めるように(0600)保存します。CI では ONEEND_TOKEN 環境変数を使ってください。
  • マイグレーションファイルは oneend/migrations/<バージョン>_<名前>.sql で、db push が blackwall://migrations の apply_migrations を呼び出します。
  • --json を付けると、すべてのコマンドが JSON ひとかたまりで答えます。失敗すると0以外の終了コードを返します。
  • deploy はビルドが終わるまでログを表示し、失敗すると終了コード1になります。
  • リポジトリがないとき、または --dir か --upload を付けると、deploy はフォルダーを圧縮してアップロードし、同じビルドを通ります(.gitignore と .oneendignore に従い、node_modules と .git は除きます)。--prebuilt はビルドせずそのまま、--prod は本番へデプロイします。

コマンドリファレンス

インストール

Node 22 以降で動作し、依存関係はありません。

npm install -g oneend
oneend login --token bwk_… --api-url https://end.blackall.ai
oneend link --project abcdefghijklmnopqrst

共通オプション

すべてのコマンドで使えます。

オプション値説明
--json結果を JSON で出力します(スクリプト向け)
--help, -hヘルプ
--project, --project-ref<ref>関連付けたプロジェクトの代わりにこのプロジェクトを使います(ONEEND_PROJECT_REF)
--api-url<url>API アドレス(ONEEND_API_URL、既定 https://end.blackall.ai)
--token<トークン>保存したトークンの代わりにこのトークンを使います(ONEEND_TOKEN)

アカウント

使い方説明
oneend loginトークンを確認して保存します
oneend logout保存したトークンを削除します
oneend whoami今のトークンの持ち主と権限を表示します

oneend login

トークンを確認して保存します

使い方

oneend login [--token <トークン>] [--api-url <url>]

トークンはコンソールのアカウント、API と MCP トークン(/account/tokens)で作成します。
--token がなければターミナルで尋ね、ターミナルでなければ標準入力から読みます:
echo "$TOKEN" | oneend login
トークンは ~/.config/oneend/config.json に本人だけが読めるように(0600)保存します。

オプション

このコマンド独自のオプションはありません。

oneend logout

保存したトークンを削除します

使い方

oneend logout

トークンそのものは無効にしません。無効化はコンソールの /account/tokens で行います。

オプション

このコマンド独自のオプションはありません。

oneend whoami

今のトークンの持ち主と権限を表示します

使い方

oneend whoami

オプション

このコマンド独自のオプションはありません。

プロジェクト

使い方説明
oneend projects listプロジェクトの一覧
oneend projects createプロジェクトを新しく作成します
oneend projects transferプロジェクトを別の組織へ移管します(--to なしでは移管できる組織を表示します)
oneend projects pauseプロジェクトを一時停止します(データはそのまま)
oneend projects resume一時停止したプロジェクトを再開します
oneend linkこのフォルダーをプロジェクトに関連付けます
oneend unlinkこのフォルダーとプロジェクトの関連付けを解除します
oneend statusログイン、関連付けたプロジェクト、最新のデプロイ、マイグレーションをまとめて表示します
oneend billing1か月分の請求書: 項目ごとの金額、定価、請求額
oneend server-sizesサーバーサイズとリージョン別の月額
oneend projects archiveデータベースのアーカイブ状態(移す日、削除する日)
oneend projects archive restoreアーカイブしたデータベースを復元します
oneend projects archive downloadアーカイブをダウンロードするアドレスを作成します(1 時間)

oneend projects list

プロジェクトの一覧

使い方

oneend projects list

オプション

このコマンド独自のオプションはありません。

oneend projects create

プロジェクトを新しく作成します

使い方

oneend projects create <名前> [--region <コード>] [--org <組織>] [--tier <サイズ>] [--repo <owner/name>] [--root <フォルダー>] [--branch <ブランチ>] [--link] [--no-wait]

コンソールの新規プロジェクト画面と同じです(MCP create_project)。リージョン、専用サーバーのサイズ、GitHub リポジトリを一度に決めます。
--tier は oneend server-sizes が示すサイズコード(例: 4gb)か default(プランの標準サイズ)です。省略すると共用サーバーで始まり、サーバーの申請が断られてもプロジェクトは作成されます。
--repo は GitHub App から見えるリポジトリです。プロジェクトの作成直後に接続して最初のデプロイを始め、--no-wait でなければビルドが終わるまでログを表示します。
モノレポでは --root でアプリのフォルダを、--env-file で環境変数を一緒に渡します。

引数 1 個

オプション

オプション値説明
--region<コード>リージョン。作成後は変更できません(空なら既定のリージョン)
--org<組織>作成する組織の名前または id(空なら作成できる最初の組織)
--tier<サイズ>このプロジェクト専用サーバーのサイズ(例: 4gb、または default)。空なら共用サーバー
--repo<owner/name>プロジェクトの作成と同時に接続してデプロイする GitHub リポジトリ
--root<フォルダー>アプリのフォルダー(例: apps/web)。なければリポジトリの最上位
--branch, -b<ブランチ>プロダクションブランチ。なければリポジトリの既定ブランチ
--app<アプリ 名前>アプリ名。なければフォルダー名、それもなければリポジトリ名
--framework<名前>フレームワーク。省略すると自動で検出します
--build-command<コマンド>ビルドコマンドを上書きします
--install-command<コマンド>インストールコマンドを上書きします
--output-directory<フォルダー>出力フォルダを上書きします
--env-file<パス>リポジトリの接続時に一緒に保存する .env ファイル
--sensitive.env の値は保存後に再表示しません
--link作成したプロジェクトをこのフォルダーに関連付けます
--waitリポジトリを接続した場合、ビルドが終わるまでログを表示します(既定はオン、--no-wait でオフ)
--timeout<秒>待つ最長時間(既定 1800 秒)

oneend projects transfer

プロジェクトを別の組織へ移管します(--to なしでは移管できる組織を表示します)

使い方

oneend projects transfer [<ref>] [--to <組織 id または 名前>] [--yes]

現在の組織のオーナーであり、受け取る組織のオーナーか管理者である必要があり、受け取る組織のプランにプロジェクトの空きが必要です。移管後の使用量は受け取る組織に請求され、今月の請求は移管した時点で分かれます。元の組織のメンバーに個別に与えたアクセスはなくなります。アドレス、キー、データ、デプロイはそのままです(コンソールのプロジェクトの移管、MCP transfer_project と同じです)。

引数 0〜1 個

オプション

オプション値説明
--to<組織 id または 名前>受け取る組織。省くと移管できる組織を表示します
--yes, -y確認せずに進めます

oneend projects pause

プロジェクトを一時停止します(データはそのまま)

使い方

oneend projects pause [--project <ref>]

サイト、API、関数は 503 を返し、予約ジョブと新しいデプロイが止まります。oneend projects resume ですぐに再開します。

オプション

このコマンド独自のオプションはありません。

oneend projects resume

一時停止したプロジェクトを再開します

使い方

oneend projects resume [--project <ref>]

無料プランで 3 日間使われずに停止したプロジェクトも、このコマンド(または新しいデプロイ)で再開します。

オプション

このコマンド独自のオプションはありません。

oneend status

ログイン、関連付けたプロジェクト、最新のデプロイ、マイグレーションをまとめて表示します

使い方

oneend status

オプション

このコマンド独自のオプションはありません。

oneend billing

1か月分の請求書: 項目ごとの金額、定価、請求額

使い方

oneend billing [--period <YYYY-MM>]

オプション

オプション値説明
--period<YYYY-MM>請求期間(空なら今月、UTC)

oneend server-sizes

サーバーサイズとリージョン別の月額

使い方

oneend server-sizes [--region <コード>] [--currency KRW|USD]

通貨を空にすると組織の決済通貨です。ウォンは付加価値税込み、ドルは決済時に税金が加わります。
準備中のリージョンはまだ選べません。

オプション

オプション値説明
--region<コード>このリージョンだけを表示します(空ならすべてのリージョン)
--currencyKRW|USD通貨(空なら組織の決済通貨)

oneend projects archive

データベースのアーカイブ状態(移す日、削除する日)

使い方

oneend projects archive [--project <ref>]

データベースを使えない状態が 90 日続くとアーカイブストレージへ移し、1 年間復元できます。oneend projects archive restore で復元します。

オプション

このコマンド独自のオプションはありません。

oneend projects archive restore

アーカイブしたデータベースを復元します

使い方

oneend projects archive restore [--project <ref>]

アーカイブしたときのまま作り直します。通常は数分で、一時停止中のプロジェクトは復元と同時に再開します。お支払いが完了していないときや無料プランでは拒否します。

オプション

このコマンド独自のオプションはありません。

oneend projects archive download

アーカイブをダウンロードするアドレスを作成します(1 時間)

使い方

oneend projects archive download --reason <理由> [--project <ref>]

pg_dump 形式です。pg_restore でどの PostgreSQL にも復元できます。理由はアクセス記録に残ります。

オプション

オプション値説明
--reason<理由>ダウンロードする理由(アクセス記録に残ります)

環境変数

使い方説明
oneend env ls環境変数の一覧
oneend env pull環境変数を .env ファイルにダウンロードします
oneend env push.env ファイルの変数を保存します
oneend env set変数を 1 つ保存します
oneend env rm変数を削除します

oneend env ls

環境変数の一覧

使い方

oneend env ls [--target <production|preview>] [--app <アプリ 名前>]

機密の値は読み戻せず、末尾 4 文字だけが表示されます。
自動で入る変数(SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY など)も入る場所と一緒に表示されます。SUPABASE_SERVICE_ROLE_KEY は実行中のサーバー・ミドルウェア・関数にだけ入り、ビルドには入りません。DATABASE_URL・POSTGRES_URL・DIRECT_URL は、データベースのパスワードを本番デプロイに渡しているあいだだけ本番の実行時に入ります。MYSQL_* と WORDPRESS_DB_* は、MySQL データベースがあるときに実行時に入ります。同じ名前で保存すると、保存した値を使います。
--json では自動で入る変数が "automatic": true 付きで最後に続きます。

オプション

オプション値説明
--target, -t, --environment<production|preview|development>どの環境の変数か。複数回指定するかカンマで複数(既定は preview)。development は oneend dev と env pull 用
--app<アプリ 名前>このアプリだけの変数(同じ名前のプロジェクト変数より優先)。なければプロジェクトのすべてのアプリ

oneend env pull

環境変数を .env ファイルにダウンロードします

使い方

oneend env pull [ファイル] [--target <production|preview>]

既定のファイルは .env.local、既定の環境は preview です。ファイルは本人だけが読めるように(0600)書き込みます。
機密の値はダウンロードできないため、名前だけをコメントとして残します。
自動で入る変数(SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY など)も書き込みます。サービスロールキーは名前だけを残します。

引数 0〜1 個

オプション

オプション値説明
--target, -t, --environment<production|preview|development>どの環境の変数か。複数回指定するかカンマで複数(既定は preview)。development は oneend dev と env pull 用
--yes, -y確認せずに進めます

oneend env push

.env ファイルの変数を保存します

使い方

oneend env push [ファイル] [--target <production|preview>] [--app <アプリ 名前>] [--branch <git ブランチ>] [--sensitive]

既定のファイルは .env、既定の環境は preview です。同じ名前は上書きします。プラットフォームが設定する名前(PORT、HOST、HOSTNAME、HOME、BLACKWALL_…)の行は飛ばして知らせます。それ以外は、すべて保存されるか、1 つも保存されないかのどちらかです。

引数 0〜1 個

オプション

オプション値説明
--target, -t, --environment<production|preview|development>どの環境の変数か。複数回指定するかカンマで複数(既定は preview)。development は oneend dev と env pull 用
--app<アプリ 名前>このアプリだけの変数(同じ名前のプロジェクト変数より優先)。なければプロジェクトのすべてのアプリ
--branch<git ブランチ>このブランチのプレビューだけの変数(--target preview と一緒に)。--app と一緒に使うと、そのアプリのそのブランチだけ
--sensitive機密の値として保存します(読み戻せません)
--dry-run送信せず、送る内容だけを表示します

oneend env set

変数を 1 つ保存します

使い方

oneend env set <名前> [値] [--target <production|preview>] [--app <アプリ 名前>] [--branch <git ブランチ>] [--sensitive]

値を省くとターミナルで尋ねるか、標準入力から読みます: printf %s "$SECRET" | oneend env set API_KEY --sensitive

引数 1〜2 個

オプション

オプション値説明
--target, -t, --environment<production|preview|development>どの環境の変数か。複数回指定するかカンマで複数(既定は preview)。development は oneend dev と env pull 用
--app<アプリ 名前>このアプリだけの変数(同じ名前のプロジェクト変数より優先)。なければプロジェクトのすべてのアプリ
--branch<git ブランチ>このブランチのプレビューだけの変数(--target preview と一緒に)。--app と一緒に使うと、そのアプリのそのブランチだけ
--sensitive機密の値として保存します(読み戻せません)

oneend env rm

変数を削除します

使い方

oneend env rm <名前> [--target <production|preview>] [--app <アプリ 名前>] [--branch <git ブランチ>] [--yes]

--target がなければ、その名前があるすべての環境から削除します。--app があればそのアプリだけに、--branch があればそのブランチだけに保存した変数を削除します。

引数 1 個

オプション

オプション値説明
--target, -t, --environment<production|preview|development>どの環境の変数か。複数回指定するかカンマで複数(既定は preview)。development は oneend dev と env pull 用
--app<アプリ 名前>このアプリだけの変数(同じ名前のプロジェクト変数より優先)。なければプロジェクトのすべてのアプリ
--branch<git ブランチ>このブランチのプレビューだけの変数(--target preview と一緒に)。--app と一緒に使うと、そのアプリのそのブランチだけ
--yes, -y確認せずに進めます

デプロイ

使い方説明
oneend deployコミットまたはこのフォルダーをビルドしてデプロイし、終わるまでログを表示します
oneend deployments ls最近のデプロイ
oneend deployments inspectデプロイ 1 件とそのビルドログ
oneend deployments redeploy同じコミットをもう一度ビルドします
oneend deployments promoteプレビューを本番としてビルドし直すか、本番デプロイをそのまま昇格します
oneend rollback本番を以前のデプロイに戻します(再ビルドしません)
oneend logsプロジェクトのログ(リクエスト、サーバー出力、関数、ビルド)
oneend deployments retentionデプロイの保存期間を表示・変更します
oneend deployments deleted最近削除したデプロイ(30日間は復元できます)
oneend deployments rmデプロイを削除します(30日間は復元できます)
oneend deployments restore削除したデプロイを復元します
oneend deployments branch-previewsブランチプレビューを表示・オンオフします
oneend server-memoryサーバーメモリを表示または変更します(512・1024・2048・4096MB)
oneend concurrent-builds同時に動くビルド数を表示または変更します(1〜20、none は上限なし)
oneend dev開発コマンドを開発環境の変数とともに実行します
oneend domains ls接続したドメインの一覧
oneend domains redirectドメインを同じプロジェクトの別のドメインへリダイレクトします

oneend deploy

コミットまたはこのフォルダーをビルドしてデプロイし、終わるまでログを表示します

使い方

oneend deploy [--branch <ブランチ>] [--commit <ハッシュ>] [--app <リポジトリ>] [--dir <フォルダー>] [--upload] [--prebuilt] [--prod] [--block-on-advisors] [--no-wait]

リポジトリに push されたコミットをビルドします。--branch と --commit がなければ、このフォルダーの git の現在のブランチと HEAD を使います。
本番ブランチなら本番に、それ以外ならプレビューにデプロイされます。ビルドに失敗すると終了コード 1 です。
リポジトリを接続していないプロジェクトか、--dir、--upload、--prebuilt を指定すると、フォルダーを圧縮してアップロードし、同じようにビルドします。
.gitignore と .oneendignore に従い、node_modules と .git は除いてアップロードします。--prod がなければアップロードはプレビュー(名前は --branch)です。
--prebuilt は、ビルド済みのフォルダー(例: --dir dist)をビルドせずにそのまま配信します。

オプション

オプション値説明
--branch, -b<ブランチ>ビルドするブランチ(アップロードならプレビューの名前)
--commit, -c<ハッシュ>ビルドするコミット(40 文字、またはこのフォルダーの git が知っている短いハッシュ)
--app<名前>プロジェクトに複数のリポジトリがあるとき
--dir, -d<フォルダー>このフォルダーをアップロードしてデプロイします(既定: 現在のフォルダー)
--uploadリポジトリがあっても、コミットの代わりにこのフォルダーをアップロードしてデプロイします
--prebuiltビルドせず、アップロードしたファイルをそのまま配信します
--prodアップロードを本番にデプロイします(オーナーと管理者)
--message, -m<メモ>アップロードしたデプロイに残すメモ
--block-on-advisorsデータベースの点検に重大なセキュリティ問題があればプロダクションにデプロイしません
--waitビルドが終わるまでログを表示します(既定で有効、--no-wait で無効)
--timeout<秒>待つ最長時間(既定 1800 秒)

oneend deployments ls

最近のデプロイ

使い方

oneend deployments ls [--limit <数>] [--before <dpl-id>]

オプション

オプション値説明
--limit, -n<数>件数(既定 20、最大 100)
--before<dpl-id>このデプロイの次から(古い方。前のページの最後の id)

oneend deployments inspect

デプロイ 1 件とそのビルドログ

使い方

oneend deployments inspect <id> [--wait] [--tail <行数>]

引数 1 個

オプション

オプション値説明
--wait終わるまで待ち、ログを表示します
--timeout<秒>待つ最長時間(既定 1800 秒)
--tail<行数>ビルドログの末尾の行数(既定 200)

oneend deployments redeploy

同じコミットをもう一度ビルドします

使い方

oneend deployments redeploy <id> [--no-wait]

引数 1 個

オプション

オプション値説明
--waitビルドが終わるまでログを表示します(既定で有効、--no-wait で無効)
--timeout<秒>待つ最長時間(既定 1800 秒)

oneend deployments promote

プレビューを本番としてビルドし直すか、本番デプロイをそのまま昇格します

使い方

oneend deployments promote <id> [--no-wait]

完了した本番デプロイを渡すと、再ビルドせずにすぐ昇格し、ロールバックで生じた本番の保留を解除します。いまのデプロイを渡すと保留だけ解除します。

引数 1 個

オプション

オプション値説明
--waitビルドが終わるまでログを表示します(既定で有効、--no-wait で無効)
--timeout<秒>待つ最長時間(既定 1800 秒)

oneend rollback

本番を以前のデプロイに戻します(再ビルドしません)

使い方

oneend rollback <id> [--yes]

完了した本番デプロイにだけ戻せます。オーナーと管理者のみ実行できます。その後、本番は保留になります: 新しい本番ビルドは oneend deployments promote <id> で昇格するまで出ません。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend logs

プロジェクトのログ(リクエスト、サーバー出力、関数、ビルド)

使い方

oneend logs [--source <ソース>] [--level <レベル>] [--search <テキスト>] [--follow]

ソース: site, server, api, auth, functions, build。レベル: info, warn, error。古い行が上に表示されます。

オプション

オプション値説明
--source, -s<ソース>site | server | api | auth | functions | build
--level, -l<レベル>info | warn | error
--search, -q<テキスト>内容を検索
--deployment<id>1 つのデプロイのログだけ
--limit, -n<数>行数(既定 100、最大 500)
--follow, -f新しい行を表示し続けます(Ctrl-C で停止)

oneend deployments retention

デプロイの保存期間を表示・変更します

使い方

oneend deployments retention [--canceled <日数>|plan] [--error <日数>|plan] [--preview <日数>|plan] [--production <日数>|plan]

期間を過ぎたデプロイは削除され、30日間は oneend deployments restore で復元できます。直近のデプロイ10個、完了した本番20個、完了した本番以外20個と配信中のデプロイは期間にかかわらず残ります。
変更できるのはプロジェクト管理者だけです。

オプション

オプション値説明
--canceled<日数>|planキャンセル・スキップしたデプロイを残す日数(1〜3650、plan でプランの既定値)
--error<日数>|plan失敗したデプロイを残す日数(1〜3650、plan でプランの既定値)
--preview<日数>|planプレビューのデプロイを残す日数(1〜3650、plan でプランの既定値)
--production<日数>|plan本番のデプロイを残す日数(1〜3650、plan でプランの既定値)

oneend deployments deleted

最近削除したデプロイ(30日間は復元できます)

使い方

oneend deployments deleted

オプション

このコマンド独自のオプションはありません。

oneend deployments rm

デプロイを削除します(30日間は復元できます)

使い方

oneend deployments rm <id> [--yes]

配信中とビルド中のデプロイは削除できません。削除したデプロイのアドレスは 410 を返し、30日を過ぎるとファイルとビルドログを消去します。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend deployments restore

削除したデプロイを復元します

使い方

oneend deployments restore <id>

削除から30日以内のデプロイだけを復元できます。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend deployments branch-previews

ブランチプレビューを表示・オンオフします

使い方

oneend deployments branch-previews [on|off]

off なら本番ブランチ (通常は main) に入ったものだけをビルドし、ブランチへのプッシュはデプロイ履歴にスキップとして残ります。再デプロイ、直接アップロードしたデプロイ、デプロイフックは通常どおりビルドします。
組織全体に適用され、変更できるのはオーナーと管理者だけです。

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend server-memory

サーバーメモリを表示または変更します(512・1024・2048・4096MB)

使い方

oneend server-memory [512|1024|2048|4096]

1024MB を超えると CPU は 2 つです。本番とブランチのアドレスのサーバーはリクエストがなくても常に動いているため、表示される 1 か月の金額がサーバー 1 つの 1 か月の料金です。
変更すると 1 分以内に新しいサイズで再起動します。オーナーと管理者のみ変更できます。

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend concurrent-builds

同時に動くビルド数を表示または変更します(1〜20、none は上限なし)

使い方

oneend concurrent-builds [<数>|none]

超えたビルドはキューで待ち、前のビルドが終わると始まります。待っているあいだはビルド時間が請求されません。オーナーと管理者のみ変更できます。

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend dev

開発コマンドを開発環境の変数とともに実行します

使い方

oneend dev [--app <名前>] [--dry-run]

コマンドはコンソールのビルドと開発の設定で決めた開発コマンドで、なければ npm run dev です。
リポジトリのルートディレクトリが設定されていれば、そのフォルダで実行します。機密の値はダウンロードできないため含めません。

オプション

オプション値説明
--app<名前>リポジトリが複数あるときにどれか(list_apps の name)
--dry-run実行せずに、何を実行するかだけを表示します

oneend domains ls

接続したドメインの一覧

使い方

oneend domains ls

オプション

このコマンド独自のオプションはありません。

oneend domains redirect

ドメインを同じプロジェクトの別のドメインへリダイレクトします

使い方

oneend domains redirect <ドメイン> <アドレス> [--status <コード>] | oneend domains redirect <ドメイン> --off

アドレスはドメイン、またはドメインとパスです。パスを付けると、アクセスしたパスがその後ろに付き、クエリ文字列もそのまま引き継がれます: oneend domains redirect vision.example.com example.com/vision なら vision.example.com/x?y=1 → example.com/vision/x?y=1、トップページは example.com/vision。リダイレクト先のドメインは、このプロジェクトに接続した、リダイレクトではないドメインである必要があります。

引数 1〜2 個

オプション

オプション値説明
--status<コード>ステータスコード: 308(既定、恒久)・307・301・302
--offリダイレクトをオフにし、このドメインで再びサイトを公開します

Git とアプリ

使い方説明
oneend git importリポジトリを接続して最初のデプロイを始めます
oneend git checksチェックを One Server で実行(オン・オフ)
oneend apps lsこのプロジェクトのアプリとアドレス
oneend apps setアプリ1つの設定を変更します(--run-as)
oneend apps deleteアプリ1つを削除します(アドレスとデプロイも)
oneend apps settingsアプリの設定: サーバーが待ち受けるポート

oneend git import

リポジトリを接続して最初のデプロイを始めます

使い方

oneend git import <owner/name> [--root <フォルダー>] [--app <アプリ 名前>] [--branch <ブランチ>] [--no-wait]

GitHub App が見られるリポジトリをこのプロジェクトに接続し、プロダクションブランチの最新コミットをビルドします(コンソールの [接続してデプロイ]、MCP import_repository と同じです)。
モノレポはアプリのフォルダーごとにインポートします: oneend git import acme/mono --root apps/web、次に --root apps/admin。
接続済みのリポジトリで別のフォルダーを選ぶと新しいアプリとして追加し、新しいアプリは専用のアドレスを持ちます(oneend apps ls)。データベース・キー・プロジェクトの環境変数は共有します。
インストールはリポジトリの最上位(ロックファイルのある場所)で、ビルドはアプリのフォルダーで行います。オーナーと管理者のみ実行できます。

引数 1 個

オプション

オプション値説明
--root<フォルダー>アプリのフォルダー(例: apps/web)。なければリポジトリの最上位
--app<アプリ 名前>アプリ名。なければフォルダー名、それもなければリポジトリ名
--branch, -b<ブランチ>プロダクションブランチ。なければリポジトリの既定ブランチ
--waitビルドが終わるまでログを表示します(既定で有効、--no-wait で無効)
--timeout<秒>待つ最長時間(既定 1800 秒)

oneend git checks

チェックを One Server で実行(オン・オフ)

使い方

oneend git checks [<owner/name> on|off]

接続した GitHub リポジトリの GitHub Actions のチェックを One Server のマシンで実行します(コンソールの Git 接続 → チェックを One Server で実行、MCP set_checks_on_server と同じです)。
引数なしで呼ぶとリポジトリごとの状態を表示します。オンにするとリポジトリ変数 POOL_RUNNER を保存し、ジョブがこの行を使うと One Server で動きます:
runs-on: ${{ vars.POOL_RUNNER || 'ubuntu-latest' }}
オフにすると変数を削除し、次のジョブから GitHub のマシンで動きます。オーナーと管理者のみ変更できます。

引数 0〜2 個

オプション

このコマンド独自のオプションはありません。

oneend apps ls

このプロジェクトのアプリとアドレス

使い方

oneend apps ls

アプリごとにリポジトリ、フォルダー(ルートディレクトリ)、プロダクションブランチ、プロダクションのアドレスを表示します。プロジェクトのサイトは <ref>--site、ほかのアプリは <ref>--<アプリ> のアドレスです。

オプション

このコマンド独自のオプションはありません。

oneend apps set

アプリ1つの設定を変更します(--run-as)

使い方

oneend apps set <アプリ 名前> --run-as <platform|image>

--run-as image: イメージが指定するユーザー(root を含む)で gVisor の分離環境の中で実行します。公式 WordPress イメージのように root で起動する必要がある Dockerfile アプリにだけ使ってください。root でも他のプロジェクトには届きません。--run-as platform(既定): 一般ユーザー(10001)で実行します。
変更すると再ビルドなしで1分以内にサーバーが新しい方法で再起動します(コンソールのビルド設定、MCP update_app の run_as と同じです)。オーナーと管理者のみ変更できます。

引数 1 個

オプション

オプション値説明
--run-as<platform|image>サーバーを誰として実行するか: platform(一般ユーザー 10001)または image(イメージのユーザー、gVisor)

oneend apps delete

アプリ1つを削除します(アドレスとデプロイも)

使い方

oneend apps delete <アプリ 名前> [--yes]

アドレスはすぐに外れ、進行中のビルドは取り消され、デプロイは復元できない形で削除されます。リポジトリにフォルダーが残っていても、プッシュで再びビルドしません。プロジェクトの既定のサイト、ドメインがつながったアプリ、ディスクのあるアプリは削除せず、先にすることを伝えます(コンソールのアプリ設定、MCP delete_app と同じです)。オーナーと管理者のみ削除できます。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend apps settings

アプリの設定: サーバーが待ち受けるポート

使い方

oneend apps settings <アプリ> --port <ポート|auto>

auto ならイメージの EXPOSE、なければ 3000 です。変えると 1 分以内にサーバーが再起動します。オーナーと管理者だけが変更できます。

引数 1 個

オプション

オプション値説明
--port<ポート|auto>1〜65535、または auto

ボリューム

使い方説明
oneend volumes lsアプリのボリュームとバックアップ、アプリごとのサーバーの待ち受けポート
oneend volumes createアプリの本番サーバーにボリュームを付けます
oneend volumes resizeボリュームを大きくします(小さくはできません)
oneend volumes rmボリュームとそのファイル・バックアップを削除します(元に戻せません)
oneend volumes backupボリュームのファイルを今すぐバックアップします(30 日間保管)
oneend volumes restoreボリュームをバックアップに戻します(今のファイルは先に 7 日間バックアップ)

oneend volumes ls

アプリのボリュームとバックアップ、アプリごとのサーバーの待ち受けポート

使い方

oneend volumes ls

ボリュームは、サーバーを再起動しても新しくデプロイしても残るディスクです。本番サーバーにだけ付きます。

オプション

このコマンド独自のオプションはありません。

oneend volumes create

アプリの本番サーバーにボリュームを付けます

使い方

oneend volumes create <アプリ> <パス> [--size <GB>]

WordPress ならパスは /var/www/html です。1 分以内に準備でき、サーバーが再起動します。オーナーと管理者だけができます。

引数 2 個

オプション

オプション値説明
--size<GB>サイズ GB(既定 1、1〜500)

oneend volumes resize

ボリュームを大きくします(小さくはできません)

使い方

oneend volumes resize <id> <GB>

引数 2 個

オプション

このコマンド独自のオプションはありません。

oneend volumes rm

ボリュームとそのファイル・バックアップを削除します(元に戻せません)

使い方

oneend volumes rm <id> --confirm <パス>

元に戻せないため、--confirm にボリュームのパスをそのまま入れてください(oneend volumes ls のパス)。

引数 1 個

オプション

オプション値説明
--confirm<パス>ボリュームのパス。例: /var/www/html

oneend volumes backup

ボリュームのファイルを今すぐバックアップします(30 日間保管)

使い方

oneend volumes backup <id>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend volumes restore

ボリュームをバックアップに戻します(今のファイルは先に 7 日間バックアップ)

使い方

oneend volumes restore <id> <バックアップ id>

引数 2 個

オプション

このコマンド独自のオプションはありません。

ファイルストレージ

使い方説明
oneend storage lsバケット、またはバケットの中のファイルを表示します
oneend storage upload手元のファイルをバケットにアップロードします
oneend storage downloadバケットのファイルを手元にダウンロードします
oneend storage rmバケットのファイルを削除します(元に戻せません)

oneend storage ls

バケット、またはバケットの中のファイルを表示します

使い方

oneend storage ls [<バケット>[/<フォルダー>]]

バケットを省くとバケットの一覧です。フォルダーは一階層ずつ表示します: oneend storage ls photos/2026

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend storage upload

手元のファイルをバケットにアップロードします

使い方

oneend storage upload <ファイル> <バケット>/<名前> [--replace]

同じ名前のファイルがあれば止まります。置き換えるには --replace を付けてください。2MB を超えるファイルもアップロードできます(プランのファイル上限まで)。

引数 2 個

オプション

オプション値説明
--replace同じ名前のファイルがあれば置き換えます
--content-type<種類>ファイルの種類。例: image/png(既定は拡張子から決めます)

oneend storage download

バケットのファイルを手元にダウンロードします

使い方

oneend storage download <バケット>/<名前> [<ファイル>]

保存先を省くと、名前の最後の部分で現在のフォルダーに保存します。同じ名前のファイルがあれば止まります。置き換えるには --replace を付けてください。

引数 1〜2 個

オプション

オプション値説明
--replace手元に同じ名前のファイルがあれば置き換えます

oneend storage rm

バケットのファイルを削除します(元に戻せません)

使い方

oneend storage rm <バケット>/<名前> --yes

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

専用サーバー

使い方説明
oneend server専用サーバーを表示します(サイズ、場所、待機サーバー、作業)
oneend server request専用サーバーを借ります
oneend server resize専用サーバーのサイズを変更します(今すぐ、または今夜)
oneend server standby待機サーバーをオンまたはオフにします(auto で自動切り替え)
oneend server move専用サーバーを別の場所に移します(月に 1 回、無料)
oneend server release専用サーバーを返却します
oneend server restore-days復元できる期間を 7 日または 28 日にします

oneend server

専用サーバーを表示します(サイズ、場所、待機サーバー、作業)

使い方

oneend server [--project <ref>]

サイズと場所ごとの月額は oneend server-sizes(MCP list_server_sizes)で確認できます。

オプション

このコマンド独自のオプションはありません。

oneend server request

専用サーバーを借ります

使い方

oneend server request <サイズ> [<場所>]

通常 10 分以内に準備でき、データベースとアプリを移してからアドレスを切り替えます。Pro プランから、オーナーと管理者のみ実行できます。

引数 1〜2 個

オプション

このコマンド独自のオプションはありません。

oneend server resize

専用サーバーのサイズを変更します(今すぐ、または今夜)

使い方

oneend server resize <サイズ> [now|tonight]

tonight はサーバーの場所の時刻で 3〜5 時です。待機サーバーがなければ 3〜5 分応答しません。オーナーと管理者のみ実行できます。

引数 1〜2 個

オプション

このコマンド独自のオプションはありません。

oneend server standby

待機サーバーをオンまたはオフにします(auto で自動切り替え)

使い方

oneend server standby on|off [auto]

待機サーバーは同じ場所・同じサイズで、データベースを継続的に複製します。auto なら主サーバーが 60 秒応答しないとき自動で切り替えます。オーナーと管理者のみ実行できます。

引数 1〜2 個

オプション

このコマンド独自のオプションはありません。

oneend server move

専用サーバーを別の場所に移します(月に 1 回、無料)

使い方

oneend server move <場所>

アドレスを切り替える瞬間に書き込みが数秒止まります。古いサーバーは 7 日間残します。オーナーと管理者のみ実行できます。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend server release

専用サーバーを返却します

使い方

oneend server release <プロジェクト>

最後のバックアップを取り、データベースとアプリを共用サーバーに移してからサーバーを削除します。移動中は書き込みが止まります。確認としてプロジェクト ID(ref)をそのまま渡してください。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend server restore-days

復元できる期間を 7 日または 28 日にします

使い方

oneend server restore-days 7|28

28 日は専用サーバーでのみ使え、月額の追加料金があります。オーナーと管理者のみ実行できます。

引数 1 個

オプション

このコマンド独自のオプションはありません。

他のサーバーから取り込む

使い方説明
oneend import sources接続した取り込み元のアカウントとそのプロジェクト、これまでの取り込み
oneend import start取り込みを開始します
oneend import get取り込みの進行状況
oneend import authSupabase プロジェクトのログイン設定をこのプロジェクトにコピーします
oneend import storageSupabase プロジェクトのバケットとファイルをこのプロジェクトにコピーします

oneend import sources

接続した取り込み元のアカウントとそのプロジェクト、これまでの取り込み

使い方

oneend import sources [--org <名前>]

他のサーバーから取り込む(コンソールの組織メニュー、MCP import_sources と同じです)。取り込み元のアカウント(Supabase、Vercel、PostgreSQL)はコンソールで一度接続します。

オプション

オプション値説明
--org<名前>組織の id か名前。省くと最初の組織

oneend import start

取り込みを開始します

使い方

oneend import start (<取り込み id> | --connection <id> --project <id>) [--org <名前>]

コンソールで分割した取り込みを、または取り込み元アカウントのプロジェクトをまとまりごとに新しいプロジェクトに分けて開始します(コンソールの [取り込みを開始]、MCP start_import と同じです)。
Supabase の元はセッションプーラーの接続文字列を環境変数 ONEEND_SOURCE_DB_URL で渡します。今回の実行だけに使って削除します。
止まった取り込みをもう一度開始すると、終わった場所は飛ばし、変わったものだけ移します。進行は oneend import get <id>。

引数 0〜1 個

オプション

オプション値説明
--connection<id>取り込み元のアカウント(oneend import sources の connection)
--project<id>取り込み元のプロジェクト
--org<名前>組織の id か名前。省くと最初の組織

oneend import get

取り込みの進行状況

使い方

oneend import get <取り込み id> [--org <名前>]

移す先ごとに段階別の状態を表示します(MCP get_import と同じです)。

引数 1 個

オプション

オプション値説明
--org<名前>組織の id か名前。省くと最初の組織

oneend import auth

Supabase プロジェクトのログイン設定をこのプロジェクトにコピーします

使い方

oneend import auth --connection <id> --from <ref> [--providers <名前>] [--dry-run] [--org <名前>]

接続した Supabase アカウントで、オンにしたソーシャルプロバイダー、戻り先アドレスの一覧、空ならサイトアドレスを、リンクしたプロジェクトにコピーします(MCP copy_auth_from_import と同じです)。
シークレットは Supabase から直接読んで保存し、画面には表示しません。まず --dry-run で確認してください。
終わったらコールバックアドレスを各プロバイダーのコンソールに登録してください。登録するまでログインは失敗します。

オプション

オプション値説明
--connection<id>取り込み元のアカウント(oneend import sources の connection)
--from<ref>Supabase プロジェクトの ref(MCP の project)
--providers<名前>コピーするプロバイダー。複数回指定するかカンマ区切り(既定: オンのものすべて)
--dry-run変更せず、何をコピーするかだけを表示します
--org<名前>組織の id か名前。省くと最初の組織

oneend import storage

Supabase プロジェクトのバケットとファイルをこのプロジェクトにコピーします

使い方

oneend import storage --connection <id> --from <ref> [--buckets <名前>] [--rename <元=新>] [--dry-run] [--org <名前>]

接続した Supabase アカウントで、バケットとファイルをリンクしたプロジェクトにコピーします(MCP copy_storage_from_import と同じです)。
ないバケットは Supabase と同じ公開設定と上限で作り、同じサイズのファイルがすでにあれば飛ばします。終わるまで続けて呼びます。
Supabase のキーはサーバーの中だけで使います。バケットのアクセスルールはコピーしません。まず --dry-run で確認してください。

オプション

オプション値説明
--connection<id>取り込み元のアカウント(oneend import sources の connection)
--from<ref>Supabase プロジェクトの ref(MCP の project)
--buckets<名前>コピーする Supabase のバケット。複数回指定するかカンマ区切り(既定: すべて)
--rename<元=新>バケット名の変更。なければ小文字にし、空白は - にします
--dry-run変更せず、作るバケットとコピーするファイルの数だけを表示します
--org<名前>組織の id か名前。省くと最初の組織

関数

使い方説明
oneend functions lsデプロイした関数
oneend functions deploy関数をデプロイします(ファイル 1 つまたはフォルダー。同じ名前なら丸ごと置き換え)
oneend functions rm関数を削除します
oneend functions downloadデプロイした関数のコードをダウンロードします
oneend functions invoke関数を呼び出します(プロジェクトのシークレットキーで)
oneend functions limits関数の時間制限を表示または変更します(呼び出し 1 回、SQL 1 文)
oneend functions egress関数の外部リクエストをオン・オフします(fetch() で公開 HTTPS アドレスを呼ぶ)
oneend secrets list関数シークレットの名前(値は表示しません)
oneend secrets set関数シークレットを保存します(同じ名前なら上書き)
oneend secrets copy別のプロジェクトの関数シークレットを名前でコピーします
oneend secrets unset関数シークレットを削除します

oneend functions ls

デプロイした関数

使い方

oneend functions ls

オプション

このコマンド独自のオプションはありません。

oneend functions deploy

関数をデプロイします(ファイル 1 つまたはフォルダー。同じ名前なら丸ごと置き換え)

使い方

oneend functions deploy <名前> [ファイル または フォルダー] [--public | --private]

ファイルがなければ oneend/functions/<名前>/ フォルダー、supabase/functions/<名前>/ フォルダー、oneend/functions/<名前>.ts の順に探します。
フォルダーなら index.ts(または index.js)から始まり、ほかのモジュール、package.json、deno.json まですべて送ります(.gitignore に従い、node_modules は除きます)。../_shared/ のように隣のフォルダーを import していれば、そのフォルダーも一緒に送ります。
npm:・jsr:・URL の import と deno.json の imports は、デプロイ時にインストールするか一度だけ取得して一緒にまとめます。
関数は本番の秘密情報を読めるため、デプロイできるのはオーナーと管理者のみです。

引数 1〜2 個

オプション

オプション値説明
--publicキーなしで呼び出せるようにします(決済サービスの Webhook など)。--no-public で非公開
--private非公開にします: このプロジェクトのキー(公開キー・ユーザートークン・シークレットキー)があれば呼び出せる(新しい関数の既定)

oneend functions rm

関数を削除します

使い方

oneend functions rm <名前> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend functions download

デプロイした関数のコードをダウンロードします

使い方

oneend functions download <名前> [ファイル]

ファイルがなければ標準出力に書き出します。

引数 1〜2 個

オプション

このコマンド独自のオプションはありません。

oneend functions invoke

関数を呼び出します(プロジェクトのシークレットキーで)

使い方

oneend functions invoke <名前> [--data <JSON>] [--method <POST>] [--header <名前: 値>]

引数 1 個

オプション

オプション値説明
--data, -d<本文>送る本文(JSON なら content-type も JSON)。@ファイル でファイルの内容
--method, -X<メソッド>既定は POST
--header, -H<名前: 値>追加で送るヘッダー(複数回指定可)

oneend functions limits

関数の時間制限を表示または変更します(呼び出し 1 回、SQL 1 文)

使い方

oneend functions limits <名前> [--timeout <秒>] [--sql-timeout <秒>]

既定では呼び出し 1 回に 150 秒(Supabase のエッジ関数と同じ)、SQL 1 文に 8 秒です。このサーバーの最大は timeout_cap_seconds です。
default を指定すると既定値に戻ります。フラグなしで呼ぶと今の制限を表示します。次の呼び出しから適用され、制限を超えた呼び出しは 504 で打ち切られます。

引数 1 個

オプション

オプション値説明
--timeout<秒>呼び出し 1 回にかけられる秒数(default で既定の 150 秒)
--sql-timeout<秒>SQL 1 文にかけられる秒数(default で既定の 8 秒)

oneend functions egress

関数の外部リクエストをオン・オフします(fetch() で公開 HTTPS アドレスを呼ぶ)

使い方

oneend functions egress [on | off]

既定ではオフです。オフの間、関数はこのプロジェクトのデータベースと API にしか届きません。
オンにするとサーバーが代わりにリクエストを送り、すべて関数のログに残ります。内部アドレスはブロックします。関数のコードがデータを外部に送れるようになるため、必要なときだけオンにしてください。
引数なしで呼ぶと今の状態を表示します。30 秒以内に反映されます。変更できるのはオーナーと管理者のみです。

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend secrets list

関数シークレットの名前(値は表示しません)

使い方

oneend secrets list

オプション

このコマンド独自のオプションはありません。

oneend secrets set

関数シークレットを保存します(同じ名前なら上書き)

使い方

oneend secrets set <名前=値>... [--env-file <ファイル>]

関数だけが見る値です。サイトのビルドには入らず、関数は次の呼び出しから process.env で読みます。保存した値は二度と表示できません。
値なしで名前を 1 つだけ指定すると標準入力から読みます(シェルの履歴に残らないように): printf %s "$KEY" | oneend secrets set RESEND_API_KEY
すべて保存されるか、1 つも保存されないかのどちらかです。オーナーと管理者のみ行えます。

引数 0〜100 個

オプション

オプション値説明
--env-file<ファイル>.env ファイルの変数をすべてシークレットとして保存します

oneend secrets copy

別のプロジェクトの関数シークレットを名前でコピーします

使い方

oneend secrets copy --from <ref> <名前>... [--overwrite]

値はサーバーの中だけで移り、表示されるのは名前だけです。別のプロジェクトにすでに保存したキーを貼り直す必要はありません。
このプロジェクトにすでにある名前はスキップします。置き換えるには --overwrite を付けます。コピー元にない名前は別に知らせ、残りはコピーします。
一度に 50 個までです。両方のプロジェクトでオーナーか管理者である必要があります。

引数 1〜50 個

オプション

オプション値説明
--from<ref>コピー元のプロジェクト(oneend projects list の ref)
--overwriteこのプロジェクトに同じ名前があれば置き換えます

oneend secrets unset

関数シークレットを削除します

使い方

oneend secrets unset <名前>... [--yes]

引数 1〜100 個

オプション

オプション値説明
--yes, -y確認せずに進めます

GPU

使い方説明
oneend gpuGPU の料金と、このプロジェクトの GPU ジョブ・サーバー
oneend gpu jobs createGPU を借りてコマンドを最後まで実行します(有料)
oneend gpu jobs getGPU ジョブ 1 件の状態と出力の最後
oneend gpu jobs cancelGPU ジョブを止めます
oneend gpu servers createモデルを動かしておく GPU サーバーを作ります(有料)
oneend gpu servers stopGPU サーバーを今止めます
oneend gpu servers rmGPU サーバーを削除します
oneend gpu volumes createモデルとデータを残しておく GPU ストレージを作ります(有料)
oneend gpu volumes rmGPU ストレージとその中のファイルを削除します

oneend gpu

GPU の料金と、このプロジェクトの GPU ジョブ・サーバー

使い方

oneend gpu

GPU は秒単位で借ります。Pro 以上のプランで使えます。

オプション

このコマンド独自のオプションはありません。

oneend gpu jobs create

GPU を借りてコマンドを最後まで実行します(有料)

使い方

oneend gpu jobs create <イメージ> "<コマンド>" [--gpu rtx4090] [--region auto] [--volume <名前>] [--name <名前>] [--env-file .env] [--max-minutes 60] [--yes]

コマンドが終わるか --max-minutes を過ぎると GPU を返します。GPU を借りた時点から返すまで、イメージの取得時間も含めて秒単位で請求します。
結果は GPU ストレージか外部に保存しないと残りません。開始と終了を知らせるため、イメージには curl、wget、python3 のいずれかが必要です。

引数 2 個

オプション

オプション値説明
--yes, -y確認せずに進めます
--gpu<rtx4090|l40s|a100|h100>GPU マシン(既定 rtx4090)
--region<auto|asia|us|eu>借りる地域(既定 auto、asia は日本・インド)
--volume<名前>/workspace に付ける GPU ストレージ。そのストレージのデータセンターで借ります
--name<名前>ジョブ名
--env-file<ファイル>環境変数ファイル(.env 形式)。封印して保管します
--max-minutes<分>最大実行時間(既定 60、最大 10080)

oneend gpu jobs get

GPU ジョブ 1 件の状態と出力の最後

使い方

oneend gpu jobs get <ジョブ id>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend gpu jobs cancel

GPU ジョブを止めます

使い方

oneend gpu jobs cancel <ジョブ id>

開始前なら開始せず、実行中なら GPU を返します。返すまでの時間は請求されます。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend gpu servers create

モデルを動かしておく GPU サーバーを作ります(有料)

使い方

oneend gpu servers create <名前> <イメージ> [--gpu l40s] [--region auto] [--volume <名前>] [--command "<コマンド>"] [--port 8000] [--idle-minutes 15] [--env-file .env] [--yes]

最初のリクエストで起動し(その間は503)、--idle-minutes の間リクエストがなければ止まります。0なら動かし続けます。
アドレスは secret キーで呼びます。起動を始めた時点から止まるまで、イメージの取得時間も含めて秒単位で請求します。

引数 2 個

オプション

オプション値説明
--yes, -y確認せずに進めます
--gpu<rtx4090|l40s|a100|h100>GPU マシン(既定 rtx4090)
--region<auto|asia|us|eu>借りる地域(既定 auto、asia は日本・インド)
--volume<名前>/workspace に付ける GPU ストレージ。そのストレージのデータセンターで借ります
--command<コマンド>空ならイメージ既定のコマンド
--port<ポート>サーバーが待ち受けるポート(既定 8000)
--idle-minutes<分>リクエストがないままこの時間が過ぎると止めます(既定 15、0 は動かし続ける)
--env-file<ファイル>環境変数ファイル(.env 形式)。封印して保管します

oneend gpu servers stop

GPU サーバーを今止めます

使い方

oneend gpu servers stop <名前>

まもなく止まります。止まるまでの時間は請求します。次のリクエストでまた起動します。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend gpu servers rm

GPU サーバーを削除します

使い方

oneend gpu servers rm <名前> [--yes]

動いていれば先に止めてから削除します。元に戻せません。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend gpu volumes create

モデルとデータを残しておく GPU ストレージを作ります(有料)

使い方

oneend gpu volumes create <名前> --datacenter <データセンター> [--size 50] [--yes]

ジョブやサーバーに --volume で渡すと /workspace に付きます。そのジョブとサーバーは、このデータセンターでしか GPU を借りません。
ある間は使っても使わなくても1GB・月の料金で請求します。韓国から近いデータセンターは AP-JP-1(日本)です。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます
--datacenter<データセンター>データセンター。例: AP-JP-1(一覧は oneend gpu --json)
--size<GB>サイズ GB(既定 50、10〜4000)

oneend gpu volumes rm

GPU ストレージとその中のファイルを削除します

使い方

oneend gpu volumes rm <名前> [--yes]

使っているジョブやサーバーがあれば削除しません。元に戻せません。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

ネットワーク

使い方説明
oneend networkプロジェクトの受信アドレスと固定アウトバウンド IP
oneend network static-ip固定アウトバウンド IP をオンまたはオフにします(有料)

oneend network

プロジェクトの受信アドレスと固定アウトバウンド IP

使い方

oneend network

受信アドレスはカスタムドメインの A レコードに使います。
送信アドレスが固定されるのは、固定アウトバウンド IP(有料、Pro 以上)を有効にしたプロジェクトだけです。有効にしていなければ共有アドレスで、予告なく変わることがあります。

オプション

このコマンド独自のオプションはありません。

oneend network static-ip

固定アウトバウンド IP をオンまたはオフにします(有料)

使い方

oneend network static-ip <on|off> [--yes]

月額料金は使った期間の分だけ請求されます。Pro 以上のプランで、オーナー、管理者、支払い担当者のみ実行できます。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

データベース

使い方説明
oneend migration new空のマイグレーションファイルを作成します
oneend migration listローカルのマイグレーションとリモートの適用記録を並べて表示します
oneend migration repairリモートの適用記録を修正します(実行はしません)
oneend db push未適用のマイグレーションを順に適用します
oneend db pull現在のスキーマをマイグレーションファイルとしてダウンロードします
oneend gen types typescriptsupabase-js 用の TypeScript 型を生成します
oneend db schemasプロジェクトが作ったスキーマと公開の有無
oneend db schemas exposeスキーマをデータ API に公開します
oneend db schemas hideスキーマをデータ API で非公開にします
oneend db move専用データベースへの移動の状態
oneend db move now専用データベースへの移動を依頼します
oneend db disk専用ディスク
oneend db disk request専用ディスクへの移行を依頼します
oneend db disk shrink専用ディスクを縮小します
oneend branches listデータベースブランチの一覧
oneend branches createプロジェクトのスキーマからデータベースブランチを作成します
oneend branches mergeブランチのマイグレーションをプロジェクトに適用します
oneend branches resetブランチをプロジェクトのスキーマから作り直します
oneend branches deleteブランチとそのデータベースを削除します

oneend migration new

空のマイグレーションファイルを作成します

使い方

oneend migration new <名前>

oneend/migrations/<YYYYMMDDHHMMSS>_<名前>.sql を作成します。標準入力から内容を渡すこともできます。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend migration list

ローカルのマイグレーションとリモートの適用記録を並べて表示します

使い方

oneend migration list

オプション

このコマンド独自のオプションはありません。

oneend migration repair

リモートの適用記録を修正します(実行はしません)

使い方

oneend migration repair <バージョン...> --status <applied|reverted>

applied: ローカルのファイルを実行せずに、適用済みとして記録します。
reverted: 記録だけを削除します。そのマイグレーションが作ったものはそのまま残ります。

引数 1 個以上

オプション

オプション値説明
--status<applied|reverted>どちらに修正するか

oneend db push

未適用のマイグレーションを順に適用します

使い方

oneend db push [--dry-run] [--include-all] [--yes]

マイグレーション 1 つが 1 つのトランザクションです。失敗するとそれだけを元に戻して止まります(終了コード 1)。適用記録はプロジェクトの oneend_migrations テーブルに残ります。
supabase/migrations のファイルをそのまま oneend/migrations にコピーしてかまいません。public.、auth.uid()、to authenticated などの Supabase の名前はこのプロジェクトの名前に変換して実行します(Supabase名の変換)。

オプション

オプション値説明
--dry-run適用せず、適用される内容だけを表示します
--include-allリモートの最新バージョンより古いローカルのマイグレーションも適用します
--yes, -y確認せずに進めます

oneend db pull

現在のスキーマをマイグレーションファイルとしてダウンロードします

使い方

oneend db pull [名前] [--no-record]

テーブル、制約、インデックス、関数、ビュー、トリガー、RLS ルールを SQL として oneend/migrations/<バージョン>_<名前>.sql(既定は remote_schema)に書き出します。
そのファイルはリモートで適用済みとして記録されるため、db push が再実行することはありません(--no-record で無効化)。

引数 0〜1 個

オプション

オプション値説明
--record適用済みとして記録します(既定で有効)

oneend gen types typescript

supabase-js 用の TypeScript 型を生成します

使い方

oneend gen types typescript [--schema public] [--output <ファイル>]

標準出力に書き出します: oneend gen types typescript > src/database.types.ts

オプション

オプション値説明
--schema, -s<スキーマ>既定は public。プロジェクトが作ったスキーマ(oneend db schemas)も使えます
--output, -o<ファイル>標準出力の代わりにこのファイルへ

oneend db schemas

プロジェクトが作ったスキーマと公開の有無

使い方

oneend db schemas

公開したスキーマには、データ API が Accept-Profile・Content-Profile ヘッダー(supabase-js の db: { schema })で応答します。public は常に公開されます。

オプション

このコマンド独自のオプションはありません。

oneend db schemas expose

スキーマをデータ API に公開します

使い方

oneend db schemas expose <名前...>

アクセスルール(RLS)と権限は public と同じく適用されます。オーナーと管理者のみ実行できます。

引数 1 個以上

オプション

このコマンド独自のオプションはありません。

oneend db schemas hide

スキーマをデータ API で非公開にします

使い方

oneend db schemas hide <名前...>

スキーマとその中のデータはそのまま残ります。データ API がそのスキーマに PGRST106(406)で応答するだけです。

引数 1 個以上

オプション

このコマンド独自のオプションはありません。

oneend db move

専用データベースへの移動の状態

使い方

oneend db move

Vault と大きなデータベースは専用データベースでのみ使えます。移動するには oneend db move now を実行します。

オプション

このコマンド独自のオプションはありません。

oneend db move now

専用データベースへの移動を依頼します

使い方

oneend db move now [--yes]

コンソールの「今すぐ移動」と同じです。順番が来たら移動し、移動中はこのプロジェクトへの書き込みが止まり、読み取りは続きます。移動直前の状態がバックアップとして残り、失敗した場合は元の場所にそのまま残ります。Pro プランから、オーナーと管理者のみ実行できます。

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend db disk

専用ディスク

使い方

oneend db disk

データベースが大きくなったプロジェクトは、このプロジェクトだけのディスクと Postgres に移ります。サイズ、使用量、月額、縮小の提案を表示します。

オプション

このコマンド独自のオプションはありません。

oneend db disk request

専用ディスクへの移行を依頼します

使い方

oneend db disk request [--yes]

コンソールの「専用ディスクに移す」と同じです。ディスクは作成したサイズで請求し、移している間は書き込みが失敗し、読み取りはできます。Enterprise はいつでも、ほかの有料プランは基準を超えると依頼できます。オーナーと管理者のみ実行できます。

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend db disk shrink

専用ディスクを縮小します

使い方

oneend db disk shrink [--yes]

コンソールの「ディスクを縮小」と同じです。より小さいディスクを作って移し、元のディスクを削除します。7日間 25% 未満の使用が続いたディスクだけ縮小できます。移している間は書き込みが失敗し、読み取りはできます。オーナーと管理者のみ実行できます。

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend branches list

データベースブランチの一覧

使い方

oneend branches list

オプション

このコマンド独自のオプションはありません。

oneend branches create

プロジェクトのスキーマからデータベースブランチを作成します

使い方

oneend branches create [名前] [--git-branch <ブランチ>] [--no-seed] [--with-data]

プロジェクトのマイグレーションを再実行し、シードを投入します。--with-data を指定すると、代わりにプロジェクトのデータを512MBまでコピーします(ファイルは除く)。--git-branch を指定すると、そのブランチのプレビューデプロイがこのデータベースを使います。

引数 0〜1 個

オプション

オプション値説明
--git-branch<ブランチ>関連付ける git ブランチ
--no-seedシードを投入しません
--with-dataプロジェクトのデータもコピーします

oneend branches merge

ブランチのマイグレーションをプロジェクトに適用します

使い方

oneend branches merge <名前> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend branches reset

ブランチをプロジェクトのスキーマから作り直します

使い方

oneend branches reset <名前> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend branches delete

ブランチとそのデータベースを削除します

使い方

oneend branches delete <名前> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

エッジ

使い方説明
oneend edge-config lsエッジ設定の一覧
oneend edge-config setエッジ設定に値を保存します
oneend edge-config rmエッジ設定からキーを削除します
oneend edge-config historyエッジ設定の変更履歴
oneend kv lsKV キーの一覧
oneend kv getKV の値を 1 つ読みます
oneend kv setKV に値を保存します
oneend kv rmKV キーを削除します
oneend rollout status段階的リリースの状態
oneend rollout advance段階的リリースを次の段階へ進めます
oneend rollout promote段階的リリースを全員に公開します
oneend rollout abort段階的リリースを中止して元に戻します
oneend analyticsウェブ解析の概要

oneend edge-config ls

エッジ設定の一覧

使い方

oneend edge-config ls

オプション

このコマンド独自のオプションはありません。

oneend edge-config set

エッジ設定に値を保存します

使い方

oneend edge-config set <キー> <値>

値は JSON として読めれば JSON(true、3、{"enabled": true, "percent": 20})、そうでなければ文字列として保存します。数秒以内にすべてのサーバーに反映されます。

引数 2 個

オプション

このコマンド独自のオプションはありません。

oneend edge-config rm

エッジ設定からキーを削除します

使い方

oneend edge-config rm <キー>...

引数 1 個以上

オプション

このコマンド独自のオプションはありません。

oneend edge-config history

エッジ設定の変更履歴

使い方

oneend edge-config history

オプション

このコマンド独自のオプションはありません。

oneend kv ls

KV キーの一覧

使い方

oneend kv ls [プレフィックス]

引数 0〜1 個

オプション

このコマンド独自のオプションはありません。

oneend kv get

KV の値を 1 つ読みます

使い方

oneend kv get <キー>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend kv set

KV に値を保存します

使い方

oneend kv set <キー> <値> [--ttl <秒>]

引数 2 個

オプション

オプション値説明
--ttl<秒>有効期限までの秒数

oneend kv rm

KV キーを削除します

使い方

oneend kv rm <キー>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend rollout status

段階的リリースの状態

使い方

oneend rollout status

オプション

このコマンド独自のオプションはありません。

oneend rollout advance

段階的リリースを次の段階へ進めます

使い方

oneend rollout advance

オプション

このコマンド独自のオプションはありません。

oneend rollout promote

段階的リリースを全員に公開します

使い方

oneend rollout promote

オプション

このコマンド独自のオプションはありません。

oneend rollout abort

段階的リリースを中止して元に戻します

使い方

oneend rollout abort [--reason <理由>]

オプション

オプション値説明
--reason<理由>記録に残す理由

oneend analytics

ウェブ解析の概要

使い方

oneend analytics [--days <1|7|30|90>]

オプション

オプション値説明
--days<日数>期間(既定 7)

通知チャネル、ログイン、認証メール

使い方説明
oneend auth providers lsログインプロバイダーの一覧
oneend auth providers setログインプロバイダーを設定して有効にします(custom:<名前> はアドレスも)
oneend auth providers rmログインプロバイダーの設定を削除します
oneend channels通知チャネルの一覧(Slack・KakaoWork・Webhook・メール)
oneend channels add通知チャネルを追加します
oneend channels testチャネル1つにテストメッセージを送ります
oneend channels rm通知チャネルを削除します
oneend auth smtpSMTP設定(認証メールを送るサーバー)
oneend auth smtp setSMTP設定を保存します
oneend auth smtp testSMTPサーバーからテストメールを送ります
oneend auth smtp rmSMTP設定を削除します
oneend auth templatesメールテンプレートの一覧
oneend auth templates getメールテンプレートを1つ表示します
oneend auth templates setメールテンプレートを保存します
oneend auth templates previewメールテンプレートを例の値でプレビューします
oneend auth templates resetメールテンプレートを既定の文面に戻します

oneend auth providers ls

ログインプロバイダーの一覧

使い方

oneend auth providers ls

オプション

このコマンド独自のオプションはありません。

oneend auth providers set

ログインプロバイダーを設定して有効にします(custom:<名前> はアドレスも)

使い方

oneend auth providers set <プロバイダー> --client-id <値> [--client-secret <値>] [--provider-type <値>] [--issuer <アドレス>] [--authorize-url <アドレス>] [--token-url <アドレス>] [--userinfo-url <アドレス>] [--jwks-uri <アドレス>] [--scopes <値>] [--claim-map <値>]

組み込みのプロバイダー(google、kakao など)はクライアント ID とシークレットだけで設定できます。
custom:<名前> は自分で登録する OAuth 2.0 / OpenID Connect プロバイダーです(Supabase と同じ名前)。認可アドレスとトークンアドレスが必要で、OpenID Connect なら --issuer だけでかまいません。
--provider-type oidc なら id_token を issuer の鍵(--jwks-uri、省くと issuer から探します)で検証してから読みます。oauth2(既定)なら --claim-map で読みます。
--claim-map(--claims)は、応答のどのフィールドが id、email、email_verified、name、avatar、phone かを JSON で指定します。例: {"id":"id","email":"kakao_account.email"}
シークレットを省くと保存済みのものをそのまま使います。アプリでは supabase.auth.signInWithOAuth({ provider: 'custom:<名前>' }) でログインします。

引数 1 個

オプション

オプション値説明
--client-id<値>プロバイダーアプリのクライアント ID
--client-secret<値>プロバイダーアプリのクライアントシークレット(省くと保存済みのものをそのまま使います)
--label<名前>画面に表示する名前(custom: のみ)
--issuer<アドレス>OpenID Connect の issuer: 省いたアドレスを補います(custom: のみ)
--authorize-url<アドレス>認可アドレス(custom: のみ)
--token-url<アドレス>トークンアドレス(custom: のみ)
--userinfo-url<アドレス>ユーザー情報のアドレス。なければ id_token を読みます(custom: のみ)
--scopes<値>ログインのたびに要求する scope(custom: のみ)
--claim-map<値>応答フィールドの対応、JSON(custom: のみ)
--claims<値>--claim-map と同じです(custom: のみ)
--provider-type<値>oidc または oauth2: id_token を検証するか、対応で読むか(custom: のみ)
--discovery-url<アドレス>issuer の設定ドキュメントが標準のパスにない場合(custom: のみ)
--jwks-uri<アドレス>id_token の署名鍵のアドレス。省くと issuer から読み取ります(custom: のみ)
--email-optionalメールアドレスのないユーザーもログインできるようにします(custom: のみ)
--token-auth<値>body または basic: クライアントの認証情報の送り方(custom: のみ)
--no-pkcePKCE を送りません(拒否するプロバイダーのみ、custom: のみ)
--disabled保存だけして有効にしません

oneend auth providers rm

ログインプロバイダーの設定を削除します

使い方

oneend auth providers rm <プロバイダー> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend channels

通知チャネルの一覧(Slack・KakaoWork・Webhook・メール)

使い方

oneend channels

オプション

このコマンド独自のオプションはありません。

oneend channels add

通知チャネルを追加します

使い方

oneend channels add --kind <slack|kakaowork|webhook|email> --name <名前> (--url <アドレス> | --email <アドレス>…) [--notices deployments,usage]

メールチャネルは --email を複数回(またはカンマ区切りで)指定し、10件まで受け付けます。アドレスごとに確認メールを送り、リンクを開いたアドレスにだけ通知を送ります。
usage には使用量の上限警告とトラフィック急増の通知が含まれます。オーナーと管理者のみ実行できます。

オプション

オプション値説明
--kind<kind>slack, kakaowork, webhook, email
--name<名前>チャネル名
--url<アドレス>Slack・KakaoWork・Webhookのアドレス
--email, --emails<アドレス>メールチャネルの送信先アドレス(複数回指定可)
--notices<種類>deployments, domains, usage, billing(空ならすべて)

oneend channels test

チャネル1つにテストメッセージを送ります

使い方

oneend channels test <id>

メールチャネルでは確認済みのアドレスにだけ送り、確認待ちのアドレスには確認メールを再送します。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend channels rm

通知チャネルを削除します

使い方

oneend channels rm <id> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend auth smtp

SMTP設定(認証メールを送るサーバー)

使い方

oneend auth smtp

オプション

このコマンド独自のオプションはありません。

oneend auth smtp set

SMTP設定を保存します

使い方

oneend auth smtp set --sender-email <アドレス> --host <サーバー> --username <名前> [--password <パスワード>] [--port 587] [--sender-name <名前>]

パスワードは --password の代わりに環境変数 ONEEND_SMTP_PASSWORD で渡せます(シェルの履歴に残りません)。空なら保存済みのパスワードを使います。
保存後に oneend auth smtp test で確認してください。

オプション

オプション値説明
--sender-email<アドレス>送信者メールアドレス(Sender email)
--sender-name<名前>送信者名(Sender name)
--host<サーバー>SMTPサーバーのアドレス(Host)
--port<ポート>25, 465, 587, 2465, 2525(既定 587)
--username<名前>SMTPのユーザー名(Username)
--password<パスワード>SMTPのパスワード(Password)
--minimum-interval<秒>同じアドレスに再び送るまでの最小間隔(既定 60)
--rate-limit-per-hour<数>1時間に送れるメールの数(既定 100)
--disable設定は残したまま、プラットフォームのアドレスから送ります
--enable再びこのサーバーから送ります

oneend auth smtp test

SMTPサーバーからテストメールを送ります

使い方

oneend auth smtp test [--to <アドレス>]

プラットフォームからの代替送信はしないので、失敗した場合はサーバーが返した理由がそのまま表示されます。--to を省くと自分のアドレスに送ります。

オプション

オプション値説明
--to<アドレス>送信先のアドレス

oneend auth smtp rm

SMTP設定を削除します

使い方

oneend auth smtp rm [--yes]

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend auth templates

メールテンプレートの一覧

使い方

oneend auth templates

オプション

このコマンド独自のオプションはありません。

oneend auth templates get

メールテンプレートを1つ表示します

使い方

oneend auth templates get <type>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend auth templates set

メールテンプレートを保存します

使い方

oneend auth templates set <type> --subject <件名> --body-file <ファイル.html>

Supabase で使っていたテンプレートをそのまま使えます: {{ .ConfirmationURL }}、{{ .Token }}、{{ .TokenHash }}、{{ .SiteURL }}、{{ .Email }}、{{ .NewEmail }}、{{ .RedirectTo }}、{{ .Data.<key> }}。

引数 1 個

オプション

オプション値説明
--subject<件名>件名(1行)
--body<HTML>本文のHTML
--body-file<ファイル>本文のHTMLを読み込むファイル

oneend auth templates preview

メールテンプレートを例の値でプレビューします

使い方

oneend auth templates preview <type> [--subject <件名> --body-file <ファイル.html>]

--subject や --body を渡すと保存せずにその内容を、省くと保存済みのテンプレートか既定の文面を表示します。

引数 1 個

オプション

オプション値説明
--subject<件名>件名(1行)
--body<HTML>本文のHTML
--body-file<ファイル>本文のHTMLを読み込むファイル

oneend auth templates reset

メールテンプレートを既定の文面に戻します

使い方

oneend auth templates reset <type> [--yes]

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

プラットフォームサーバー(運営者)

使い方説明
oneend platform overviewプラットフォーム全体の状況と対応が必要なものを表示します(運営者)
oneend platform findアドレス・id・ref・ドメイン・名前で顧客を探します(運営者)
oneend platform pricing顧客サーバー販売のスイッチとサイズごとの原価・価格を表示します(運営者)
oneend platform pricing set顧客サーバー販売のスイッチを変更します(運営者)
oneend platform sizes顧客サーバーのサイズ一覧を表示します(運営者)
oneend platform sizes set顧客サーバーのサイズを作成・変更します(運営者)
oneend platform servers当社サーバーのサイズ・使用率・月額原価を表示します(運営者)
oneend platform servers cpuサービスサーバーの CPU が何回・どれだけ高かったかを表示します(運営者)
oneend platform servers changeサーバー 1 台の変更を依頼します(運営者)
oneend platform servers showサーバー変更依頼 1 件の状態と記録を表示します(運営者)
oneend platform servers cancel開始前のサーバー変更依頼を取り消します(運営者)
oneend platform variablesGitHub リポジトリの Actions 変数を表示します(運営者)
oneend platform variables setGitHub リポジトリの Actions 変数を 1 つ保存します(運営者)
oneend platform variables rmGitHub リポジトリの Actions 変数を 1 つ削除します(運営者)
oneend platform operators運営者一覧を表示します(運営者)
oneend platform operators add運営者を追加します(運営者)
oneend platform operators rm運営者を外します(運営者)
oneend platform runs当社リポジトリの最近のワークフロー実行を表示します(運営者)
oneend platform runs cancel終わっていないワークフロー実行を取り消します(運営者)
oneend platform runs rerun終わったワークフロー実行をもう一度動かします(運営者)
oneend platform checksOne Server が自前で動かすリポジトリのチェックを表示します(運営者)
oneend platform merge-when-greenプルリクエストを通ったらマージの待ちに入れるか外します(運営者)
oneend platform ci-machinesチェックとデプロイを動かすマシンを表示します(運営者)
oneend platform ci-machines restartチェック用マシンを 1 台再起動します(運営者)
oneend platform ci-machines renewチェック用マシンの GitHub ランナーを再登録します(運営者)
oneend platform support開いているサポートセッションを表示します(運営者)
oneend platform support startお客様の代わりに作業するためサポートセッションを開きます(運営者)
oneend platform support endサポートセッションを終えます(運営者)

oneend platform overview

プラットフォーム全体の状況と対応が必要なものを表示します(運営者)

使い方

oneend platform overview

組織・プロジェクトの数、顧客サーバーとその作業、専用ディスク・サーバーの依頼、直近 24 時間のデプロイ、チェック用マシンを一度に表示します。何も変更しません。

オプション

このコマンド独自のオプションはありません。

oneend platform find

アドレス・id・ref・ドメイン・名前で顧客を探します(運営者)

使い方

oneend platform find <検索語>

組織ごとにオーナー、プラン、状態を、プロジェクトごとに状態、最後のデプロイ、ドメイン、顧客サーバー、進行中の専用依頼を表示します。

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend platform pricing

顧客サーバー販売のスイッチとサイズごとの原価・価格を表示します(運営者)

使い方

oneend platform pricing

オプション

このコマンド独自のオプションはありません。

oneend platform pricing set

顧客サーバー販売のスイッチを変更します(運営者)

使い方

oneend platform pricing set [--customer-hosts on|off] [--server-sizes-listed on|off] [--customer-host-regions <リージョン,...>] [--krw-per-usd <数>] ...

指定した項目だけがすぐ変わります。何から何に変えたかが監査ログに残ります。例: oneend platform pricing set --customer-hosts on --server-sizes-listed on

オプション

オプション値説明
--customer-hostson|off顧客が専用サーバーを借りられます
--server-sizes-listedon|offサーバーのサイズと価格を顧客に表示します
--region-rateson|offリージョンごとの使用量料金を適用します
--build-machine-planson|off強化・ターボのビルドマシンを Pro 以上だけにします
--customer-host-regions<リージョン,...>サーバーを貸すリージョンコード、カンマ区切りで複数
--krw-per-usd<数>マージン検査とウォン価格に使う為替(ウォン/ドル)
--customer-host-grace-days<数>支払いが止まってから読み取り専用にする日数(1〜30)
--customer-host-create-minutes<数>新しいマシンが応答しないとき作り直すまでの分(3〜60)
--customer-host-max-attempts<数>サーバー作成を試す回数(1〜10)
--customer-host-disk-gb<数>新しいサーバーのディスク GB(10〜2000)
--customer-host-move-days<数>リージョン移動の間の日数(1〜365)
--customer-host-retired-days<数>移動後に古いサーバーを残す日数(0〜30)

oneend platform sizes

顧客サーバーのサイズ一覧を表示します(運営者)

使い方

oneend platform sizes

オプション

このコマンド独自のオプションはありません。

oneend platform sizes set

顧客サーバーのサイズを作成・変更します(運営者)

使い方

oneend platform sizes set <サイズ> [--machine <マシン>] [--listed on|off] [--plan <プラン>|none] [--margin-floor <比率>] [--allow-loss] [--region <リージョン>:cost=<ドル>:usd=<ドル>:krw=<ウォン>] [--cost-source <ソース>]

サイズ名はメモリです(1gb は e2-micro)。新しいサイズは --listed on を指定しない限り非表示で作られます。
例: oneend platform sizes set 1gb --machine e2-micro --region kr-seoul-1:cost=7.6:usd=35
原価より安く売るには --allow-loss が必要です。krw を省くと usd × 為替を 1,000 ウォン単位で切り上げます。

引数 1 個

オプション

オプション値説明
--machine<マシン>Google のマシン(新しいサイズには必須)
--listedon|off顧客に表示され借りられます
--plan<プラン>このサイズを含むプラン(none で外します)
--margin-floor<比率>価格が超えるべきマージン(0.3 は 30%)
--allow-loss原価より安く売ることを許可します
--region<リージョン>:cost=<ドル>:usd=<ドル>:krw=<ウォン>リージョンごとのマシン原価と価格(複数回)
--cost-source<ソース>原価をどこで測ったか
--yes, -y確認せずに進めます

oneend platform servers

当社サーバーのサイズ・使用率・月額原価を表示します(運営者)

使い方

oneend platform servers

オプション

このコマンド独自のオプションはありません。

oneend platform servers cpu

サービスサーバーの CPU が何回・どれだけ高かったかを表示します(運営者)

使い方

oneend platform servers cpu [--hours <時間>] [--step <分>] [--all]

1 分ごとの記録から読み取ります。既定は直近 24 時間を 5 分単位で、80% 以上だった区間のみ表示します。--all ですべての区間を表示します。記録は 48 時間分だけ残ります。

オプション

オプション値説明
--hours<時間>何時間前から(1〜48、既定 24)
--step<分>区間の長さ(1〜60 分、既定 5)
--all80% 未満の区間もすべて表示

oneend platform servers change

サーバー 1 台の変更を依頼します(運営者)

使い方

oneend platform servers change --server main|build|standby|backup|vm|runner|pool|network|build-image --action <動作> [--to <サイズ>] [--when now|tonight] [--instance <名前>] [--zone <zone>] [--repo <owner/name>] [--location <リージョン>] [--region <リージョン>] [--reason <理由>]

サービスサーバーのサイズ: --server main --action resize --to e2-standard-4(全サイトが 3〜5 分止まるため確認します。既定は今夜 03:00〜05:00)。
ビルドサーバー: --server build --action on|off|resize · 待機サーバー: --server standby --action on|off · バックアップコピー: --server backup --action replica [--location us-west1|none]
マシン 1 台: --server vm --action start|stop|resize --instance oneserver-runner · 常時稼働の Actions マシンの廃止: --server runner --action retire(5 つのリポジトリの RUNNER 変数を先に削除・確認してから停止)
Actions マシンプールの整理: --server pool --action reset(オンなのにチェックを実行していないマシンをすべて停止)· そのイメージ作成: --server pool --action bake · Cloud NAT: --server network --action nat [--region us-west1](ルーターと NAT がなければ作成)
ビルドマシンのイメージ作成: --server build-image --action bake(一時マシンに入れてイメージにし、マシンは削除。新しいビルドマシンはそのイメージですぐ起動)

オプション

オプション値説明
--server<サーバー>main, build, standby, backup, vm, runner, pool, network, build-image
--action<動作>resize, on, off, replica, start, stop, retire, reset, nat, bake
--region<リージョン>network nat のリージョン(既定は us-west1)
--to<サイズ>resize の新しいサイズ(e2-standard-2、e2-standard-4、e2-standard-8)
--whennow|tonightすぐ、または今夜 03:00〜05:00(韓国時間)
--instance<名前>vm のマシン名
--zone<zone>vm のゾーン(空ならそのマシンの既定)
--repo<owner/name>runner retire で RUNNER を削除するリポジトリ(空なら 5 つ)
--location<リージョン>バックアップコピーのリージョン(既定は us-west1)
--no-downtime停止なしで(現在は拒否されます: サイトを受ける 2 台目のサーバーがありません)
--reason<理由>監査ログに残す理由
--yes, -y確認せずに進めます

oneend platform servers show

サーバー変更依頼 1 件の状態と記録を表示します(運営者)

使い方

oneend platform servers show <リクエスト id>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend platform servers cancel

開始前のサーバー変更依頼を取り消します(運営者)

使い方

oneend platform servers cancel <リクエスト id>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend platform variables

GitHub リポジトリの Actions 変数を表示します(運営者)

使い方

oneend platform variables <owner/name>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend platform variables set

GitHub リポジトリの Actions 変数を 1 つ保存します(運営者)

使い方

oneend platform variables set <owner/name> <名前> <値>

引数 3 個

オプション

このコマンド独自のオプションはありません。

oneend platform variables rm

GitHub リポジトリの Actions 変数を 1 つ削除します(運営者)

使い方

oneend platform variables rm <owner/name> <名前>

例: RUNNER を削除すると、そのリポジトリのチェックは GitHub のマシン(ubuntu-latest)で動きます。

引数 2 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend platform operators

運営者一覧を表示します(運営者)

使い方

oneend platform operators

オプション

このコマンド独自のオプションはありません。

oneend platform operators add

運営者を追加します(運営者)

使い方

oneend platform operators add <アドレス>

引数 1 個

オプション

このコマンド独自のオプションはありません。

oneend platform operators rm

運営者を外します(運営者)

使い方

oneend platform operators rm <アドレス>

サーバー環境(BLACKWALL_OPERATOR_EMAILS)にあるアドレスと自分のアドレスは外せません。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend platform runs

当社リポジトリの最近のワークフロー実行を表示します(運営者)

使い方

oneend platform runs [--workflow checks.yml|deploy.yml|ops.yml|static-egress.yml] [--limit <n>]

15 分を超えてマシンを待っている実行は停止中として表示されます。

オプション

オプション値説明
--workflow<ファイル>1 つのワークフローだけ(checks.yml、deploy.yml、ops.yml、static-egress.yml)
--limit<n>ワークフローごとの件数(1〜20、既定は 5)

oneend platform runs cancel

終わっていないワークフロー実行を取り消します(運営者)

使い方

oneend platform runs cancel <id>

デプロイ中の実行を取り消すと、そのデプロイが途中の状態で残ることがあります。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend platform runs rerun

終わったワークフロー実行をもう一度動かします(運営者)

使い方

oneend platform runs rerun <id> [--failed-only]

引数 1 個

オプション

オプション値説明
--failed-only失敗したジョブだけもう一度

oneend platform checks

One Server が自前で動かすリポジトリのチェックを表示します(運営者)

使い方

oneend platform checks [--limit <n>]

GitHub Actions なしで自前のマシンで動くチェックです(BLACKWALL_OWN_CI)。通ったらマージの待ちも表示します。

オプション

オプション値説明
--limit<n>件数(1〜50、既定は 20)

oneend platform merge-when-green

プルリクエストを通ったらマージの待ちに入れるか外します(運営者)

使い方

oneend platform merge-when-green <pr> on|off

待っているプルリクエストを main の上にまとめてチェックし、通れば入れた順にマージします。main と衝突するものは衝突したファイル名とともに差し戻します。

引数 2 個

オプション

このコマンド独自のオプションはありません。

oneend platform ci-machines

チェックとデプロイを動かすマシンを表示します(運営者)

使い方

oneend platform ci-machines

常時稼働のデプロイマシン(oneserver-runner)、Actions マシンプール(oneserver-pool-N)、自前のチェックの東京待機コントローラー(oneserver-ci-standby)です。

オプション

このコマンド独自のオプションはありません。

oneend platform ci-machines restart

チェック用マシンを 1 台再起動します(運営者)

使い方

oneend platform ci-machines restart <name>

そのマシンで動いていたジョブは途切れます。oneserver-runner、oneserver-pool-<番号>、oneserver-ci-standby だけです。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend platform ci-machines renew

チェック用マシンの GitHub ランナーを再登録します(運営者)

使い方

oneend platform ci-machines renew <name>

プラットフォームの GitHub App のトークンで登録します(個人のトークンなし)。マシンが再起動するため、動いていたジョブは途切れます。

引数 1 個

オプション

オプション値説明
--yes, -y確認せずに進めます

oneend platform support

開いているサポートセッションを表示します(運営者)

使い方

oneend platform support [--all]

オプション

オプション値説明
--all終わったセッションも最近 50 件まで

oneend platform support start

お客様の代わりに作業するためサポートセッションを開きます(運営者)

使い方

oneend platform support start <プロジェクト ID|組織 id|顧客 メール> --reason <理由> [--minutes <分>]

お客様の組織にオーナーとして入ります。開いている間は、その組織のプロジェクトでほかのすべてのコマンドをお客様と同じ権限で使えます(--project <ref>)。
理由と開始・終了はお客様の監査ログに残ります。既定 60 分、最大 480 分で、時間になると自動で終わります。

引数 1 個

オプション

オプション値説明
--reason<理由>入る理由(必須、お客様の監査ログに残ります)
--minutes<分>何分間(5〜480、空なら 60)

oneend platform support end

サポートセッションを終えます(運営者)

使い方

oneend platform support end <セッション id|プロジェクト ID|組織 id|顧客 メール>

引数 1 個

オプション

このコマンド独自のオプションはありません。

別名

使い慣れた綴りで入力しても、同じコマンドが実行されます。

入力実行されるコマンド
oneend projects lsoneend projects list
oneend env listoneend env ls
oneend env addoneend env set
oneend env removeoneend env rm
oneend deployments listoneend deployments ls
oneend deployments getoneend deployments inspect
oneend deployments deleteoneend deployments rm
oneend deployments removeoneend deployments rm
oneend functions listoneend functions ls
oneend functions deleteoneend functions rm
oneend secrets lsoneend secrets list
oneend secrets rmoneend secrets unset
oneend auth providers listoneend auth providers ls
oneend auth providers removeoneend auth providers rm
oneend migration lsoneend migration list
oneend migrations newoneend migration new
oneend migrations listoneend migration list
oneend migrations repaironeend migration repair
oneend gen types tsoneend gen types typescript
oneend edge-config listoneend edge-config ls
oneend kv listoneend kv ls
oneend domains listoneend domains ls
oneend kv deloneend kv rm
oneend branches lsoneend branches list
oneend branches rmoneend branches delete
oneend channels lsoneend channels
oneend channels listoneend channels
oneend channels removeoneend channels rm
oneend auth smtp removeoneend auth smtp rm
oneend gpu servers deleteoneend gpu servers rm
oneend gpu servers removeoneend gpu servers rm

終了コード

ステータスコード説明
0成功
1失敗(サーバーが拒否、ビルド失敗、マイグレーション失敗、接続失敗)
2コマンドの書き方の誤り(不明なオプション、値の不足、--yes が必要)

環境変数

名前説明
ONEEND_TOKEN保存したトークンの代わりに使うトークン(CI 向け)
ONEEND_API_URLAPI のアドレス
ONEEND_PROJECT_REF関連付けファイルの代わりに使うプロジェクト
ONEEND_CONFIG_DIR設定フォルダー(既定は ~/.config/oneend)