supacloud
v0.11.2
Published
Unified entrypoint: `supacloudctl cli` and `supacloudctl admin` in one command
Maintainers
Readme
supacloud
Unified entrypoint that bundles both SupaCloud CLIs behind a single supacloudctl command.
supacloudctl cli → @supacloud/cli (project-scoped developer tools)
supacloudctl admin → @supacloud/admin (platform operations: install / SSH / tenant management)安装
npm install -g supacloud
supacloudctl --helpOne-off execution:
npx --package supacloud supacloudctl cli status
npx --package supacloud supacloudctl admin statussupacloud depends on both @supacloud/cli and @supacloud/admin, so installing
it gives you the full toolset. You can still install either CLI on its own
(@supacloud/cli exposes supacloud-cli, @supacloud/admin exposes supacloud-admin).
更新检查
Normal supacloudctl cli ... and supacloudctl admin ... dispatch is local-only and does not
contact npm. Run an explicit check when needed:
supacloudctl check-update
supacloudctl check-update cli
supacloudctl check-update adminThe dispatcher never downloads or executes a newer operator CLI implicitly. To opt into the old notify-before-dispatch behavior, set:
SUPACLOUD_AUTO_UPDATE=1 supacloudctl cli statusUse SUPACLOUD_NPM_REGISTRY or npm_config_registry to point the check at a registry mirror.
用法
supacloudctl cli status
supacloudctl cli project get
supacloudctl cli gateway routes --ref <ref>
supacloudctl admin status
supacloudctl admin project list
supacloudctl admin ssh pingEach subcommand accepts its own --help:
supacloudctl cli --help
supacloudctl admin --help上下文
supacloudctl cli auto-links the current project from .env:
SUPABASE_URL/SUPACLOUD_API_URLSUPABASE_SERVICE_ROLE_KEY/SUPACLOUD_API_TOKENSUPACLOUD_PROJECT_REFwhen it cannot be inferred from a managed<ref>.api.*hostname
supacloudctl admin expects platform context:
SUPACLOUD_HOST+SUPACLOUD_SSH_KEY/SUPACLOUD_SSH_PASS+SUPACLOUD_SSH_HOST_FINGERPRINTSUPACLOUD_API_URL+SUPACLOUD_API_TOKEN
Note:
/usr/local/bin/supacloudis the compiled management-api server binary. This npm package exposes onlysupacloudctl; it does not install asupacloudcompatibility alias and should normally be used on an operator's local machine.
