/terraform-google-sql-db

Modular Cloud SQL database instance for Terraform.

Primary LanguageHCLApache License 2.0Apache-2.0

terraform-google-sql

terraform-google-sql makes it easy to create Google CloudSQL instance and implement high availability settings. This module consists of the following submodules:

See more details in each module's README.

Requirements

Installation Dependencies

Configure a Service Account

In order to execute this module you must have a Service Account with the following:

Roles

  • roles/cloudsql.admin

Enable APIs

In order to operate with the Service Account you must activate the following APIs on the project where the Service Account was created:

  • Cloud SQL API

Service Account Credentials

You can pass the service account credentials into this module by setting the following environment variables:

  • GOOGLE_CREDENTIALS
  • GOOGLE_CLOUD_KEYFILE_JSON
  • GCLOUD_KEYFILE_JSON

See more details.

Testing

Requirements

Generate docs automatically

$ make generate_docs

Integration Test

The integration tests for this module leverage kitchen-terraform and kitchen-inspec.

You must set up by manually before running the integration test:

for instance in mysql-simple mysql-ha postgresql-simple postgresql-ha; do
  cp "test/fixtures/$instance/terraform.tfvars.example" "test/fixtures/$instance/terraform.tfvars"
  $EDITOR "test/fixtures/$instance/terraform.tfvars"
done

And then, you should pass the service account credentials for running inspec by setting the following environment variables:

  • GOOGLE_APPLICATION_CREDENTIALS

The tests will do the following:

  • Perform bundle install command
    • Installs test-kitchen, kitchen-terraform and kitchen-inspec
  • Perform bundle exec kitchen create command
    • Performs terraform init
  • Perform bundle exec kitchen converge command
    • Performs terraform apply -auto-approve
  • Perform bundle exec kitchen verify command
    • Performs inspec tests
  • Perform bundle exec kitchen destroy command
    • Performs terraform destroy -force

You can use the following command to run the integration test in the root directory.

$ make test_integration

Linting

The makefile in this project will lint or sometimes just format any shell, Python, golang, Terraform, or Dockerfiles. The linters will only be run if the makefile finds files with the appropriate file extension.

All of the linter checks are in the default make target, so you just have to run

$ make -s

The -s is for 'silent'. Successful output looks like this

Running shellcheck
Running flake8
Running go fmt and go vet
Running terraform validate
Running terraform fmt
Running hadolint on Dockerfiles
Checking for required files
The following lines have trailing whitespace
Generating markdown docs with terraform-docs

The linters are as follows:

  • Shell - shellcheck. Can be found in homebrew
  • Python - flake8. Can be installed with pip install flake8
  • Golang - gofmt. gofmt comes with the standard golang installation. golang -s a compiled language so there is no standard linter.
  • Terraform - terraform has a built-in linter in the terraform validate command.
  • Dockerfiles - hadolint. Can be found in homebrew