2.1 KiB
2.1 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
rancher | Rancher: rancher_stack | docs-rancher-resource-stack | Provides a Rancher Stack resource. This can be used to create and manage stacks on rancher. |
rancher_stack
Provides a Rancher Stack resource. This can be used to create and manage stacks on rancher.
Example Usage
# Create a new empty Rancher stack
resource "rancher_stack" "external-dns" {
name = "route53"
description = "Route53 stack"
environment_id = "${rancher_environment.default.id}"
catalog_id = "library:route53:7"
scope = "system"
environment {
AWS_ACCESS_KEY = "MYKEY"
AWS_SECRET_KEY = "MYSECRET"
AWS_REGION = "eu-central-1"
TTL = "60"
ROOT_DOMAIN = "example.com"
ROUTE53_ZONE_ID = ""
HEALTH_CHECK_INTERVAL = "15"
}
}
Argument Reference
The following arguments are supported:
name
- (Required) The name of the stack.description
- (Optional) A stack description.environment_id
- (Required) The ID of the environment to create the stack for.docker_compose
- (Optional) Thedocker-compose.yml
content to apply for the stack.rancher_compose
- (Optional) Therancher-compose.yml
content to apply for the stack.environment
- (Optional) The environment to apply to interpret the docker-compose and rancher-compose files.catalog_id
- (Optional) The catalog ID to link this stack to. When provided,docker_compose
andrancher_compose
will be retrieved from the catalog unless they are overridden.scope
- (Optional) The scope to attach the stack to. Must be one of user or system. Defaults to user.start_on_create
- (Optional) Whether to start the stack automatically.finish_upgrade
- (Optional) Whether to automatically finish upgrades to this stack.
Attributes Reference
The following attributes are exported:
rendered_docker_compose
- The interpolateddocker_compose
applied to the stack.rendered_rancher_compose
- The interpolatedrancher_compose
applied to the stack.
Import
Stacks can be imported using their Rancher API ID, e.g.
$ terraform import rancher_stack.foo 1e149