/terraforming-azure

use terraform, deploy yourself a pcf

Primary LanguageHCLApache License 2.0Apache-2.0

Terraforming Azure build-status

How Does One Use This?

Please note that the master branch is generally unstable. If you are looking for something "tested", please consume one of our releases.

What Does This Do?

Will go from zero to having a deployed ops-manager. You'll get networking, a storage account, and a booted ops-manager VM.

Looking to setup a different IAAS

We have other terraform templates to help you!

Prerequisites

brew update
brew install terraform

Creating An Automation Account

You need an automation account to deploy anything on top of Azure. However, before you can create an automation account you must be able to log into the Azure portal.

First, find your account by running the following commands using the Azure CLI:

azure login
azure account list

To create the automation account, you need az-automation. You can use brew or go to the releases and get the necessary binary.

brew tap genevieve/tap
brew install az-automation

Then run:

az-automation \
  --account some-account-id \
  --identifier-uri http://example.com \
  --display-name some-display-name \
  --credential-output-file some-credentials.tfvars

The file created as an output here should include the following:

subscription_id = "some-subscription-id"
tenant_id       = "some-tenant-id"
client_id       = "some-client-id"
client_secret   = "some-client-secret"

Deploying Ops Manager

Depending if you're deploying PAS or PKS you need to perform the following steps:

  1. cd into the proper directory:
  2. Create terraform.tfvars file
  3. Run terraform apply:
terraform init
terraform plan -out=plan
terraform apply plan

Var File

Copy the stub content below into a file called terraform.tfvars and put it in the root of this project. These vars will be used when you run terraform apply. You should fill in the stub values with the correct content.

subscription_id = "some-subscription-id"
tenant_id       = "some-tenant-id"
client_id       = "some-client-id"
client_secret   = "some-client-secret"

env_name              = "banana"
ops_manager_image_uri = "url-to-opsman-image"
location              = "West US"
dns_suffix            = "domain.com"

# optional. if left blank, will default to the pattern `env_name.dns_suffix`.
dns_subdomain         = ""

Variables

  • env_name: (required) An arbitrary unique name for namespacing resources
  • subscription_id: (required) Azure account subscription id
  • tenant_id: (required) Azure account tenant id
  • client_id: (required) Azure automation account client id
  • client_secret: (required) Azure automation account client secret
  • ops_manager_image_uri: (required) URL for an OpsMan image hosted on Azure
  • location: (required) Azure location to stand up environment in
  • dns_suffix: (required) Domain to add environment subdomain to

Optional

When deploying the isolation segments tile you can optionally route traffic through a separate domain and load balancer by specifying:

  • isolation_segment: (default false) Creates a DNS record and load balancer for isolation segment network traffic when set to true.

Running

Note: please make sure you have created the terraform.tfvars file above as mentioned.

Standing up environment

terraform init
terraform plan -out=plan
terraform apply plan

Tearing down environment

Note: This will only destroy resources deployed by Terraform. You will need to clean up anything deployed on top of that infrastructure yourself (e.g. by running om delete-installation)

terraform destroy