README
VTEX CLI Plugin Workspace
Extend the vtex
toolbelt!
Developing
- Clone
vtex/toolbelt
and follow the steps on the Contributing section. - Clone/Create a plugin with this template.
- Change the template name under this project's
package.json
. - Run
yarn link
on this project. - Now run
vtex link @vtex/cli-plugin-template
(or the new name) on thevtex/toolbelt
project. - Run
yarn watch
on thevtex/toolbelt
- Test the command on a VTEX IO app with
vtex-test hello
For more information, read Ocliff Docs.
Usage
$ npm install -g @vtex/cli-plugin-workspace
$ oclif-example COMMAND
running command...
$ oclif-example (-v|--version|version)
@vtex/cli-plugin-workspace/1.0.0 linux-x64 node-v12.21.0
$ oclif-example --help [COMMAND]
USAGE
$ oclif-example COMMAND
...
Commands
oclif-example workspace:delete WORKSPACE1 [ITHWORKSPACE]
oclif-example workspace:list
oclif-example workspace:promote
oclif-example workspace:reset [WORKSPACENAME]
oclif-example workspace:status [WORKSPACENAME]
oclif-example workspace:use WORKSPACE
oclif-example workspace:delete WORKSPACE1 [ITHWORKSPACE]
Deletes one or many workspaces from the current account.
USAGE
$ oclif-example workspace:delete WORKSPACE1 [ITHWORKSPACE]
ARGUMENTS
WORKSPACE1 Name of the workspace to delete.
ITHWORKSPACE Name of the multiple workspaces to delete.
OPTIONS
-f, --force Deletes the specified workspace even if it is currently in use.
-h, --help show CLI help
-v, --verbose Show debug level logs
-y, --yes Answers yes to all prompts.
--trace Ensure all requests to VTEX IO are traced
EXAMPLES
vtex workspace delete workspaceName
vtex workspace delete workspaceName1 workspaceName2
See code: build/commands/workspace/delete.ts
oclif-example workspace:list
Lists all workspaces of the current account.
USAGE
$ oclif-example workspace:list
OPTIONS
-h, --help show CLI help
-v, --verbose Show debug level logs
--trace Ensure all requests to VTEX IO are traced
ALIASES
$ oclif-example workspace:ls
EXAMPLES
vtex workspace list
vtex workspace ls
See code: build/commands/workspace/list.ts
oclif-example workspace:promote
Promotes the current workspace to master. (Only works for production workspaces.) Run vtex promote --help to see how to deal with data conflicts.
USAGE
$ oclif-example workspace:promote
OPTIONS
-h, --help
show CLI help
-v, --verbose
Show debug level logs
--conflict=master|mine|abort
[default: master] Defines how to handle data conflict between workspaces.
- master: Discards the workspace's conflicting data, keeping the data from master unchanged.
- mine: Overrides the master with the specified workspace. Any conflicting data on the master is lost.
- abort: Aborts the workspace promotion in case of data conflict.
--trace
Ensure all requests to VTEX IO are traced
ALIASES
$ oclif-example promote
EXAMPLES
vtex workspace promote
vtex promote
See code: build/commands/workspace/promote.ts
oclif-example workspace:reset [WORKSPACENAME]
Cleans all configurations of a workspace and recreates it with the configurations from master. If not specified which workspace, it defaults to the current one.
USAGE
$ oclif-example workspace:reset [WORKSPACENAME]
ARGUMENTS
WORKSPACENAME Name of the workspace to reset.
OPTIONS
-h, --help show CLI help
-p, --production Recreates the workspace as a production one.
-v, --verbose Show debug level logs
-y, --yes Answers yes to all prompts.
--trace Ensure all requests to VTEX IO are traced
EXAMPLES
vtex workspace reset
vtex workspace reset workspaceName
See code: build/commands/workspace/reset.ts
oclif-example workspace:status [WORKSPACENAME]
Displays information about the specified workspace.
USAGE
$ oclif-example workspace:status [WORKSPACENAME]
ARGUMENTS
WORKSPACENAME Name of the workspace.
OPTIONS
-h, --help show CLI help
-v, --verbose Show debug level logs
--trace Ensure all requests to VTEX IO are traced
EXAMPLE
vtex workspace status
See code: build/commands/workspace/status.ts
oclif-example workspace:use WORKSPACE
Creates and switches to a new workspace or simply switches to an existing one.
USAGE
$ oclif-example workspace:use WORKSPACE
ARGUMENTS
WORKSPACE Name of the workspace
OPTIONS
-h, --help show CLI help
-p, --production Creates and/or switches to a production workspace.
-r, --reset Resets the workspace before switching to it.
-v, --verbose Show debug level logs
--trace Ensure all requests to VTEX IO are traced
ALIASES
$ oclif-example use
EXAMPLES
vtex workspace use workspaceName
vtex use workspaceName
See code: build/commands/workspace/use.ts