Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
package

GitHub Action

Azure Resource Manager (ARM) Template Deployment

v3.2

Azure Resource Manager (ARM) Template Deployment

package

Azure Resource Manager (ARM) Template Deployment

Use this GitHub Action task deploy an Azure Resource Manager (ARM) template

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Azure Resource Manager (ARM) Template Deployment

uses: whiteducksoftware/azure-arm-action@v3.2

Learn more about this action in whiteducksoftware/azure-arm-action

Choose a version

GitHub Action for Azure Resource Manager (ARM) deployment

A GitHub Action to deploy ARM templates.

build and publish go report License: MIT

white duck logo

Dependencies

  • Checkout To checks-out your repository so the workflow can access any specified ARM template.

Inputs

  • creds Required
    Create Service Principal for Authentication

  • templateLocation Required
    Specify the path to the Azure Resource Manager template.
    (See assets/json/template.json)

  • resourceGroupName
    Provide the name of a resource group.
    If you dont pass a resource group name the template will be deployed at subscription scope

  • deploymentMode
    Incremental (only add resources to resource group) or Complete (remove extra resources from resource group). Default: Incremental.

  • deploymentName
    Specifies the name of the resource group deployment to create.

  • parameters
    Specify the path to the Azure Resource Manager parameters file or pass them as space delimited Key-Value Pairs.
    (See examples/Advanced.md)

  • overrideParameters
    Specify the path to the Azure Resource Manager override parameters file or pass them as space delimited Key-Value Pairs.
    (See examples/Advanced.md)

Outputs

Every template output will be exported as output. For example the output is called containerName then it will be available with ${{ steps.STEP.outputs.containerName }}
For more Information see examples/Advanced.md.
Additionally are the following outputs available:

  • deploymentName Specifies the complete deployment name which has been generated

Usage

- uses: whiteducksoftware/azure-arm-action@v3.2
  with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}
    resourceGroupName: <YourResourceGroup>
    templateLocation: <path/to/azuredeploy.json>
    deploymentName: <Deployment base name>

Example

on: [push]
name: ARMActionSample

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - uses: whiteducksoftware/azure-arm-action@v3.2
      with:
        creds: ${{ secrets.AZURE_CREDENTIALS }}
        resourceGroupName: <YourResourceGroup>
        templateLocation: <path/to/azuredeploy.json>
        parameters: <path/to/parameters.json> OR <KEY=VALUE>
        deploymentName: <Deployment base name>

For more advanced workflows see examples/Advanced.md.