Terraform AzureRM ACS
Azure Container Service (ACS), provides a unique approach to managing containers in the cloud by offering a simple way to scale containers in production through proven open source container orchestration technology.
This project is a Terraform module to deploy ACS orchestration technologies while provisioning the minimal infrustrure required for them in a controled way.
- Clone this project on your local machine;
- Install Terraform
- Install Azure CLI 2.0
- Install K8S CLI
- Install Docker CLI
- Install DCOS CLI
- Install the ACS Engine locally
- Follow Terraform's Azure setup guide, using the Azure CLI, toward to fill .tfvars configuration with the azure subscription/tenant/client id/client secret details.
Initialize a Terraform configuration
init command is used to initialize a working directory containing Terraform configuration files. This is the first command that should be run after cloning from version control.
NOTE: It is safe to run this command multiple times.
Configuration of the project is realised through Terraform variables file (e.g.
platform.tfvars) with the following information for a minimal deployment:
azure_subscription_id = "<AZURE-SUBSCRIPTION-ID>" azure_tenant_id = "<AZURE-TENANT-ID>" azure_client_id = "<AZURE-CLIENT-ID>" azure_client_secret = "<AZURE-CLIENT-SECRET>" orchestration_platform = "<AZURE-ACS-PLATFORM>" dns_prefix = "<DNS-PREFIX>" ssh_key = "<SSH-PUBLIC-KEY>"
Further to the above required configuration fields there is a set of optional fields to enable even more fine grained control on the deployed orchestrastion platform as presented in detail below :
# general azure_location = "<AZURE-REGION>" cluster_name = "<CLUSTER-NAME>" resource_group_name = "<AZURE-RESOURCE-GROUP>" deployment_profile = "<DEPLOYMENT-PROFILE>" # network configuration virtual_network_name = "<VIRTUAL-NETWORK-NAME>" cidr = "<CIDR>" cidr_subnet = "<SUBNET-CIDR>" # service configuration vm_size = "<VM-SIZE>" master_vm_count = <MASTER-VM-COUNT> first_master_ip = "<FIRST-MASTER-IP>" worker_vm_count = <WORKER-VM-COUNT> admin_user = "<ADMIN-USER>" diagnostics_profile_enabled = "<DIAGNOSTIC-PROFILE-ENABLED>"
The platform.tfvars.example serve as a complete generic template for different types of the ACS orchestration technologies. In the examples folder concrete examples can be found for all DCOS, Kubernetes and Swarm orchestration platforms.
Since configuration is completed in order to proceed deploying the platform need to run the
terraform apply command issuing the configucation file e.g.
terraform apply -var-file=platform.tfvars
Clean-up of a deployed platform can you done with the
terraform destroy command issuing the configucation file e.g.
terraform destroy -var-file=platform.tfvars
Connect to the cluster
Deployment of the platfomr output provide all the required information to connect in the cluster. Master note can be accessed at
See the contribution guidelines.
Please NOTE this work is still under development and not meant to be used in production.
Copyright 2017 Ioannis Polyzos
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.