Merge pull request #203579 from ericd-mst-github/erd-build-image-with-packer

Updated packer content with HCL examples

Author: PRMerger6

articles/virtual-machines/linux/build-image-with-packer.md

@@ -62,7 +62,7 @@ You use the output from these two commands in the next step.
 ## Define Packer template
 To build images, you create a template as a JSON file. In the template, you define builders and provisioners that carry out the actual build process. Packer has a [provisioner for Azure](https://www.packer.io/docs/builders/azure.html) that allows you to define Azure resources, such as the service principal credentials created in the preceding step.
 
-Create a file named *ubuntu.json* and paste the following content. Enter your own values for the following:
+Create a file named *ubuntu.json* and paste the following content. Enter your own values for the following parameters:
 
 | Parameter                           | Where to obtain |
 |-------------------------------------|----------------------------------------------------|
@@ -114,6 +114,40 @@ Create a file named *ubuntu.json* and paste the following content. Enter your ow
   }]
 }
 ```
+You can also create a filed named *ubuntu.pkr.hcl* and paste the following content with your own values as used for the above parameters table.
+
+```HCL
+source "azure-arm" "autogenerated_1" {
+  azure_tags = {
+    dept = "Engineering"
+    task = "Image deployment"
+  }
+  client_id                         = "f5b6a5cf-fbdf-4a9f-b3b8-3c2cd00225a4"
+  client_secret                     = "0e760437-bf34-4aad-9f8d-870be799c55d"
+  image_offer                       = "UbuntuServer"
+  image_publisher                   = "Canonical"
+  image_sku                         = "16.04-LTS"
+  location                          = "East US"
+  managed_image_name                = "myPackerImage"
+  managed_image_resource_group_name = "myResourceGroup"
+  os_type                           = "Linux"
+  subscription_id                   = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
+  tenant_id                         = "72f988bf-86f1-41af-91ab-2d7cd011db47"
+  vm_size                           = "Standard_DS2_v2"
+}
+
+build {
+  sources = ["source.azure-arm.autogenerated_1"]
+
+  provisioner "shell" {
+    execute_command = "chmod +x {{ .Path }}; {{ .Vars }} sudo -E sh '{{ .Path }}'"
+    inline          = ["apt-get update", "apt-get upgrade -y", "apt-get -y install nginx", "/usr/sbin/waagent -force -deprovision+user && export HISTSIZE=0 && sync"]
+    inline_shebang  = "/bin/sh -x"
+  }
+
+}
+```
+
 
 This template builds an Ubuntu 16.04 LTS image, installs NGINX, then deprovisions the VM.
 
@@ -131,6 +165,12 @@ Build the image by specifying your Packer template file as follows:
 ./packer build ubuntu.json
 ```
 
+You can also build the image by specifying the *ubuntu.pkr.hcl* file as follows:
+
+```bash
+packer build ubuntu.pkr.hcl
+```
+
 An example of the output from the preceding commands is as follows:
 
 ```output
@@ -196,7 +236,7 @@ It takes a few minutes for Packer to build the VM, run the provisioners, and cle
 
 
 ## Create VM from Azure Image
-You can now create a VM from your Image with [az vm create](/cli/azure/vm). Specify the Image you created with the `--image` parameter. The following example creates a VM named *myVM* from *myPackerImage* and generates SSH keys if they do not already exist:
+You can now create a VM from your Image with [az vm create](/cli/azure/vm). Specify the Image you created with the `--image` parameter. The following example creates a VM named *myVM* from *myPackerImage* and generates SSH keys if they don't already exist:
 
 ```azurecli
 az vm create \

articles/virtual-machines/windows/build-image-with-packer.md

@@ -41,7 +41,7 @@ Packer authenticates with Azure using a service principal. An Azure service prin
 Create a service principal with [New-AzADServicePrincipal](/powershell/module/az.resources/new-azadserviceprincipal). The value for `-DisplayName` needs to be unique; replace with your own value as needed.  
 
 ```azurepowershell
-$sp = New-AzADServicePrincipal -DisplayName "PackerSP$(Get-Random)"
+$sp = New-AzADServicePrincipal -DisplayName "PackerPrincipal" -role Contributor -scope /subscriptions/yyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyy
 $plainPassword = (New-AzADSpCredential -ObjectId $sp.Id).SecretText
 ```
 
@@ -119,6 +119,42 @@ Create a file named *windows.json* and paste the following content. Enter your o
   }]
 }
 ```
+You can also create a filed named *windows.pkr.hcl* and paste the following content with your own values as used for the above parameters table.
+
+```HCL
+source "azure-arm" "autogenerated_1" {
+  azure_tags = {
+    dept = "Engineering"
+    task = "Image deployment"
+  }
+  build_resource_group_name         = "myPackerGroup"
+  client_id                         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
+  client_secret                     = "ppppppp-pppp-pppp-pppp-ppppppppppp"
+  communicator                      = "winrm"
+  image_offer                       = "WindowsServer"
+  image_publisher                   = "MicrosoftWindowsServer"
+  image_sku                         = "2016-Datacenter"
+  managed_image_name                = "myPackerImage"
+  managed_image_resource_group_name = "myPackerGroup"
+  os_type                           = "Windows"
+  subscription_id                   = "yyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyy"
+  tenant_id                         = "zzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz"
+  vm_size                           = "Standard_D2_v2"
+  winrm_insecure                    = true
+  winrm_timeout                     = "5m"
+  winrm_use_ssl                     = true
+  winrm_username                    = "packer"
+}
+
+build {
+  sources = ["source.azure-arm.autogenerated_1"]
+
+  provisioner "powershell" {
+    inline = ["Add-WindowsFeature Web-Server", "while ((Get-Service RdAgent).Status -ne 'Running') { Start-Sleep -s 5 }", "while ((Get-Service WindowsAzureGuestAgent).Status -ne 'Running') { Start-Sleep -s 5 }", "& $env:SystemRoot\\System32\\Sysprep\\Sysprep.exe /oobe /generalize /quiet /quit", "while($true) { $imageState = Get-ItemProperty HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Setup\\State | Select ImageState; if($imageState.ImageState -ne 'IMAGE_STATE_GENERALIZE_RESEAL_TO_OOBE') { Write-Output $imageState.ImageState; Start-Sleep -s 10  } else { break } }"]
+  }
+
+}
+```
 
 This template builds a Windows Server 2016 VM, installs IIS, then generalizes the VM with Sysprep. The IIS install shows how you can use the PowerShell provisioner to run additional commands. The final Packer image then includes the required software install and configuration.
 
@@ -133,6 +169,11 @@ Build the image by opening a cmd prompt and specifying your Packer template file
 ```
 ./packer build windows.json
 ```
+You can also build the image by specifying the *windows.pkr.hcl* file as follows:
+
+```
+packer build windows.pkr.hcl
+```
 
 An example of the output from the preceding commands is as follows: