Terraform(GCP): OpenWISP

Terraform files for deploying docker-openwisp infrastructure in Google Cloud. This module creates the infrastructure required for deploying the kubernetes cluster.

Requirements

1. Create a Google Cloud service account that has atleast the following roles:

   • Compute Admin
   • Compute Network Admin
   • Compute Security Admin
   • Kubernetes Engine Admin
   • Service Account User
   • Service Usage Admin
   • DNS Administrator (When google_services.use_cloud_dns is true)
   • Cloud SQL Admin (When google_services.use_cloud_sql is true)

2. Enable following APIs allow terraform to create resources:

   • serviceusage.googleapis.com
   • cloudresourcemanager.googleapis.com

3. If you using the following options, please follow the requirements as per the variable's documentation:

• google_services.configure_gloud

Usage

Note: The following links work only when you are viewing on github.com

Variables

• Inputs documentation available here.
• Outputs documentation available here.

Examples

• Standalone example available here.

Create:

1. Configure the options in the module. (examples/ may be helpful)
2. Apply the configurations: terraform apply
3. If using Cloud DNS, get the NS records and add them in your domain registrar records.
4. Destroy resources only required for management (Creation / Updation)

terraform destroy \
    --target=module.infrastructure.google_compute_router.openwisp_cluster_router \
    --target=module.infrastructure.google_compute_router_nat.openwisp_connection_nat

Destroy:

Remember to use terraform when you want to destroy a resource created by terraform. To destroy all resources: terraform destroy

Contribute to documentation

Some of the parts of documentations are re-used from the terraform-kubernetes-openwisp to reduce maintenance, changes need to made in that repository in such cases.

1. Install MarkdownPP: pip install MarkdownPP
2. Make changes in docs/build/ directory.
3. To create documentation, in the root of repository:

markdown-pp docs/build/input.mdpp -o docs/input.md
markdown-pp docs/build/output.mdpp -o docs/output.md