Using Sandboxes With the TIBCO® Cloud - Command Line Interface
Sandboxes are logical partitions which can be used to organize or categorize different apps. You can use the TIBCO Cloud - Command Line Interface (CLI) to create, list, update, or delete sandboxes. You can specify sandbox locations in other TIBCO Cloud CLI commands.
sandbox createcommand is used to create a new sandbox working environment. For example, to create a sandbox named
myTestwith a description and display name:
sandbox create --desc "My test sandbox" --disp "Joe test sandbox" myTest
Note: sandbox names must start with a letter or underscore and can include letters, digits, periods, underscores, and dashes.
sandbox listcommand is used to show information about a sandbox. For example, to list information for the sandbox named
tibcli sandbox list myTest
sandbox updatecommand is used to change one or more attributes of the sandbox for the current user. For example, to change the name, description, and display name of sandbox
sandbox update --newName myTest2 --newDesc "My second test sandbox" --newDisp "Joe test sandbox 2" myTest
sandbox deleteis used to delete a sandbox. It can only be used when there are no apps in the sandbox. For example, to delete the empty sandbox
tibcli sandbox delete myTest2
You can move apps from one sandbox to another using the
app movecommand. For example, to move the app
tibcli app move myTestBox myApp1 myDevBox
After an app is moved to a different sandbox, the app will restart. The app endpoint does not change. The number of instances remain unchanged.
appcommands in which you can specify an app name argument also have an option to specify a sandbox in which the app is located, with the
-soption. For example, to scale up the app
myapp1in the sandbox
myTestBoxby adding three instances:
tibcli app scaleup --sandbox myTestBox 3 myapp1
Note: Operational sandboxes are not visible from the TIBCO® Cloud - Command Line Interface Reference. No commands or actions will work with operational sandboxes from within the TIBCO Cloud CLI. You can create and manipulate apps in a personal sandbox, then promote it to an operational sandbox from the Web UI.