Skip to content

f5devcentral/terraform-xc-azure-ce

Repository files navigation

Overview

Terraform templates to create F5XC Azure cloud CE (manual mode deployment).

Requirements

Name Version
terraform >= 1.7.0
curl >= 1.7
git >= 8.0
jq latest

OS Platform

Name Status
Linux supported
Mac OS (Sonoma) supported
Windows unsupported

Installation

Usage

  • Clone this repo with: git clone --recurse-submodules https://github.com/f5devcentral/terraform-xc-azure-ce
  • Enter repository directory with: cd terraform-xc-azure-ce
  • Follow usage description in topologies section
  • Multiple examples in example directory are available. Change to example directory that is to be deployed with cd examples/<example_dir_name>

Input variables

Description of available input variables. Used input variables will change per topology example:

Name Description
SLO Site local outside interface (external interface / egress interface)
SLI Site local inside interface (internal interface ( ingress interface)
owner Tag Azure objects with creator / owner email address
project_prefix String added at the beginning of various AWS / F5 XC object identifier. <project_prefix>_<object>
project_suffix String added at the end of various AWS / F5 XC object identifier. <project_prefix>_<object>_<project_suffix>
Example prefix + suffix for F5XC site name project_prefix_cluster_name_project_suffix
f5xc_tenant Full f5 xc tenant name e.g. playground-abcdefg
f5xc_api_url F5 XC API URL e.g. https://https://playground.console.ves.volterra.io/api
f5xc_cluster_name F5 XC cluster name e.g. "azure-ce-test"
f5xc_api_p12_file Path to F5 XC exported API cert file
f5xc_azure_az_node0 Azure availability zone for cluster node0 e.g. "1"
f5xc_azure_az_node1 Azure availability zone for cluster node1 e.g. "2"
f5xc_azure_az_node2 Azure availability zone for cluster node2 e.g. "3"
f5xc_azure_vnet_slo_subnet_node0 F5 XC node0 SLO interface subnet e.g. "192.168.0.0/26"
f5xc_azure_vnet_sli_subnet_node0 F5 XC node0 SLI interface subnet e.g. "192.168.0.64/26"
f5xc_azure_vnet_slo_subnet_node1 F5 XC node1 SLO interface subnet e.g. "192.168.0.0/26"
f5xc_azure_vnet_sli_subnet_node1 F5 XC node1 SLI interface subnet e.g. "192.168.0.64/26"
f5xc_azure_vnet_slo_subnet_node2 F5 XC node2 SLO interface subnet e.g. "192.168.0.0/26"
f5xc_azure_vnet_sli_subnet_node2 F5 XC node2 SLI interface subnet e.g. "192.168.0.64/26"
azurerm_region Azure region to deploy CE into
azurerm_marketplace_version CE virtual instance image version e.g. 0.9.2
azurerm_vnet_address_space Azure vnet address space provided as list list strings e.g. ["192.168.1.0/24", "192.168.2.0/24"]
azurerm_existing_vnet_name Azure existing VNET name
azurerm_existing_resource_group Azure existing resource group name

Topologies

Name Description
Single Node Single NIC new VNET / subnet Description
Single Node Multi NIC new VNET / subnet Description
Single Node Single NIC Existing VNET / new subnet Description
Single Node Multi NIC Existing VNET / new subnet Description
Single Node Single NIC existing VNET / subnet Description
Single Node Multi NIC existing VNET / subnet Description
Single Node Multi NIC existing VNET / new subnet with SLO no PiP / GW Router Description
Single Node Single NIC existing VNET / subnet and 3rd party NAT GW Description
Single Node Multi NIC existing VNET / subnet and 3rd party NAT GW Description
Single Node AppStack Cluster new VNET / subnet Description
Single Node AppStack Cluster existing VNET / new subnet Description
Three Node Cluster Single NIC new VNET / subnet Description
Three Node Cluster Single NIC existing VNET / new subnet Description
Three Node Cluster Single NIC existing VNET / subnet Description
Three Node Cluster Multi NIC new VNET / subnet Description
Three Node Cluster Multi NIC existing VNET / new subnet Description
Three Node Single NIC existing VNET / subnet and 3rd party NAT GW Description
Three Node Multi NIC existing VNET / subnet and 3rd party NAT GW Description
Three Node AppStack Cluster new VNET / subnet Description
Three Node AppStack Cluster existing VNET / new subnet Description

Feature specific examples

Name Description
Single Node with offline survivability mode and l3 performance enhancement mode Description
Single Node single NIC new VNET and subnet with custom security group Description

ClickOps

Find CE cloud-config example for ClickOps deployment at Cloud-Config

Support

For support, please open a GitHub issue. Note, the code in this repository is community supported and is not supported by F5 Networks. For a complete list of supported projects please reference SUPPORT.md.

Community Code of Conduct

Please refer to the F5 DevCentral Community Code of Conduct.

License

Apache License 2.0

Copyright

Copyright 2014-2020 F5 Networks Inc.

F5 Networks Contributor License Agreement

Before you start contributing to any project sponsored by F5 Networks, Inc. (F5) on GitHub, you will need to sign a Contributor License Agreement (CLA).

If you are signing as an individual, we recommend that you talk to your employer (if applicable) before signing the CLA since some employment agreements may have restrictions on your contributions to other projects. Otherwise, by submitting a CLA you represent that you are legally entitled to grant the licenses recited therein.

If your employer has rights to intellectual property that you create, such as your contributions, you represent that you have received permission to make contributions on behalf of that employer, that your employer has waived such rights for your contributions, or that your employer has executed a separate CLA with F5.

If you are signing on behalf of a company, you represent that you are legally entitled to grant the license recited therein. You represent further that each employee of the entity that submits contributions is authorized to submit such contributions on behalf of the entity pursuant to the CLA.