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       = "1.2.3.4"

  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