ドキュメント · リファレンス
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 billing | 1か月分の請求書: 項目ごとの金額、定価、請求額 |
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 link
このフォルダーをプロジェクトに関連付けます
使い方
oneend link [--project <ref>] [--app <リポジトリ>]
.oneend/project.json を作成します。秘密情報は含まれないので、コミットしてかまいません。
オプション
| オプション | 値 | 説明 |
|---|---|---|
--app | <名前> | プロジェクトに複数のリポジトリがあるときに deploy がビルドするリポジトリ |
oneend unlink
このフォルダーとプロジェクトの関連付けを解除します
使い方
oneend unlink
オプション
このコマンド独自のオプションはありません。
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 | <コード> | このリージョンだけを表示します(空ならすべてのリージョン) |
--currency | KRW|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 auth | Supabase プロジェクトのログイン設定をこのプロジェクトにコピーします |
oneend import storage | Supabase プロジェクトのバケットとファイルをこのプロジェクトにコピーします |
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 gpu | GPU の料金と、このプロジェクトの GPU ジョブ・サーバー |
oneend gpu jobs create | GPU を借りてコマンドを最後まで実行します(有料) |
oneend gpu jobs get | GPU ジョブ 1 件の状態と出力の最後 |
oneend gpu jobs cancel | GPU ジョブを止めます |
oneend gpu servers create | モデルを動かしておく GPU サーバーを作ります(有料) |
oneend gpu servers stop | GPU サーバーを今止めます |
oneend gpu servers rm | GPU サーバーを削除します |
oneend gpu volumes create | モデルとデータを残しておく GPU ストレージを作ります(有料) |
oneend gpu volumes rm | GPU ストレージとその中のファイルを削除します |
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 typescript | supabase-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 ls | KV キーの一覧 |
oneend kv get | KV の値を 1 つ読みます |
oneend kv set | KV に値を保存します |
oneend kv rm | KV キーを削除します |
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 smtp | SMTP設定(認証メールを送るサーバー) |
oneend auth smtp set | SMTP設定を保存します |
oneend auth smtp test | SMTPサーバーからテストメールを送ります |
oneend auth smtp rm | SMTP設定を削除します |
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-pkce | PKCE を送りません(拒否するプロバイダーのみ、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 variables | GitHub リポジトリの Actions 変数を表示します(運営者) |
oneend platform variables set | GitHub リポジトリの Actions 変数を 1 つ保存します(運営者) |
oneend platform variables rm | GitHub リポジトリの 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 checks | One 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-hosts | on|off | 顧客が専用サーバーを借りられます |
--server-sizes-listed | on|off | サーバーのサイズと価格を顧客に表示します |
--region-rates | on|off | リージョンごとの使用量料金を適用します |
--build-machine-plans | on|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 のマシン(新しいサイズには必須) |
--listed | on|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) |
--all | 80% 未満の区間もすべて表示 |
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) |
--when | now|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 ls | oneend projects list |
oneend env list | oneend env ls |
oneend env add | oneend env set |
oneend env remove | oneend env rm |
oneend deployments list | oneend deployments ls |
oneend deployments get | oneend deployments inspect |
oneend deployments delete | oneend deployments rm |
oneend deployments remove | oneend deployments rm |
oneend functions list | oneend functions ls |
oneend functions delete | oneend functions rm |
oneend secrets ls | oneend secrets list |
oneend secrets rm | oneend secrets unset |
oneend auth providers list | oneend auth providers ls |
oneend auth providers remove | oneend auth providers rm |
oneend migration ls | oneend migration list |
oneend migrations new | oneend migration new |
oneend migrations list | oneend migration list |
oneend migrations repair | oneend migration repair |
oneend gen types ts | oneend gen types typescript |
oneend edge-config list | oneend edge-config ls |
oneend kv list | oneend kv ls |
oneend domains list | oneend domains ls |
oneend kv del | oneend kv rm |
oneend branches ls | oneend branches list |
oneend branches rm | oneend branches delete |
oneend channels ls | oneend channels |
oneend channels list | oneend channels |
oneend channels remove | oneend channels rm |
oneend auth smtp remove | oneend auth smtp rm |
oneend gpu servers delete | oneend gpu servers rm |
oneend gpu servers remove | oneend gpu servers rm |
終了コード
| ステータスコード | 説明 |
|---|---|
0 | 成功 |
1 | 失敗(サーバーが拒否、ビルド失敗、マイグレーション失敗、接続失敗) |
2 | コマンドの書き方の誤り(不明なオプション、値の不足、--yes が必要) |
環境変数
| 名前 | 説明 |
|---|---|
ONEEND_TOKEN | 保存したトークンの代わりに使うトークン(CI 向け) |
ONEEND_API_URL | API のアドレス |
ONEEND_PROJECT_REF | 関連付けファイルの代わりに使うプロジェクト |
ONEEND_CONFIG_DIR | 設定フォルダー(既定は ~/.config/oneend) |