» rancher_registration_token

Provides a Rancher Registration Token resource. This can be used to create registration tokens for rancher environments and retrieve their information.

» Example Usage

# Create a new Rancher registration token
resource "rancher_registration_token" "default" {
  name           = "staging_token"
  description    = "Registration token for the staging environment"
  environment_id = "${rancher_environment.default.id}"
  agent_ip       = ""

  host_labels    {
    orchestration = "true",
    etcd          = "true",
    compute       = "true"

» Argument Reference

The following arguments are supported:

  • name - (Required) The name of the registration token.
  • description - (Optional) A registration token description.
  • environment_id - (Required) The ID of the environment to create the token for.
  • host_labels - (Optional) A map of host labels to add to the registration command.
  • agent_ip - (Optional) A string containing the CATTLE_AGENT_IP to add to the registration command.

» Attributes Reference

The following attributes are exported:

  • id - (Computed) The ID of the resource.
  • image - (Computed)
  • command - The command used to start a rancher agent for this environment.
  • registration_url - The URL to use to register new nodes to the environment.
  • token - The token to use to register new nodes to the environment.

» Import

Registration tokens can be imported using the Environment and Registration token IDs in the form <environment_id>/<registration_token_id>.

$ terraform import rancher_registration_token.dev_token 1a5/1c11

If the credentials for the Rancher provider have access to the global API, then then environment_id can be omitted e.g.

$ terraform import rancher_registration_token.dev_token 1c11