Återställa borttagna artefakter med en princip för mjuk borttagning i Azure Container Registry (förhandsversion)

Med Azure Container Registry (ACR) kan du aktivera principen för mjuk borttagning för att återställa eventuella artefakter som tagits bort av misstag under en angivet kvarhållningsperiod.

Aspekter av principen för mjuk borttagning

Principen för mjuk borttagning kan aktiveras/inaktiveras när som helst. När du aktiverar principen för mjuk borttagning i ACR hanteras de borttagna artefakterna som mjuka borttagna artefakter med en angivet kvarhållningsperiod. Därmed kan du lista, filtrera och återställa de mjuka borttagna artefakterna.

Kvarhållningsperiod

Standardkvarhållningsperioden för mjuka borttagna artefakter är sju dagar, men det går att ange kvarhållningsperiodvärdet mellan en och 90 dagar. Du kan ange, uppdatera och ändra värdet för kvarhållningsprincipen. De mjuka borttagna artefakterna upphör att gälla när kvarhållningsperioden är klar.

Autopurge

Autoköpet körs var 24:e timme och tar alltid hänsyn till det aktuella värdet för kvarhållningsdagar innan de mjuka borttagna artefakterna tas bort permanent. Efter fem dagars mjuk borttagning av artefakten, om du till exempel ändrar värdet för kvarhållningsdagar från sju till 14 dagar, upphör artefakten bara att upphöra efter 14 dagar från den första mjuka borttagningen.

Tillgänglighets- och prisinformation

Den här funktionen är tillgänglig på alla tjänstnivåer (kallas även SKU:er). Information om registertjänstnivåer finns i Tjänstnivåer för Azure Container Registry.

Kommentar

De mjukt borttagna artefakterna faktureras enligt priser för aktiv SKU för lagring.

Begränsningar i förhandsversionen

Viktigt!

Principen för mjuk borttagning är för närvarande i förhandsversion. Juridiska villkor för Azure-funktioner i betaversion, förhandsversion eller som av någon annan anledning inte har gjorts allmänt tillgängliga ännu finns i kompletterande användningsvillkor för Microsoft Azure-förhandsversioner.

• ACR stöder för närvarande inte manuellt rensning av mjuka borttagna artefakter.
• Principen för mjuk borttagning stöder inte ett geo-replikerat register.
• ACR tillåter inte aktivering av både kvarhållningsprincipen och principen för mjuk borttagning. Se kvarhållningsprincip för icke-taggade manifest.

Förutsättningar

• Användaren kräver följande behörigheter (på registernivå) för att utföra åtgärder för mjuk borttagning:

Behörighet	beskrivning
Microsoft.ContainerRegistry/registries/deleted/read	Visa en lista över mjukt borttagna artefakter
Microsoft.ContainerRegistry/registries/deleted/restore/action	Återställa mjuk borttagen artefakt

• Du kan använda Azure Cloud Shell eller en lokal installation av Azure CLI för att köra kommandoexemplen i den här artikeln. Om du vill använda den lokalt krävs version 2.0.74 eller senare. Kör az --version för versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

• Logga in på Azure-portalen.

Aktivera mjuk borttagningsprincip för registret – CLI

1. Uppdatera principen för mjuk borttagning för en viss MyRegistry ACR med en kvarhållningsperiod som har angetts mellan 1 och 90 dagar.

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

2. Visa konfigurerad princip för mjuk borttagning för en viss MyRegistry ACR.

   az acr config soft-delete show -r MyRegistry 
   

Visa en lista över mjukt borttagna artefakter – CLI

Med az acr repository list-deleted kommandona kan du hämta och visa en lista över de mjuka borttagna lagringsplatserna. Mer information finns i --help.

1. Visa en lista över de mjukt borttagna lagringsplatserna i en viss MyRegistry ACR.

   az acr repository list-deleted -n MyRegistry
   

Med az acr manifest list-deleted kommandona kan du hämta och lista de mjuka borttagningsmanifesten.

2. Visa en lista över de mjukt borttagna manifesten för en hello-world lagringsplats i en viss MyRegistry ACR.

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

Med az acr manifest list-deleted-tags kommandona kan du hämta och visa en lista över taggarna för mjuk borttagning.

3. Visa en lista över taggarna för mjuk borttagning av en hello-world lagringsplats i en viss MyRegistry ACR.

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

