Verwijderde artefacten herstellen met beleid voor voorlopig verwijderen in Azure Container Registry (preview)

Met Azure Container Registry (ACR) kunt u het beleid voor voorlopig verwijderen inschakelen om per ongeluk verwijderde artefacten te herstellen voor een vaste bewaarperiode.

Aspecten van beleid voor voorlopig verwijderen

Het beleid voor voorlopig verwijderen kan op elk gewenst moment worden ingeschakeld/uitgeschakeld. Zodra u het beleid voor voorlopig verwijderen in ACR hebt ingeschakeld, worden de verwijderde artefacten beheerd als voorlopig verwijderde artefacten met een vaste bewaarperiode. Hierdoor hebt u de mogelijkheid om de voorlopig verwijderde artefacten weer te geven, te filteren en te herstellen.

Bewaarperiode

De standaardretentieperiode voor voorlopig verwijderde artefacten is zeven dagen, maar het is mogelijk om de waarde voor de bewaarperiode tussen één en 90 dagen in te stellen. U kunt de waarde van het bewaarbeleid instellen, bijwerken en wijzigen. De voorlopig verwijderde artefacten verlopen zodra de bewaarperiode is voltooid.

Automatisch opspoeding

De automatische functie wordt elke 24 uur uitgevoerd en houdt altijd rekening met de huidige waarde van retentiedagen voordat de voorlopig verwijderde artefacten definitief worden verwijderd. Als u bijvoorbeeld na vijf dagen voorlopig verwijderen van het artefact de waarde van bewaardagen wijzigt van zeven tot 14 dagen, verloopt het artefact pas na 14 dagen na de eerste voorlopig verwijderen.

Beschikbaarheids- en prijsinformatie

