# Wait for gallery replication before reusing a managed image for another version

> DSE recommends making this dependency explicit in the pipeline before enabling overlapping runs.

- Canonical URL: https://update.dsesecurity.com/updates/dse-20260917-028-wait-for-gallery-replication-before-reusing-a-managed-image-for-another-version/
- Publisher: Detection Systems & Engineering (DSE Security)
- Author: DSE Security Editorial Team
- Published: 2026-09-17T16:34:32+00:00
- Modified: 2026-09-17T16:35:03+00:00
- Last reviewed by DSE: 2026-09-17
- Resource type: Guide
- DSE priority: Information
- Topics: IT
- Reading time: 2 minutes

## What you need to know

DSE recommends making this dependency explicit in the pipeline before enabling overlapping runs.

## Potentially affected

This guide applies to an Azure Compute Gallery pipeline that creates successive versions from one managed-image source. The dependency concerns reusing that same source; the article does not establish a universal concurrency limit for all image creation.

## DSE recommendation

DSE recommends making this dependency explicit in the pipeline before enabling overlapping runs.

## Article

## Source facts

Microsoft requires a gallery image version to finish both building and replication before the same managed image is used to create another version. The guide warns that replication to every target region can take time and shows tracking the asynchronous PowerShell job. [Microsoft Learn](https://learn.microsoft.com/en-us/azure/virtual-machines/image-version)

## Applicability

This guide applies to an Azure Compute Gallery pipeline that creates successive versions from one managed-image source. The dependency concerns reusing that same source; the article does not establish a universal concurrency limit for all image creation.

## DSE recommendation

DSE recommends making this dependency explicit in the pipeline before enabling overlapping runs. Record the source managed-image identifier, first version identifier, and intended replication regions together. Assign an owner to define the observed completion condition and the response to a stalled replication job. Keep a later job queued while the earlier version is incomplete, and preserve the operation evidence if a retry is needed.

## Verification

In an approved pipeline test, retain the build and regional replication observations for the first version before allowing the next job to reuse its managed image. Compare the observed sequence with the dependency in the plan. Verify that an incomplete or failed replication result leaves the next dependent job waiting for investigation. Treat successful request submission as a different observation from completed replication across the required regions.

## Official references

- [Microsoft: Create an image definition and image version – Azure Virtual Machines | Microsoft Learn](https://learn.microsoft.com/en-us/azure/virtual-machines/image-version)

## Primary reference

- Name: Create an image definition and image version - Azure Virtual Machines | Microsoft Learn
- Authority: Microsoft Learn
- URL: https://learn.microsoft.com/en-us/azure/virtual-machines/image-version
- Source publication date: Not stated by the source

## Citation and use

Preferred citation: “Wait for gallery replication before reusing a managed image for another version,” DSE Security, https://update.dsesecurity.com/updates/dse-20260917-028-wait-for-gallery-replication-before-reusing-a-managed-image-for-another-version/
Publishing principles: https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/
Usage and citation policy: https://update.dsesecurity.com/usage/
Copyright © 2026 Detection Systems & Engineering. All rights reserved.