Skip to main content

Upgrading from v1/v2 to v3

CloudBase CLI v3.0 expands features and integrates some commands based on v1/v2, while maintaining full compatibility with the existing command formats from v1/v2.

Upgrade Procedure​

npm install -g @cloudbase/cli

View current version:

tcb --version

v3.0 Important Changes​

New Modules​

v3.0 added the following top-level command modules:

New CommandDescription
tcb corsSecurity Domain Management (Web SDK allowlist)
tcb domainsCustom Domain Management (HTTP access service, requires SSL certificate)
tcb routesHTTP Service Routing Management
tcb agentAI Agent Management
tcb appApplication Deployment Management
tcb logsLog Search
tcb secretsSecret Management
tcb userUser Management
tcb permissionPermission Management
tcb roleRole Management
tcb apiAPI Management
tcb dbDatabase Management

Environment ID Resolution Priority​

v3.0 introduced the tcb env use global default environment configuration. The environment ID resolution priority is (low → high):

Global configuration (tcb env use) < Project cloudbaserc.json < Command line -e / --env-id

That is: the command line parameter -e always takes precedence, followed by the project configuration file, and finally the global default environment.

Removed Modules​

The following modules have been completely removed in v3.0 and are no longer supported:

tcb fun — Function-based Hosting (removed)​

The tcb fun list, tcb fun deploy, tcb fun run commands have been removed. Function-based Hosting capabilities have been integrated into tcb cloudrun:

Old Command (Removed)Replacement Command
tcb fun listtcb cloudrun list
tcb fun deploytcb cloudrun deploy
tcb fun runtcb cloudrun run

tcb run standalonegateway — Standalone Gateway (removed)​

The tcb run standalonegateway create/destroy/list/package/turn commands have been removed with no replacement commands. For related capabilities, see the Cloud Run console.

The following commands are still available but have been marked as deprecated and may be removed in future versions:

SCF (fn)​

Old Command Format (Deprecated)New Command Format (Recommended)
tcb functions:deploytcb fn deploy
tcb functions:listtcb fn list
tcb functions:deletetcb fn delete
tcb functions:detailtcb fn detail
tcb functions:invoketcb fn invoke
tcb functions:logtcb fn log
tcb functions:copytcb fn cp
tcb functions:downloadtcb fn code download
tcb functions:code:updatetcb fn code update
tcb functions:config:updatetcb fn config update
tcb functions:trigger:createtcb fn trigger create
tcb functions:trigger:deletetcb fn trigger delete
tcb functions:runtcb fn run

Cloud storage (storage)​

Old Command Format (Deprecated)New Command Format (Recommended)
tcb storage:uploadtcb storage upload
tcb storage:downloadtcb storage download
tcb storage:deletetcb storage rm
tcb storage:listtcb storage list
tcb storage:urltcb storage url
tcb storage:detailtcb storage detail
tcb storage:get-acltcb permission
tcb storage:set-acltcb permission

Static Website Hosting (hosting)​

Old Command Format (Deprecated)New Command Format (Recommended)
tcb hosting:detailtcb hosting detail
tcb hosting:deploytcb hosting deploy
tcb hosting:deletetcb hosting delete
tcb hosting:listtcb hosting list

HTTP Access Service (service)​

The tcb service series of commands have been deprecated, and their functionalities have been replaced by the following commands:

Old CapabilityNew Command
Security Domain Allowlisttcb cors add/list/rm
Bind/Unbind custom domaintcb domains add/ls/rm
Create/Manage Routing Rulestcb routes add/list/edit/delete

Data Model (db)​

Old Command (Deprecated)New Command (Recommended)
tcb db listtcb db model list
tcb db pulltcb db model pull
tcb db pushtcb db model push

Cloud Run (run)​

The following top-level commands have been marked as deprecated. Please use the tcb cloudrun series of commands:

Old Command (Deprecated)Description
tcb run listDeprecated, use tcb cloudrun list
tcb run deleteDeprecated, use tcb cloudrun delete