Deze functie is beschikbaar in alle servicelagen (ook wel SKU's genoemd). Zie Azure Container Registry-servicelagen voor informatie over registerservicelagen.

Notitie

De voorlopig verwijderde artefacten worden gefactureerd volgens de prijzen voor actieve sKU's voor opslag.

Preview-beperkingen

Belangrijk

Het beleid voor voorlopig verwijderen bevindt zich momenteel in PREVIEW. Raadpleeg de Aanvullende voorwaarden voor Microsoft Azure-previews voor juridische voorwaarden die van toepassing zijn op Azure-functies die in bèta of preview zijn of die anders nog niet algemeen beschikbaar zijn.

• ACR biedt momenteel geen ondersteuning voor het handmatig opschonen van voorlopig verwijderde artefacten.
• Het beleid voor voorlopig verwijderen biedt geen ondersteuning voor een geo-gerepliceerd register.
• ACR staat het inschakelen van zowel het bewaarbeleid als het beleid voor voorlopig verwijderen niet toe. Zie bewaarbeleid voor niet-gemarkeerde manifesten.

Vereisten

• De gebruiker heeft de volgende machtigingen (op registerniveau) nodig om bewerkingen voor voorlopig verwijderen uit te voeren:

Machtiging	Beschrijving
Microsoft.ContainerRegistry/registries/deleted/read	Voorlopig verwijderde artefacten weergeven
Microsoft.ContainerRegistry/registers/deleted/restore/action	Voorlopig verwijderde artefact herstellen

• U kunt de Azure Cloud Shell of een lokale installatie van de Azure CLI gebruiken om de opdrachtvoorbeelden in dit artikel uit te voeren. Als u deze lokaal wilt gebruiken, is versie 2.0.74 of hoger vereist. Voer az --version deze uit voor de versie. Als u Azure CLI 2.0 wilt installeren of upgraden, raadpleegt u Azure CLI 2.0 installeren.

• Meld u aan bij het Azure-portaal.

Beleid voor voorlopig verwijderen inschakelen voor register - CLI

1. Update voorlopig verwijderen beleid voor een bepaalde MyRegistry ACR met een bewaarperiode ingesteld tussen 1 en 90 dagen.

   az acr config soft-delete update -r MyRegistry --days 7 --status <enabled/disabled>
   

2. Geconfigureerd beleid voor voorlopig verwijderen weergeven voor een bepaalde MyRegistry ACR.

   az acr config soft-delete show -r MyRegistry 
   

De voorlopig verwijderde artefacten weergeven - CLI

Met de az acr repository list-deleted opdrachten kunt u het ophalen en weergeven van de voorlopig verwijderde opslagplaatsen inschakelen. Gebruik voor meer informatie --help.

1. Vermeld de voorlopig verwijderde opslagplaatsen in een bepaalde MyRegistry ACR.

   az acr repository list-deleted -n MyRegistry
   

Met de az acr manifest list-deleted opdrachten kunt u het ophalen en weergeven van de manifesten voor voorlopig verwijderen inschakelen.

2. Vermeld de voorlopig verwijderde manifesten van een hello-world opslagplaats in een bepaalde MyRegistry ACR.

   az acr manifest list-deleted -r MyRegistry -n hello-world
   

Met de az acr manifest list-deleted-tags opdrachten kunt u tags voor voorlopig verwijderen ophalen en weergeven.

3. Vermeld de tags voor voorlopig verwijderen van een hello-world opslagplaats in een bepaalde MyRegistry ACR.

   az acr manifest list-deleted-tags -r MyRegistry -n hello-world
   

4. Filter de tags voor voorlopig verwijderen van een hello-world opslagplaats zodat deze overeenkomen met de tag latest in een bepaalde MyRegistry ACR.

   az acr manifest list-deleted-tags -r MyRegistry -n hello-world:latest
   

De voorlopig verwijderde artefacten herstellen - CLI

Met de az acr manifest restore opdrachten wordt één installatiekopieën hersteld per tag en samenvatting.

1. Herstel de installatiekopieën van een hello-world opslagplaats op basis van tags latesten samenvattingen sha256:abc123 in een bepaalde MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest -d sha256:abc123
   

2. Herstel het meest recent verwijderde manifest van een hello-world opslagplaats per tag latest in een bepaalde MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest
   

Geforceerd herstellen overschrijft de bestaande tag met dezelfde naam in de opslagplaats. Als het beleid voor voorlopig verwijderen is ingeschakeld tijdens geforceerd herstellen. De overschreven tag wordt voorlopig verwijderd. U kunt herstellen afdwingen met specifieke argumenten --force, -f.

3. Forceer het herstellen van de installatiekopieën van een hello-world opslagplaats per tag latesten digest sha256:abc123 in een bepaalde MyRegistry ACR.

   az acr manifest restore -r MyRegistry -n hello-world:latest -d sha256:abc123 -f
   

Belangrijk

Als u een manifestlijst herstelt, worden onderliggende voorlopig verwijderde manifesten niet recursief hersteld. Als u voorlopig verwijderde ORAS-artefacten herstelt, herstelt u een onderwerp niet recursief de verwijzingsketen. Het onderwerp moet ook eerst worden hersteld, maar dan mag een verwijzingsmanifest worden hersteld. Anders treedt er een fout op.

Beleid voor voorlopig verwijderen inschakelen voor register - Portal

U kunt ook het beleid voor voorlopig verwijderen van een register inschakelen in Azure Portal.

1. Navigeer naar uw Azure Container Registry.
2. Controleer op het tabblad Overzicht de status van voorlopig verwijderen (preview).
3. Als de status is uitgeschakeld, selecteert u Update.

4. Schakel het selectievakje in om Voorlopig verwijderen in te schakelen.
5. Selecteer het aantal dagen tussen 0 en 90 dagen voor het behouden van de voorlopig verwijderde artefacten.
6. Selecteer Opslaan om uw wijzigingen op te slaan.

De voorlopig verwijderde artefacten herstellen - Portal

1. Navigeer naar uw Azure Container Registry.
2. Selecteer Services in de sectie Menu en Selecteer opslagplaatsen.
3. Selecteer in de opslagplaatsen de gewenste opslagplaats.
4. Selecteer de optie Verwijderde artefacten beheren om alle voorlopig verwijderde artefacten weer te geven.

Notitie

Zodra u het beleid voor voorlopig verwijderen hebt ingeschakeld en acties uitvoert, zoals het verwijderen van een manifest of het verwijderen van een artefact, kunt u deze tags en artefacten vinden in de beheerde verwijderingsartefacten voordat het aantal bewaardagen verloopt.

5. Filter het verwijderde artefact dat u moet herstellen.
6. Selecteer het artefact en selecteer in de rechterkolom Herstellen .
7. Er wordt een venster Artefact herstellen weergegeven.

8. Selecteer de tag die u wilt herstellen, hier hebt u een optie om te kiezen en eventuele extra tags te herstellen.
9. Selecteer Herstellen.

Herstellen vanuit voorlopig verwijderde opslagplaatsen - Portal

1. Navigeer naar uw Azure Container Registry.
2. Selecteer Services in de sectie Menu,
3. Selecteer opslagplaatsen op het tabblad Services.
4. Selecteer op het tabblad Opslagplaatsen de optie Verwijderde opslagplaatsen beheren.

5. Filter de verwijderde opslagplaats in de voorlopig verwijderde opslagplaatsen (preview).

6. Selecteer de verwijderde opslagplaats, filter het verwijderde artefact uit op de verwijderde artefacten beheren.
7. Selecteer het artefact en selecteer in de rechterkolom Herstellen .
8. Er wordt een venster Artefact herstellen weergegeven.

9. Selecteer de tag die u wilt herstellen, hier hebt u een optie om te kiezen en andere tags te herstellen.
10. Selecteer Herstellen.

Belangrijk

Het importeren van een voorlopig verwijderde installatiekopieën op zowel bron- als doelresources wordt geblokkeerd. Als u een installatiekopieën naar de voorlopig verwijderde opslagplaats pusht, wordt de voorlopig verwijderde opslagplaats hersteld. Het pushen van een installatiekopieën die dezelfde manifestsamenvating met de voorlopig verwijderde installatiekopieën delen, is niet toegestaan. Herstel in plaats daarvan de voorlopig verwijderde installatiekopieën.

Volgende stappen

• Meer informatie over opties voor het verwijderen van installatiekopieën en opslagplaatsen in Azure Container Registry.