Configure the Azure Compute Gallery environment

Set up the Azure Compute Gallery and define the Okta Access Gateway virtual machine image before you deploy image versions.

About this task

Note:

Complete these steps only if you configure the environment for the first time. If the AZ_OAG_OL8 gallery and the okta-access-gateway image definition are already configured, skip to Deploy a new VM from the Access Gateway image.

Before you begin

Ensure that the Azure CLI is installed, authenticated, and updated to the latest version. Before you start, run az upgrade to avoid API payload errors.
Verify that you have the necessary permissions to create and manage resources in the rg-oag-qa-env resource group.
Confirm that an updated Access Gateway Virtual Hard Disk (VHD) file is uploaded to your Azure storage account.

To create the Azure Compute Gallery for your Access Gateway image definitions, run the following command:

# Creates the high-level gallery container
az sig create \
    --gallery-name AZ_OAG_OL8 \
    --resource-group rg-oag-qa-env \
    --location "East US"

To create the VM image definition for the Access Gateway image, run the following command. All subsequent versions of the Access Gateway image are grouped under this definition.

# Creates the image "blueprint" or definition inside the gallery
az sig image-definition create \
    --resource-group rg-oag-qa-env \
    --gallery-name AZ_OAG_OL8 \
    --gallery-image-definition okta-access-gateway \
    --publisher "Okta" \
    --offer "Okta_Access_Gateway" \
    --sku "OAG" \
    --os-type Linux \
    --os-state Specialized \
    --hyper-v-generation V1 \
    --location "East US"