Terraform Azure Provider Overview

The officially supported Nitric Terraform Azure Provider.

provider: nitric/azuretf@latest

Prerequisites

The Terraform CLI is required to deploy the resulting Terraform Stack that Nitric generates. You can find the installation instructions for Terraform in the Terraform documentation.

The provider is built with the Cloud Development Kit for Terraform (CDKTF). Since CDKTF relies on Node.js, you'll need to have Node.js installed, you can read about the full CDKTF prerequisites in the CDKTF documentation.

Azure Credentials

The Terraform CLI typically uses standard Azure credential settings to authenticate with Azure. If you've set credentials for the Azure CLI or an Azure SDK previously, these settings should work without modification.

If you're setting up your credentials for the first time, simply run azure login command and finish the login via your browser.

az login

Verify the Azure CLI install -

az -v

Azure CLI Installation

Installing the Azure CLI assists with credentials setup. You can install it using these summarized instructions, for more options see the Microsoft docs.

Locating deployed resources

This Nitric Azure provider deploys resources for a stack into a resource group dedicated to that stack. You can either use one that you already have by configuring it in the stack configuration or let Nitric create one for you.

Once a stack has been deployed to Azure it's resource group should be present in the Resource groups page of the portal. Assuming it was deployed to a subscription you have access to.

Stack Configuration

# The provider to use and its published version
# See releases:
# https://github.com/nitrictech/nitric/tags
provider: nitric/azuretf@latest

# The target Azure region to deploy to
# See available regions:
# https://azure.microsoft.com/en-us/explore/global-infrastructure/products-by-region/?products=container-apps
region: my-azure-stack-region

# Org to associate deployed API Management services with
org: example-org

# Admin email to associate deployed API Management services with
adminemail: test@example.com

# Subscription ID to associate deployed services with
subscription-id: example-subscription-id

# Add CDN configuration, required for custom domains for website deployments
# Available since v1.23.0
cdn:
  # The name of the Azure DNS Zone to use when configuring the website DNS
  zone-name: example.com
  # The resource group name of the DNS Zone you configured in Azure DNS Zones
  zone-resource-group: yourzone-rg
  # A valid domain or subdomain for the DNS Zone to use for the deployed websites endpoint
  domain-name: app.example.com
  # Skip CDN cache invalidation during deployments (defaults to false)
  skip-cache-invalidation: true