Ange en bevarandeprincip för otaggade manifest

Azure Container Registry ger dig möjlighet att ange en bevarandeprincip för lagrade bildmanifest som inte har några associerade taggar(otaggade manifest). När en bevarandeprincip har aktiverats tas otaggade manifest i registret bort automatiskt efter ett antal dagar som du anger. Den här funktionen förhindrar att registret fylls med artefakter som inte behövs och hjälper dig att spara på lagringskostnaderna.

Du kan använda Azure Cloud Shell eller en lokal installation av Azure CLI för att köra kommandoexempel 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 att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

En bevarandeprincip för otaggade manifest är för närvarande en förhandsgranskningsfunktion i Premium containerregister. Information om registertjänstnivåer finns i Azure Container Registry tjänstnivåer.

Varning

Ange en kvarhållningsprincip med försiktighet – borttagna bilddata kan inte återställas. Om du har system som hämtar avbildningar efter manifest sammanfattas (till skillnad från avbildningens namn) bör du inte ange en bevarandeprincip för otaggade manifest. Om du tar bort otaggade avbildningar förhindras dessa system från att hämta avbildningarna från registret. I stället för att hämta efter manifest bör du överväga att använda ett unikt taggningsschema, vilket är en rekommenderad metod.

Om bevarandeprincipen

Azure Container Registry refererar till inventering för manifest i registret. När ett manifest inte har taggats kontrolleras bevarandeprincipen. Om en kvarhållningsprincip är aktiverad köas en manifeståtgärd för borttagning med ett visst datum, enligt det antal dagar som angetts i principen.

Ett separat köhanteringsjobb bearbetar kontinuerligt meddelanden och skalar efter behov. Anta till exempel att du har otaggat två manifest med en timmes mellanrum i ett register med en kvarhållningsprincip på 30 dagar. Två meddelanden skulle köas. Sedan, 30 dagar senare, ungefär 1 timme från varandra, hämtas meddelandena från kön och bearbetas, förutsatt att principen fortfarande gäller.

Om delete-enabled attributet för ett otaggat manifest är inställt på är manifestet låst false och tas inte bort av principen.

Viktigt

Bevarandeprincipen gäller endast för otaggade manifest med tidsstämplar när principen har aktiverats. Otaggade manifest i registret med tidigare tidsstämplar omfattas inte av principen. Andra alternativ för att ta bort avbildningsdata finns i exempel i Ta bort containeravbildningar i Azure Container Registry.

Ange en bevarandeprincip – CLI

I följande exempel visas hur du använder Azure CLI för att ange en kvarhållningsprincip för otaggade manifest i ett register.

Aktivera en bevarandeprincip

Som standard anges ingen bevarandeprincip i ett containerregister. Om du vill ange eller uppdatera en bevarandeprincip kör du kommandot az acr config retention update i Azure CLI. Du kan ange ett antal dagar mellan 0 och 365 för att behålla de otaggade manifesten. Om du inte anger ett antal dagar anger kommandot standardvärdet 7 dagar. Efter kvarhållningsperioden tas alla otaggade manifest i registret bort automatiskt.

I följande exempel anges en bevarandeprincip på 30 dagar för otaggade manifest i registret myregistry:

az acr config retention update --registry myregistry --status enabled --days 30 --type UntaggedManifests

I följande exempel anges en princip för att ta bort alla manifest i registret så fort de inte har taggats. Skapa den här principen genom att ange en kvarhållningsperiod på 0 dagar.

az acr config retention update \
  --registry myregistry --status enabled \
  --days 0 --type UntaggedManifests

Verifiera en bevarandeprincip

Om du aktiverar föregående princip med en kvarhållningsperiod på 0 dagar kan du snabbt kontrollera att otaggade manifest tas bort:

  1. Push-skicka en hello-world:latest testavbildning till registret eller ersätt en annan valfri testavbildning.
  2. Avtagga hello-world:latest avbildningen med hjälp av kommandot hello-world:latest Det otaggade manifestet finns kvar i registret.
    az acr repository untag \
      --name myregistry --image hello-world:latest
    
  3. Inom några sekunder tas det otaggade manifestet bort. Du kan verifiera borttagningen genom att visa manifest i lagringsplatsen, till exempel med kommandot az acr repository show-manifests. Om testbilden var den enda på lagringsplatsen tas själva lagringsplatsen bort.

Hantera en bevarandeprincip

Om du vill visa kvarhållningsprincipen som angetts i ett register kör du kommandot az acr config retention show:

az acr config retention show --registry myregistry

Om du vill inaktivera en bevarandeprincip i ett register kör du kommandot az acr config retention update och anger :

az acr config retention update \
  --registry myregistry --status disabled \
  --type UntaggedManifests

Ange en bevarandeprincip – portalen

Du kan också ange kvarhållningsprincipen för ett register i Azure Portal.

Aktivera en bevarandeprincip

  1. Gå till ditt Azure-containerregister. Under Principerväljer du Kvarhållning (förhandsversion).
  2. I Statusväljer du Aktiverad.
  3. Välj ett antal dagar mellan 0 och 365 för att behålla de otaggade manifesten. Välj Spara.

Aktivera en bevarandeprincip i Azure Portal

Inaktivera en bevarandeprincip

  1. Gå till ditt Azure-containerregister. Under Principerväljer du Kvarhållning (förhandsversion).
  2. I Statusväljer du Inaktiverad. Välj Spara.

Nästa steg