Publish a new Access Gateway image version

Identify a new Virtual Hard Disk (VHD) image, publish a new version of the Okta Access Gateway image with the Azure CLI, and verify successful deployment.

Before you begin

  • Determine the version number, which uses the format YYYY.M.Patch. For example, the release for August 2026 is 2026.8.0.
  • Retrieve the full URI of the new VHD file from the appropriate container within your storage account.
  1. To create the image, run the following command. In the command template, replace the placeholders with the appropriate values: 
    # Command to create a new version of the OAG image
az sig image-version create \
    --resource-group rg-oag-qa-env \
    --gallery-name AZ_OAG_OL8 \
    --gallery-image-definition okta-access-gateway \
    --gallery-image-version <YYYY.M.PATCH> \
    --os-vhd-uri "<FULL_URI_TO_NEW_VHD>" \
    --os-vhd-storage-account "/subscriptions/<Azure_subscription_ID>/resourceGroups/resourcegroup1/providers/Microsoft.Storage/storageAccounts/<Azure_storage_account>" \
    --location "East US"
  2. To verify the new image version, run the following command: 
    # List all versions for the OAG image definition
az sig image-version list \
    --resource-group rg-oag-qa-env \
    --gallery-name AZ_OAG_OL8 \
    --gallery-image-definition okta-access-gateway \
    --output table
  3. Verify that the provisioningState for the new version is Succeeded, which means that the new version was created successfully.