4. Filtrera taggarna för mjuk borttagning för en hello-world lagringsplats för att matcha taggen latest i en viss MyRegistry ACR.

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

Återställa de mjukt borttagna artefakterna – CLI

Kommandona az acr manifest restore återställer en enskild avbildning med tagg och sammandrag.

1. Återställ avbildningen av en hello-world lagringsplats med tagg latestoch sammandrag sha256:abc123 i en viss MyRegistry ACR.

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

2. Återställ det senast borttagna manifestet för en hello-world lagringsplats med tagg latest i en angiven MyRegistry ACR.

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

Framtvinga återställning skriver över den befintliga taggen med samma namn på lagringsplatsen. Om principen för mjuk borttagning är aktiverad under framtvinga återställning. Den överskrivna taggen tas bort mjukt. Du kan framtvinga återställning med specifika argument --force, -f.

3. Framtvinga återställning av avbildningen av en hello-world lagringsplats efter tagg latestoch sammandrag sha256:abc123 i en viss MyRegistry ACR.

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

Viktigt!

Om du återställer en manifestlista återställs inga underliggande mjuka borttagna manifest rekursivt. Om du återställer mjukt borttagna ORAS-artefakter återställs inte referenskedjan rekursivt om du återställer ett ämne. Dessutom måste ämnet återställas först, först då kan ett referensmanifest återställas. Annars utlöser det ett fel.

Aktivera princip för mjuk borttagning för registret – portalen

Du kan också aktivera ett registers princip för mjuk borttagning i Azure-portalen.

1. Gå till Azure Container Registry.
2. På fliken Översikt kontrollerar du statusen för mjuk borttagning (förhandsversion).
3. Om statusenär Inaktiverad väljer du Uppdatera.

4. Markera kryssrutan för att aktivera mjuk borttagning.
5. Välj antalet dagar mellan 0 och 90 dagar för att behålla de mjuka borttagna artefakterna.
6. Välj Spara för att spara dina ändringar.

Återställa de mjukt borttagna artefakterna – portalen

1. Gå till Azure Container Registry.
2. I menyavsnittet väljer du tjänster och väljer lagringsplatser.
3. I lagringsplatserna väljer du önskad lagringsplats.
4. Välj på Hantera borttagna artefakter för att se alla mjuka borttagna artefakter.

Kommentar

När du aktiverar principen för mjuk borttagning och utför åtgärder som att ta bort ett manifest eller ta bort en artefakt kan du hitta taggarna och artefakterna i artefakterna för hanterad borttagning innan antalet kvarhållningsdagar upphör att gälla.

5. Filtrera den borttagna artefakt som du måste återställa.
6. Välj artefakten och välj i kolumnen Återställ i den högra kolumnen.
7. Ett återställningsartefaktfönster visas.

8. Välj taggen som ska återställas, här har du ett alternativ att välja och återställa eventuella ytterligare taggar.
9. Välj vid Återställning.

Återställa från mjuk borttagna lagringsplatser – portalen

1. Gå till Azure Container Registry.
2. I menyavsnittet väljer du tjänster,
3. På fliken Tjänster väljer du Lagringsplatser.
4. På fliken Lagringsplatser väljer du på Hantera borttagna lagringsplatser.

5. Filtrera den borttagna lagringsplatsen i de mjukt borttagna lagringsplatserna (förhandsversion).

6. Välj den borttagna lagringsplatsen, filtrera den borttagna artefakten från på Hantera borttagna artefakter.
7. Välj artefakten och välj i kolumnen Återställ i den högra kolumnen.
8. Ett återställningsartefaktfönster visas.

9. Välj taggen som ska återställas, här har du ett alternativ att välja och återställa eventuella andra taggar.
10. Välj vid Återställning.

Viktigt!

Import av en mjuk borttagen avbildning vid både käll- och målresurser blockeras. Om du skickar en avbildning till den mjukt borttagna lagringsplatsen återställs den mjukt borttagna lagringsplatsen. Det är inte tillåtet att push-överföra en bild som delar samma manifestsammandrag med den mjukt borttagna bilden. Återställ i stället den mjukt borttagna avbildningen.

Nästa steg

• Läs mer om alternativ för att ta bort avbildningar och lagringsplatser i Azure Container Registry.