Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/memes/terraform-google-f5-bigip-next

Testing repo for BIG-IP Next on GCP
https://github.com/memes/terraform-google-f5-bigip-next

Last synced: 7 days ago
JSON representation

Testing repo for BIG-IP Next on GCP

Host: GitHub
URL: https://github.com/memes/terraform-google-f5-bigip-next
Owner: memes
License: apache-2.0
Created: 2022-08-12T03:29:20.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2024-07-16T02:01:59.000Z (6 months ago)
Last Synced: 2024-07-16T05:13:12.199Z (6 months ago)
Language: HCL
Size: 94.7 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # BIG-IP Next pre-release testing framework

## Prerequisites

1. GNU Make

2. Ruby 3.0.4; use `bundle install` to add required packages

3. Terraform 1.2.x

## Kitchen-terraform targets

> NOTE: The example targets use the same IP addresses; only one example can be

> converged at any time.

* `ex-ve-ea-std` Standalone BIG-IP Next with fixed addresses to match Postman collection

   > NOTE: SSH key(s) will be fetched from project metadata

* `ex-ve-ea-ha-cm` Pair of BIG-IP Next VMs and single BIG-IP CM VM with fixed

   addresses to match Postman collection

   > NOTE: SSH key(s) will be fetched from project metadata

* `root` Pair of BIG-IP Next VMs with dynamic addresses

   > NOTE: SSH key(s) will be fetched from project metadata

* `root-vm-ssh` Pair of BIG-IP Next VMs with dynamic addresses and generated SSH

  key in VM metadata

* `root-ssh-udata` Pair of BIG-IP Next VMs with dynamic addresses and generated

  SSH key in VM metadata, and minimal `user-data` with `cloud-config`

## Use with Postman collection

The example folder contains Terraform that matches Postman expectations. These

can be execute independently, or through the test framework `makefile`.

1. Create `test/setup/terraform.tfvars` with required values

2. With GNU Make, launch the standalone or HA example

   ```shell

   gmake converge.ex-ve-ea-ha-cm

   ```

3. In a separate shell, launch the HTTP proxy tunnel

   ```shell

   eval "$(terraform -chdir=test/setup output -raw tunnel_command)"

   ```

   ```text

   Testing if tunnel connection works.

   Listening on port [8888].

   ```

4. Configure Postman to use `localhost:8888` as HTTPS proxy

5. Use Postman collection for scenario

6. To swap scenarios, destroy then converge to new scenario

   E.g. to remove HA w/CM and go to standalone

   ```shell

   gmake destroy.ex-ve-ea-ha-cm

   gmake converge.ex-ve-ea-std

   ```

7. Teardown all infrastructure

   ```shell

   gmake clean

   ```

## Requirements

| Name | Version |

|------|---------|

|  [terraform](#requirement\_terraform) | >= 1.2 |

|  [google](#requirement\_google) | >= 4.31 |

## Modules

No modules.

## Resources

| Name | Type |

|------|------|

| [google_compute_firewall.ha](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_firewall) | resource |

| [google_compute_instance.bigip](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/compute_instance) | resource |

| [google_compute_subnetwork.external](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/compute_subnetwork) | data source |

| [google_compute_subnetwork.ha](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/compute_subnetwork) | data source |

| [google_compute_subnetwork.internal](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/compute_subnetwork) | data source |

| [google_compute_subnetwork.management](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/compute_subnetwork) | data source |

| [google_compute_zones.zones](https://registry.terraform.io/providers/hashicorp/google/latest/docs/data-sources/compute_zones) | data source |

## Inputs

| Name | Description | Type | Default | Required |

|------|-------------|------|---------|:--------:|

|  [image](#input\_image) | A fully-qualified Compute Engine image or family name to use with the instances.
Must be of the format `projects/project-id/global/images/image-name` or
`projects/project-id/global/images/family/family-name`. | `string` | n/a | yes |

|  [name](#input\_name) | The name to use for generated resources. | `string` | n/a | yes |

|  [project\_id](#input\_project\_id) | The GCP project identifier where the cluster will be created. | `string` | n/a | yes |

|  [service\_account](#input\_service\_account) | The service account that will be used for the BIG-IP VMs. | `string` | n/a | yes |

|  [subnets](#input\_subnets) | Fully-qualified subnet self-links for each VPC network that BIG-IP Next instances
will be attached to. | 
object({
    management = string
    external   = string
    internal   = string
    ha         = string
  }) | n/a | yes |

|  [ip\_assignments](#input\_ip\_assignments) | n/a | list(object({
    offsets         = list(number)
    floating_offset = number
  }))
 | [
  {
    "floating_offset": null,
    "offsets": []
  },
  {
    "floating_offset": null,
    "offsets": []
  }
] | no |

|  [labels](#input\_labels) | An optional map of *labels* to add to the instances. | `map(string)` | `{}` | no |

|  [machine\_type](#input\_machine\_type) | The machine type to use for BIG-IP VMs; this may be a standard GCE machine type,
or a customised VM ('custom-VCPUS-MEM\_IN\_MB'). Default value is 'e2-standard-8'. | `string` | `"e2-standard-8"` | no |

|  [metadata](#input\_metadata) | An optional map of metadata values that will be applied to the instances. Use
this to add user-data configuration, for example. | `map(string)` | `{}` | no |

|  [min\_cpu\_platform](#input\_min\_cpu\_platform) | An optional constraint used when scheduling the BIG-IP VMs; this value prevents
the VMs from being scheduled on hardware that doesn't meet the minimum CPU
micro-architecture, and if specified it must be compatible with the value of
'machine-type'. Default value is empty. | `string` | `null` | no |

|  [tags](#input\_tags) | An optional list of *network tags* to add to the instances. | `list(string)` | `[]` | no |

## Outputs

| Name | Description |

|------|-------------|

|  [instance\_addresses](#output\_instance\_addresses) | A map of instance name to assigned private IP addresses and alias CIDRs on each interface. |

|  [instance\_public\_addresses](#output\_instance\_public\_addresses) | A map of instance name to external public IP addresses on each interface. |

|  [self\_links](#output\_self\_links) | A list of self-links of the BIG-IP instances. |