layout | page_title | sidebar_current | description |
---|---|---|---|
rancher |
Rancher: rancher_registration_token |
docs-rancher-resource-registration-token |
Provides a Rancher Registration Token resource. This can be used to create registration tokens for rancher environments and retrieve their information. |
Provides a Rancher Registration Token resource. This can be used to create registration tokens for rancher environments and retrieve their information.
# 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"
}
}
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.
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.
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