Skip to content

Commit 2d26792

Browse files
committed
Added controller indicator. Fixed formatting
1 parent ab615bf commit 2d26792

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

src/en/controllers.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,14 @@ Title: Juju Controllers
22
TODO: 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

1210
A Juju *controller* is the management node of a Juju cloud environment. In
1311
particluar, 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
1513
gets created by Juju (during the "bootstrap" stage) and, in that sense, is
1614
similar to other Juju machines.
1715

@@ -20,13 +18,13 @@ and the 'default' model. The primary purpose of the 'controller' model is to
2018
run and manage the Juju API server and the underlying database. Additional
2119
models 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-
2621
Since a controller can host multiple models, the destruction of a controller
2722
must be done with ample consideration since all its models will be destroyed
2823
along 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

Comments
 (0)