Dela via

Ange en kvarhållningsprincip för otaggade manifest

  • Artikel

Med Azure Container Registry kan du ange en kvarhållningsprincip för lagrade avbildningsmanifest som inte har några associerade taggar (otaggade manifest). När en kvarhållningsprincip är aktiverad tas otaggade manifest i registret bort automatiskt efter ett antal dagar som du anger. Den här funktionen hindrar registret från att fyllas med artefakter som inte behövs och hjälper dig att spara på lagringskostnader.

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 att hitta versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

En kvarhållningsprincip för otaggade manifest är för närvarande en förhandsversionsfunktion i Premium-containerregister . Information om registertjänstnivåer finns i Tjänstnivåer för Azure Container Registry.

Varning

Ange en kvarhållningsprincip med omsorg – borttagna bilddata är UNRECOVERABLE. Om du har system som hämtar bilder efter manifestsammandrag (till skillnad från bildnamn) bör du inte ange en kvarhållningsprincip för otaggade manifest. Om du tar bort otaggade avbildningar hindras 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 , en rekommenderad metod.

Om kvarhållningsprincipen

Azure Container Registry refererar till att räkna manifest i registret. När ett manifest inte är taggat kontrollerar det kvarhållningsprincipen. Om en kvarhållningsprincip är aktiverad placeras en manifestborttagningsåtgärd i kö, med ett specifikt datum, enligt det antal dagar som angetts i principen.

Ett separat köhanteringsjobb bearbetar ständigt meddelanden och skalar efter behov. Anta till exempel att du har avmarkerat två manifest, 1 timmes mellanrum, i ett register med en kvarhållningsprincip på 30 dagar. Två meddelanden skulle placeras i kö. Sedan, 30 dagar senare, cirka 1 timmes mellanrum, skulle meddelandena hämtas från kön och bearbetas, förutsatt att principen fortfarande var i kraft.

delete-enabled Om attributet för ett icke-taggat manifest har angetts till falseär manifestet låst och tas inte bort av principen.

Viktigt!

Kvarhållningsprincipen 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 kvarhållningsprincip – 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 kvarhållningsprincip

Som standard anges ingen kvarhållningsprincip i ett containerregister. Om du vill ange eller uppdatera en kvarhållningsprincip 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 kvarhållningsprincip på 30 dagar för otaggade manifest i registrets 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 ett manifest i registret så snart det inte är taggat. 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 kvarhållningsprincip

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

  1. Skicka en testbild hello-world:latest till registret eller byt ut en annan testbild.
  2. Ta bort avbildningen hello-world:latest , till exempel med kommandot az acr repository untag . 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 på lagringsplatsen, till exempel med kommandot az acr manifest list-metadata . Om testbilden var den enda på lagringsplatsen tas själva lagringsplatsen bort.

Hantera en kvarhållningsprincip

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

az acr config retention show --registry myregistry

Om du vill inaktivera en kvarhållningsprincip i ett register kör du kommandot az acr config retention update och anger --status disabled:

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

Ange en kvarhållningsprincip – portalen

Du kan också ange ett registers kvarhållningsprincip i Azure Portal.

Aktivera en kvarhållningsprincip

  1. Gå till ditt Azure-containerregister. Under Principer väljer du Kvarhållning (förhandsversion).
  2. I Status vä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 kvarhållningsprincip i Azure Portal

Inaktivera en kvarhållningsprincip

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

Nästa steg