services	platforms	author
azure-resource-manager	ruby	hocavazo

Nested Template Deployment: Networking Components, Availability Sets, and Mock Domain Controllers (blank deployment).

This sample explains how to use Azure Resource Manager templates to deploy your Resources to Azure. It shows how to deploy your Resources by using the Azure SDK for Ruby.

When deploying an application definition with a template, you can provide parameter values to customize how the resources are created. You specify values for these parameters either inline or in a parameter file.

Incremental Deployments Only

By default, Resource Manager handles deployments as incremental updates to the resource group. With incremental deployment, Resource Manager:

• leaves unchanged resources that exist in the resource group but are not specified in the template
• adds resources that are specified in the template but do not exist in the resource group
• does not re-provision resources that exist in the resource group in the same condition defined in the template

Nested Templates do not support Complete Mode.

Deploy with Ruby

In this sample, we use the parent template to define and deploy 3 specific resource deployments. The resource deployments are defined as Networking, WebResources, and DCs. Each resource deployment has a separate set of parameters and a template link uri.

Deployments Networking - deploys a network, 7 subnets, and 7 network security groups with a dependency on the network security groups. Meaning, the the Network and Subnet will not deploy until the network security groups have been deployed. WebResources - deploys 5 availability sets with a uniquely defined naming convention. DCs - this is a deployment of blank templates. You'll need to define this deployment on your own.

here.

To run this sample, do the following:

You will need to create an Azure service principal either through Azure CLI, PowerShell or the portal. You should gather each the Tenant Id, Client Id and Client Secret from creating the Service Principal for use below.

• Create a Service Principal
• git clone https://github.com/insidepowershell/resource-manager-ruby-template-deployment.git
• cd resource-manager-ruby-template-deployment
• bundle install
• export AZURE_TENANT_ID={your tenant id}
• export AZURE_CLIENT_ID={your client id}
• export AZURE_CLIENT_SECRET={your client secret}
• bundle exec ruby azure_deployment.rb

What is this azure_deployment.rb Doing?

The entry point for this sample is azure_deployment.rb. This script uses the deployer class below to deploy a the aforementioned template to the subscription and resource group specified in my_resource_group and my_subscription_id respectively. By default the script will use the ssh public key from your default ssh location.

• Note: you must set each of the below environment variables (AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET) prior to running the script.*

What is this lib/deployer.rb Doing?

The Deployer class does the following:

1. The initialize method initializes the class with subscription, resource group and public key. The method also fetches the Azure Active Directory bearer token, which will be used in each HTTP request to the Azure Management API. The class will raise an ArgumentError under two conditions, if the public key path does not exist or if there are empty values for Tenant Id, Client Id or Client Secret environment variables.

2. The deploy method does the heavy lifting of creating or updating the resource group, preparing the template, parameters and deploying the template.

3. The destroy method simply deletes the resource group thus deleting all of the resources within that group.

Each of these methods use the Azure::ARM::Resources::ResourceManagementClient class, which resides within the azure_mgmt_resources gem (see the rdocs docs here).

After the script runs, you should see something like the following in your output:

$ bundle exec ruby azure_deployment.rb

Initializing the Deployer class with subscription id: 11111111-1111-1111-1111-111111111111, resource group: azure-ruby-deployment-sample
and public key located at: /Users/you/.ssh/id_rsa.pub...

Beginning the deployment...

Done deploying!!

How to enable logs and retrieve operation logs?

To enable logging of the request and response contents of template deployment, we can set the debug_setting property of DeploymentProperties model as shown in this sample. By default, ARM does not log any content. By logging information about the request or response, you could potentially expose sensitive data that is retrieved through the deployment operations. To disable them set it to none.

If logging is enabled, we can use list operation of the deployment_operations to retrieve the results as shown in this sample.