Skip to main content

Azure Cloud Agent Update

On Azure, the Fractal Cloud Agent runs as an App Service in the rg-fractal resource group of your management subscription. Updating the agent involves copying the new image to your Azure Container Registry (ACR) and updating the App Service via the Deployment Center.

For common prerequisites (regctl installation, Fractal registry authentication), see the main guide.

Step 1 — Identify the ACR and App Service​

Locate the Azure Container Registry and the App Service used by the Fractal Cloud Agent:

# List resources in the rg-fractal resource group
az resource list \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID> \
  --output table

Note the ACR name (e.g., <NAME>acr) and the App Service name.

You can also find the current image in the App Service configuration:

az webapp config container show \
  --name <APP_SERVICE_NAME> \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID>

Step 2 — Authenticate with your ACR​

az login

az acr login --name <ACR_NAME> --subscription <MANAGEMENT_SUBSCRIPTION_ID>

Also configure regctl to access your ACR:

ACR_TOKEN=$(az acr login --name <ACR_NAME> --expose-token --output tsv --query accessToken)
regctl registry login <ACR_NAME>.azurecr.io -u "00000000-0000-0000-0000-000000000000" -p "$ACR_TOKEN"

Step 3 — Copy the new image to ACR​

Use regctl to copy the new agent image directly from the Fractal registry to your ACR:

regctl image copy \
  yanchware/fractal.cloudagent.azure.container:<NEW_VERSION> \
  <ACR_NAME>.azurecr.io/fractalcloud/fractal.cloudagent.azure.container:<NEW_VERSION>

Step 4 — Update the App Service image​

Azure Portal (Deployment Center):

  1. Go to the Azure Portal > Resource groups > rg-fractal.
  2. Select the Fractal Cloud Agent App Service.
  3. In the left menu, select Deployment Center.
  4. Update the Full Image Name and Tag to: 
    <ACR_NAME>.azurecr.io/fractalcloud/fractal.cloudagent.azure.container:<NEW_VERSION>
  5. Click Save.

Azure CLI:

az webapp config container set \
  --name <APP_SERVICE_NAME> \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID> \
  --container-image-name <ACR_NAME>.azurecr.io/fractalcloud/fractal.cloudagent.azure.container:<NEW_VERSION>

Step 5 — Restart the App Service​

After updating the image, restart the App Service to pull the new version:

az webapp restart \
  --name <APP_SERVICE_NAME> \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID>

Step 6 — Verify the update​

Check that the App Service is running with the new image:

az webapp config container show \
  --name <APP_SERVICE_NAME> \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID>

You can also check the App Service logs for successful startup:

az webapp log tail \
  --name <APP_SERVICE_NAME> \
  --resource-group rg-fractal \
  --subscription <MANAGEMENT_SUBSCRIPTION_ID>