How to manage credentials

The procedure for how to add a cloud credential to Juju depends on whether the cloud is a machine (traditional, non-Kubernetes) cloud or rather a Kubernetes cloud.

Add a credential for a machine cloud

1. Choose a cloud authentication type and collect the information required for that type from your cloud account.

2. Provide this information to Juju. You may do so in three ways – interactively, by specifying a YAML file, or automatically, by having Juju check your local YAML files or environment variables.

2a. To add a credential interactively, run the add-credential command followed by the name of your machine cloud. For example:

juju add-credential aws

This will start an interactive session where you’ll be asked to choose a cloud region (if applicable), specify a credential name (you can pick any name you want), and then provide the credential information (e.g., access key, etc.)

The command also offers various flags that you can use to provide all this information in one go (e.g., the path to a YAML file containing the credential definition) as an alternative to the interactive session.

See more: juju add-credential

2b. To add a credential by specifying a YAML file, use your credential information to prepare a credentials.yaml file, then run the add-credential command with the -f flag followed by the path to this file.

See more: juju add-credential -f

2c. To add a credential automatically, use your credential information to prepare a credentials.yaml file / environment variables, then run the autoload-credentials command:

juju autoload-credentials

Juju will scan your local credentials files / environment variables / rc files and, if it detects something suitable for the present cloud, it will display a prompt asking you to confirm the addition of the credential and to specify a name for it.

The command also allows you to restrict the search to a specific cloud, a specific controller, etc.

See more: juju autoload-credentials

Add a credential for a Kubernetes cloud

For a Kubernetes cloud, credential definitions are added automatically when you add the cloud definition to Juju. Run juju credentials to verify.

See more: How to add a Kubernetes cloud

To add a credential, in your Terraform plan create a resource of the juju_credential type, specifying the credential’s name, cloud, authentication type, and the attributes associated with the authentication type.

resource "juju_credential" "this" {
  name = "creddev"

  cloud {
    name = "localhost"
  }

  auth_type = "certificate"

  attributes = {
    client-cert    = "/srv/cert.crt"
    client-key     = "/srv/cert.key"
    trust-password = "S0m3P@$$w0rd"
  }
}

See more: juju_credential (resource)

To add a credential, you may use the Controller.add_credential() method on a connected Controller object. add_credential is an upsert method (where it inserts if the given credential is new, and updates if the given credential name already exists).

from juju.client import client as jujuclient

my_controller.add_credential("my-credential", 
    jujuclient.CloudCredential(auth_type="jsonfile", attrs={'file':'path_to_cred_file'})

See more: add_credential (method)

To see a list of all the known credentials, run the credentials command:

juju credentials

This should output something similar to this:

Controller Credentials:
Cloud           Credentials
lxd             localhost*

Client Credentials:
Cloud   Credentials
aws     bob*, carol
google  wayne

where the asterisk denotes the default credential for a given cloud.

By passing various flags, you can also choose to view just the credentials known to the client, or just those for a particular controller; you can select a different output format or an output file (and also choose to include secrets); etc.

See more: juju credentials

The terraform juju client does not support this. Please use the juju client.

The python-libjuju client does not support this. Please use the juju client.

You can view details about all your credentials at once or just about a specific credential.

All credentials. To view details about all your credentials at once, run the show-credential command with no argument:

juju show-credential

By passing various flags you can filter by controller, select an output format or an output file, etc.

See more: juju show-credential

A specific credential. To view details about just one specific credential, run the show-credential command followed by the name of the cloud and the name of the credential. For example:

juju show-credential mycloud mycredential

By passing various flags you can specify an output format or an output file, display secret attributes, etc.

See more: juju show-credential

The terraform juju client does not support this. Please use the juju client.

The python-libjuju client does not support this. Please use the juju client.

Set. To set the default credential for a cloud on the current client, run the default-credential command followed by the name of the cloud and the name of the credential. For example:

juju default-credential aws carol

See more: juju default-credential

Get. To view the currrently set default credential for a cloud, run the default-credential command followed by the name of the cloud. For example:

juju default-credential aws

This should display the default credential.

See more: juju default-credential

The terraform juju client does not support this. Please use the juju client.

The python-libjuju client does not support this. Please use the juju client.

To add a controller credential to a model, run the set-credential command followed by a flag for the intended model, the host cloud, and the name of the credential. For example:

juju set-credential -m trinity aws bob

See more: juju set-credential

To add a controller credential to a model, in your Terraform plan, specify it as an attribute to the model definition. For example:

resource "juju_model" "this" {
  name = "development"

  cloud {
    name   = "aws"
    region = "eu-west-1"
  }

  credential = juju_credential.<credential label>.name
}

The python-libjuju client does not support this. Please use the juju client.

To update a credential, run the update-credential command followed by the name of the cloud and the name of the credential. For example:

juju update-credential mycloud mycredential

This will start an interactive session where you will be asked to specify various parameters for the update.

By passing various flags, you can also perform this operation in-line. And by dropping the credential (and the cloud) argument and passing a flag with a credential YAMl file, you can also update all your credentials at once.

See more: juju update-credential

To update a credential, in your Terraform plan, update its resource definition.

See more: Resource juju_credential

To update a credential, you may use the Controller.add_credential() method on a connected Controller object. add_credential is an upsert method (where it inserts if the given credential is new, and updates if the given credential name already exists).

from juju.client import client as jujuclient

my_controller.add_credential("my-credential", 
    jujuclient.CloudCredential(auth_type="jsonfile", attrs={'file':'path_to_cred_file'})

See more: add_credential (method)

To remove a credential, run the remove-credential command followed by the name of the cloud and the name of the credential. For example:

juju remove-credential mycloud mycredential

This will start an interactive session where you will be asked to choose whether to apply this operation for the client or a specific controller or both. You can bypass this by using the client and controller flags in-line.

See more: juju remove-credential

To remove a credential, remove its resource definition from your Terraform plan.

See more: Resource juju_credential

The python-libjuju client does not support this. Please use the juju client.