public/terraform-provider-google
0
0
Fork 0
mirror of https://github.com/letic/terraform-provider-google.git synced 2024-10-03 01:01:06 +00:00
Code Issues Projects Releases Wiki Activity

Update google_compute_ssl_certificate docs to reference lifecycle (#258)

Browse Source
This commit is contained in:
Joe Selman 2017-07-28 10:45:32 -07:00 committed by GitHub
parent fd99f25e13
commit 96cef4df0e
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
website/docs/r/compute_ssl_certificate.html.markdown
View File

@ -25,6 +25,35 @@ resource "google_compute_ssl_certificate" "default" {
}
```
## Using with Target HTTPS Proxies
SSL certificates cannot be updated after creation. In order to apply the
specified configuration, Terraform will destroy the existing resource
and create a replacement. To effectively use an SSL certificate resource
with a [Target HTTPS Proxy resource][1], it's recommended to specify
`create_before_destroy` in a [lifecycle][2] block. Either omit the
Instance Template `name` attribute, or specify a partial name with
`name_prefix`. Example:
```hcl
resource "google_compute_ssl_certificate" "default" {
name_prefix = "my-certificate-"
description = "a description"
private_key = "${file("path/to/private.key")}"
certificate = "${file("path/to/certificate.crt")}"
lifecycle {
create_before_destroy = true
}
}
resource "google_compute_target_https_proxy" "my_proxy" {
name = "public-proxy"
url_map = # ...
ssl_certificates = ["${google_compute_ssl_certificate.default.self_link}"]
}
```
## Argument Reference
The following arguments are supported:
@ -58,3 +87,6 @@ exported:
* `id` - A unique ID for the certificated, assigned by GCE.
* `self_link` - The URI of the created resource.
[1]: /docs/providers/google/r/compute_target_https_proxy.html
[2]: /docs/configuration/resources.html#lifecycle