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.

Preview-beperkingen

• 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:

• 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 de Azure-portal.

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
   

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.

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.

Volgende stappen

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