When deploying an application, the charm you use will often support or even require specific configuration options to be set.
Juju provides tools to help manage these options and respond to changes over the lifetime of the application deployment. These options apply to the entire application, as opposed to only a specific unit or relation. The configuration can be modified by an administrator at deployment time or after the applications are operational.
Each charm will have its own set of options and possible values. You can discover these in several ways:
- By running the
- By viewing the charm in the charm store.
- By examining the config.yaml file in the charm itself.
It is possible to set configuration values when deploying an application by providing a yaml-formatted file containing configuration values.
For example, upon investigation we discover that the Mediawiki charm allows us to set values for the name of the wiki and the 'skin' to use. We can put these inside a configuration file.
mediawiki: name: Juju Wiki skin: monobook admins: admin:admin
We can then use this configuration when we deploy the application:
juju deploy --config myconfig.yaml mediawiki
WARNING: If the YAML configuration file cannot be read or contains some syntax errors or invalid options, you will receive an error message to this effect. However, the application will still be deployed .
It is possible to set or change configuration of an application which is already deployed.
Before you set any of these options, you may want to check what current options
are already set, using the
juju config <application> command. For example:
juju config mediawiki
Should return something like this:
application: mediawiki charm: mediawiki settings: admins: description: Admin users to create, user:pass is_default: true type: string value: "" debug: description: turn on debugging features of mediawiki is_default: true type: boolean value: false logo: description: URL to fetch logo from is_default: true type: string value: "" name: description: The name, or Title of the Wiki is_default: true type: string value: Please set name of wiki server_address: description: The server url to set "$wgServer". Useful for reverse proxies is_default: true type: string value: "" skin: description: skin for the Wiki is_default: true type: string value: vector use_suffix: description: If we should put '/mediawiki' suffix on the url is_default: true type: boolean value: true
You can set the options using
juju config <application>, specifying
multiple space-separated key=value pairs if necessary:
juju config mediawiki skin=monoblock name='Juju Wiki'
It is also possible to set the configuration options from a YAML file after the application has been deployed:
juju config mediawiki --file path/to/myconfig.yaml
Setting an option back to its default value is achieved by using the same
command, with the
--reset switch, followed by a comma-separated list of the
values to return to the default setting:
juju config mediawiki --reset admins,name