Skip to content

Commit bc5289e

Browse files
modular-magicianmodular-magician
authored
Add HA Policy to Regional Backend Services (#14522) (#1085)
[upstream:0692e14d57fe7513a9b872f3a6bc4fef880992bb] Signed-off-by: Modular Magician <[email protected]>
1 parent 416a9bd commit bc5289e

File tree

8 files changed

+289
-0
lines changed

8 files changed

+289
-0
lines changed

‎region_backend_service_ha_policy/backing_file.tf‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# This file has some scaffolding to make sure that names are unique and that
2+
# a region and zone are selected when you try to create your Terraform resources.
3+
4+
locals {
5+
name_suffix = "${random_pet.suffix.id}"
6+
}
7+
8+
resource "random_pet" "suffix" {
9+
length = 2
10+
}
11+
12+
provider "google" {
13+
region = "us-central1"
14+
zone = "us-central1-c"
15+
}

‎region_backend_service_ha_policy/main.tf‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
resource "google_compute_network" "default" {
2+
name = "rbs-net-${local.name_suffix}"
3+
}
4+
5+
resource "google_compute_region_backend_service" "default" {
6+
region = "us-central1"
7+
name = "region-service-${local.name_suffix}"
8+
protocol = "UDP"
9+
load_balancing_scheme = "EXTERNAL"
10+
network = google_compute_network.default.id
11+
ha_policy {
12+
fast_ip_move = "GARP_RA"
13+
}
14+
// Must explicitly disable connection draining to override default value.
15+
connection_draining_timeout_sec = 0
16+
}

‎region_backend_service_ha_policy/motd‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
===
2+
3+
These examples use real resources that will be billed to the
4+
Google Cloud Platform project you use - so make sure that you
5+
run "terraform destroy" before quitting!
6+
7+
===

‎region_backend_service_ha_policy/tutorial.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Region Backend Service Ha Policy - Terraform
2+
3+
## Setup
4+
5+
<walkthrough-author name="[email protected]" analyticsId="UA-125550242-1" tutorialName="region_backend_service_ha_policy" repositoryUrl="https://github.com/terraform-google-modules/docs-examples"></walkthrough-author>
6+
7+
Welcome to Terraform in Google Cloud Shell! We need you to let us know what project you'd like to use with Terraform.
8+
9+
<walkthrough-project-billing-setup></walkthrough-project-billing-setup>
10+
11+
Terraform provisions real GCP resources, so anything you create in this session will be billed against this project.
12+
13+
## Terraforming!
14+
15+
Let's use {{project-id}} with Terraform! Click the Cloud Shell icon below to copy the command
16+
to your shell, and then run it from the shell by pressing Enter/Return. Terraform will pick up
17+
the project name from the environment variable.
18+
19+
```bash
20+
export GOOGLE_CLOUD_PROJECT={{project-id}}
21+
```
22+
23+
After that, let's get Terraform started. Run the following to pull in the providers.
24+
25+
```bash
26+
terraform init
27+
```
28+
29+
With the providers downloaded and a project set, you're ready to use Terraform. Go ahead!
30+
31+
```bash
32+
terraform apply
33+
```
34+
35+
Terraform will show you what it plans to do, and prompt you to accept. Type "yes" to accept the plan.
36+
37+
```bash
38+
yes
39+
```
40+
41+
42+
## Post-Apply
43+
44+
### Editing your config
45+
46+
Now you've provisioned your resources in GCP! If you run a "plan", you should see no changes needed.
47+
48+
```bash
49+
terraform plan
50+
```
51+
52+
So let's make a change! Try editing a number, or appending a value to the name in the editor. Then,
53+
run a 'plan' again.
54+
55+
```bash
56+
terraform plan
57+
```
58+
59+
Afterwards you can run an apply, which implicitly does a plan and shows you the intended changes
60+
at the 'yes' prompt.
61+
62+
```bash
63+
terraform apply
64+
```
65+
66+
```bash
67+
yes
68+
```
69+
70+
## Cleanup
71+
72+
Run the following to remove the resources Terraform provisioned:
73+
74+
```bash
75+
terraform destroy
76+
```
77+
```bash
78+
yes
79+
```

‎region_backend_service_ha_policy_manual_leader/backing_file.tf‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# This file has some scaffolding to make sure that names are unique and that
2+
# a region and zone are selected when you try to create your Terraform resources.
3+
4+
locals {
5+
name_suffix = "${random_pet.suffix.id}"
6+
}
7+
8+
resource "random_pet" "suffix" {
9+
length = 2
10+
}
11+
12+
provider "google" {
13+
region = "us-central1"
14+
zone = "us-central1-c"
15+
}

‎region_backend_service_ha_policy_manual_leader/main.tf‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
resource "google_compute_network" "default" {
2+
name = "rbs-net-${local.name_suffix}"
3+
auto_create_subnetworks = false
4+
}
5+
6+
resource "google_compute_subnetwork" "default" {
7+
name = "rbs-subnet-${local.name_suffix}"
8+
ip_cidr_range = "10.1.2.0/24"
9+
region = "us-central1"
10+
network = google_compute_network.default.id
11+
}
12+
13+
resource "google_compute_network_endpoint" "endpoint" {
14+
network_endpoint_group = google_compute_network_endpoint_group.neg.name
15+
16+
instance = google_compute_instance.endpoint-instance.name
17+
ip_address = google_compute_instance.endpoint-instance.network_interface[0].network_ip
18+
}
19+
20+
data "google_compute_image" "my_image" {
21+
family = "debian-12"
22+
project = "debian-cloud"
23+
}
24+
25+
resource "google_compute_instance" "endpoint-instance" {
26+
name = "rbs-instance-${local.name_suffix}"
27+
machine_type = "e2-medium"
28+
29+
boot_disk {
30+
initialize_params {
31+
image = data.google_compute_image.my_image.self_link
32+
}
33+
}
34+
35+
network_interface {
36+
subnetwork = google_compute_subnetwork.default.id
37+
access_config {
38+
}
39+
}
40+
}
41+
42+
resource "google_compute_network_endpoint_group" "neg" {
43+
name = "rbs-neg-${local.name_suffix}"
44+
network_endpoint_type = "GCE_VM_IP"
45+
network = google_compute_network.default.id
46+
subnetwork = google_compute_subnetwork.default.id
47+
zone = "us-central1-a"
48+
}
49+
50+
resource "google_compute_region_backend_service" "default" {
51+
region = "us-central1"
52+
name = "region-service-${local.name_suffix}"
53+
protocol = "UDP"
54+
load_balancing_scheme = "EXTERNAL"
55+
network = google_compute_network.default.id
56+
backend {
57+
group = google_compute_network_endpoint_group.neg.self_link
58+
balancing_mode = "CONNECTION"
59+
}
60+
ha_policy {
61+
fast_ip_move = "GARP_RA"
62+
leader {
63+
backend_group = google_compute_network_endpoint_group.neg.self_link
64+
network_endpoint {
65+
instance = google_compute_instance.endpoint-instance.name
66+
}
67+
}
68+
}
69+
// Must explicitly disable connection draining to override default value.
70+
connection_draining_timeout_sec = 0
71+
}

‎region_backend_service_ha_policy_manual_leader/motd‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
===
2+
3+
These examples use real resources that will be billed to the
4+
Google Cloud Platform project you use - so make sure that you
5+
run "terraform destroy" before quitting!
6+
7+
===

‎region_backend_service_ha_policy_manual_leader/tutorial.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Region Backend Service Ha Policy Manual Leader - Terraform
2+
3+
## Setup
4+
5+
<walkthrough-author name="[email protected]" analyticsId="UA-125550242-1" tutorialName="region_backend_service_ha_policy_manual_leader" repositoryUrl="https://github.com/terraform-google-modules/docs-examples"></walkthrough-author>
6+
7+
Welcome to Terraform in Google Cloud Shell! We need you to let us know what project you'd like to use with Terraform.
8+
9+
<walkthrough-project-billing-setup></walkthrough-project-billing-setup>
10+
11+
Terraform provisions real GCP resources, so anything you create in this session will be billed against this project.
12+
13+
## Terraforming!
14+
15+
Let's use {{project-id}} with Terraform! Click the Cloud Shell icon below to copy the command
16+
to your shell, and then run it from the shell by pressing Enter/Return. Terraform will pick up
17+
the project name from the environment variable.
18+
19+
```bash
20+
export GOOGLE_CLOUD_PROJECT={{project-id}}
21+
```
22+
23+
After that, let's get Terraform started. Run the following to pull in the providers.
24+
25+
```bash
26+
terraform init
27+
```
28+
29+
With the providers downloaded and a project set, you're ready to use Terraform. Go ahead!
30+
31+
```bash
32+
terraform apply
33+
```
34+
35+
Terraform will show you what it plans to do, and prompt you to accept. Type "yes" to accept the plan.
36+
37+
```bash
38+
yes
39+
```
40+
41+
42+
## Post-Apply
43+
44+
### Editing your config
45+
46+
Now you've provisioned your resources in GCP! If you run a "plan", you should see no changes needed.
47+
48+
```bash
49+
terraform plan
50+
```
51+
52+
So let's make a change! Try editing a number, or appending a value to the name in the editor. Then,
53+
run a 'plan' again.
54+
55+
```bash
56+
terraform plan
57+
```
58+
59+
Afterwards you can run an apply, which implicitly does a plan and shows you the intended changes
60+
at the 'yes' prompt.
61+
62+
```bash
63+
terraform apply
64+
```
65+
66+
```bash
67+
yes
68+
```
69+
70+
## Cleanup
71+
72+
Run the following to remove the resources Terraform provisioned:
73+
74+
```bash
75+
terraform destroy
76+
```
77+
```bash
78+
yes
79+
```

0 commit comments

Comments
 (0)