List bundles that are available, deployed, in use, or running. Also list environments.
bw list CATEGORY [NAME]
- CATEGORY is one of the following:
- available: shows bundles available for deployment.
- deployed: shows bundles deployed into environments.
- environments: shows environments.
- running: shows bundles currently running.
- used: shows bundles currently in use.
- NAME is an optional name to match. For listing deployments or running bundles, NAME refers to environment path or name.
<bw.list category="${category}" [name="${name}"] />
# Show all deployed bundles in use
bw list used
# Show all deployed bundles inside dev environment
bw list deployed dev
# Show all available bundles named hello
bw list available hello
# Show all environments
bw list enviroments
# Show all deployed bundles that are running
bw list running
# Show all deployed bundles running inside dev environment
bw list running dev
- There is some overlap between the list command and bw which and bw whereis. For example, bw list used jdk is the equivalent of bw which jdk, and bw list available hello shows the 'available' section of the output of bw whereis hello.
- A deployed bundle is considered running if it has a status hook and that status hook returns a result of 0.