@@ -2,16 +2,14 @@ Title: Juju Controllers
22TODO: Figure out the 'block command' situation (including CLI help
33 text). See 'Restricting command usage' section. The old page lives on.
44 Need examples for each command.
5- Figure out how to present those examples due to the foldout bug not
6- allowing syntax highlighting. So far, under 'Creating a controller'
7- there is a link to the old creating page.
5+ .
86
97
108# Controllers
119
1210A Juju * controller* is the management node of a Juju cloud environment. In
1311particluar, it houses the database and keeps track of all the models in that
14- environment. Although it is a special node, it is nonetheless a machine that
12+ environment. Although it is a special node, it is a machine that
1513gets created by Juju (during the "bootstrap" stage) and, in that sense, is
1614similar to other Juju machines.
1715
@@ -20,13 +18,13 @@ and the 'default' model. The primary purpose of the 'controller' model is to
2018run and manage the Juju API server and the underlying database. Additional
2119models may be created by the user - see [ Models] ( ./models.html ) .
2220
23- When a controller is intended to be used by multiple people, it is recommended
24- that Juju's [ multi-user functionality] ( ./users.html ) be leveraged.
25-
2621Since a controller can host multiple models, the destruction of a controller
2722must be done with ample consideration since all its models will be destroyed
2823along with it.
2924
25+ In some circumstances you may wish to share a controller or one of its associated
26+ models. Juju provides [ multi-user functionality] ( ./users.html ) for this purpose.
27+
3028
3129## Controller management
3230
@@ -62,7 +60,9 @@ Common controller management tasks are summarized below.
6260 Use the ` juju list-controllers ` command to list all controllers knowable by
6361 the current system user.
6462
65- ` juju list-controllers [options] `
63+ juju list-controllers [options]
64+
65+ The currently active controller is indicated in the list with an asterisk('* ').
6666
6767 For complete explanation, syntax and examples see the
6868 [ command reference page] ( ./commands.html#list-controllers ) or the `juju help
@@ -76,7 +76,7 @@ Common controller management tasks are summarized below.
7676 Information includes UUID, API endpoints, certificates, and bootstrap
7777 configuarion.
7878
79- ` juju show-controller [options] `
79+ juju show-controller [options]
8080
8181 For complete explanation, syntax and examples see the
8282 [ command reference page] ( ./commands.html#show-controller ) or the `juju help
@@ -88,7 +88,7 @@ Common controller management tasks are summarized below.
8888
8989 Use the ` juju destroy-controller ` command to remove a controller.
9090
91- ` juju destroy-controller [options] `
91+ juju destroy-controller [options]
9292
9393 For complete explanation, syntax and examples see the
9494 [ command reference page] ( ./commands.html#destroy-controller ) or the `juju help
@@ -104,7 +104,7 @@ Common controller management tasks are summarized below.
104104 of the ` juju destroy-controller ` command and failover to the more drastic
105105 behaviour if that attempt fails.
106106
107- ` juju kill-controller [options] `
107+ juju kill-controller [options]
108108
109109 For complete explanation, syntax and examples see the
110110 [ command reference page] ( ./commands.html#kill-controller ) or the `juju help
0 commit comments