Adding a model
A controller can host multiple models to accommodate different workloads or use
cases. When a controller is created, it creates two initial models called
'controller' and 'default', but more models can be added with the add-model
command. See Creating a controller for details.
It is important to understand that credentials used with Juju are always associated with a model. When creating a model, therefore, a credential is either specified explicitly or a default is used. Read the Credentials page for background information.
When a model is added the associated credential is validated with the backing cloud. As long as this check passes the model can be created and any of its subsequent machines will be created using those credentials. Care is therefore advised if the list of credentials to choose from contains multiple credentials (accounts) for the same cloud type.
The model creator, by default, is granted 'admin' model access by default. This
includes the two initial models created at controller-creation time. This
assists in connecting to machines within the model with juju ssh
(see
SSH keys and models). An exception to this is when the
creator explicitly designates another user as 'owner'. In this case, the
creator does not get 'admin' model access.
See section Managing models in a multi-user context for information on that subject.
Examples
Add a model named 'lxd-staging' to the current controller:
juju add-model lxd-staging
It is possible to add a model to a controller different to the current one. To add a model named 'gce-test' for the non-current 'gce' controller:
juju add-model gce-test -c gce
Add a model named 'rackspace-prod' to the current controller, specifying an existing credential name of 'jon':
juju add-model rackspace-prod --credential jon
Here we're creating model 'han' in a multi-user context. We assign Juju user 'don' as model owner in addition to specifying credential 'ren':
juju add-model han --owner don --credential ren
By default, Juju will automatically change to the newly created model.
Subsequent commands, unless the -m
option is used to select a specific model,
will operate on this model. This can be confirmed by running the switch
command with no arguments. So, for example, after the above command, running:
juju switch
will return output like this:
rackspace:admin/rackspace-prod
In some cases (e.g. when scripting), this behaviour may be undesirable. In this
case, you can add --no-switch
option to keep the current model selected.