Ripristinare gli artefatti eliminati con criteri di eliminazione temporanea in Registro Azure Container (anteprima)

Registro Azure Container (ACR) consente di abilitare i criteri di eliminazione temporanea per ripristinare eventuali artefatti eliminati accidentalmente per un periodo di conservazione impostato.

Aspetti dei criteri di eliminazione temporanea

I criteri di eliminazione temporanea possono essere abilitati/disabilitati in qualsiasi momento. Dopo aver abilitato i criteri di eliminazione temporanea in Registro Azure Container, gestisce gli artefatti eliminati come artefatti eliminati temporaneamente con un periodo di conservazione impostato. In questo modo è possibile elencare, filtrare e ripristinare gli artefatti eliminati soft.

Periodo di memorizzazione

Il periodo di conservazione predefinito per gli artefatti eliminati predefinito è di sette giorni, ma è possibile impostare il valore del periodo di conservazione compreso tra uno e 90 giorni. È possibile impostare, aggiornare e modificare il valore dei criteri di conservazione. Gli artefatti eliminati temporaneamente scadono al termine del periodo di conservazione.

Rimozione automatica

L'eliminazione automatica viene eseguita ogni 24 ore e considera sempre il valore corrente dei giorni di conservazione prima di eliminare definitivamente gli artefatti eliminati temporaneamente. Ad esempio, dopo cinque giorni di eliminazione temporanea dell'artefatto, se si modifica il valore dei giorni di conservazione da sette a 14 giorni, l'artefatto scadrà solo dopo 14 giorni dall'eliminazione temporanea iniziale.

Informazioni sulla disponibilità e sui prezzi

Questa funzionalità è disponibile in tutti i livelli di servizio (noti anche come SKU). Per informazioni sui livelli di servizio del registro contenitori, vedere Livelli di servizio di Registro Azure Container.

Nota

Gli artefatti eliminati soft vengono fatturati in base ai prezzi degli SKU attivi per l'archiviazione.

Limiti dell'anteprima

Importante

I criteri di eliminazione temporanea sono attualmente disponibili in ANTEPRIMA. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

• Registro Azure Container attualmente non supporta l'eliminazione manuale degli artefatti eliminati temporaneamente.
• I criteri di eliminazione temporanea non supportano un registro con replica geografica.
• Registro Azure Container non consente di abilitare sia i criteri di conservazione che i criteri di eliminazione temporanea. Vedere criteri di conservazione per manifesti senza tag.

Prerequisiti

• L'utente richiede le autorizzazioni seguenti (a livello di Registro di sistema) per eseguire operazioni di eliminazione temporanea:

Autorizzazione	Descrizione
Microsoft.ContainerRegistry/registries/deleted/read	Elencare gli artefatti eliminati soft-delete
Microsoft.ContainerRegistry/registries/deleted/restore/action	Ripristinare l'artefatto eliminato leggero

• Per eseguire gli esempi di comandi di questo articolo è possibile usare Azure Cloud Shell o un'installazione locale dell'interfaccia della riga di comando di Azure. Se si preferisce l'interfaccia locale, è necessario usare la versione 2.0.74 o successiva. Eseguire az --version per la versione. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare l'interfaccia della riga di comando di Azure.

• Accedere al portale di Azure.

Abilitare i criteri di eliminazione temporanea per il Registro di sistema - Interfaccia della riga di comando

1. Aggiornare i criteri di eliminazione temporanea per un determinato MyRegistry Registro Azure Container con un periodo di conservazione impostato tra 1 e 90 giorni.

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

2. Mostra i criteri di eliminazione temporanea configurati per un record di controllo di accesso specifico MyRegistry .

   az acr config soft-delete show -r MyRegistry 
   

Elencare gli artefatti eliminati soft- Interfaccia della riga di comando

I az acr repository list-deleted comandi consentono di recuperare ed elencare i repository eliminati soft. Per altre informazioni, usare --help.

1. Elencare i repository eliminati soft in un record di controllo di accesso specificato MyRegistry .

   az acr repository list-deleted -n MyRegistry
   

I az acr manifest list-deleted comandi consentono di recuperare ed elencare i manifesti di eliminazione temporanea.

2. Elencare i manifesti eliminati temporaneo di un hello-world repository in un record di controllo di accesso specificato MyRegistry .

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

I az acr manifest list-deleted-tags comandi abilitano il recupero e l'elenco dei tag di eliminazione temporanea.

3. Elencare i tag di eliminazione temporanea di un repository in un hello-world record di controllo di accesso specificato MyRegistry .

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

4. Filtrare i tag di eliminazione temporanea di un hello-world repository in modo che corrispondano al tag latest in un record di controllo di accesso specificato MyRegistry .

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

Ripristinare gli artefatti eliminati soft - Interfaccia della riga di comando

I az acr manifest restore comandi ripristinano una singola immagine per tag e digest.

1. Ripristinare l'immagine di un hello-world repository in base al tag lateste al digest sha256:abc123 in un record di controllo di accesso specificato MyRegistry .

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

2. Ripristinare il manifesto eliminato più di recente di un hello-world repository in base al tag latest in un record di controllo di accesso specificato MyRegistry .

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

Force restore sovrascrive il tag esistente con lo stesso nome nel repository. Se i criteri di eliminazione temporanea sono abilitati durante il ripristino forzato. Il tag sovrascritto viene eliminato leggero. È possibile forzare il ripristino con argomenti --force, -fspecifici.

3. Forzare il ripristino dell'immagine di un hello-world repository in base al tag lateste al digest sha256:abc123 in un record di controllo di accesso specificato MyRegistry .

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

Importante

Il ripristino di un elenco di manifesti non ripristinerà in modo ricorsivo i manifesti eliminati temporaneamente sottostanti. Se si ripristinano artefatti ORAS eliminati temporaneamente, il ripristino di un soggetto non ripristina in modo ricorsivo la catena del referrer. Inoltre, l'oggetto deve essere ripristinato per primo, solo successivamente è consentito il ripristino di un manifesto referrer. In caso contrario, genera un errore.

Abilitare i criteri di eliminazione temporanea per il Registro di sistema - Portale

È anche possibile abilitare i criteri di eliminazione temporanea di un Registro di sistema nel portale di Azure.

1. Passare al Registro Azure Container.
2. Nella scheda Panoramica verificare lo stato dell'eliminazione temporanea (anteprima).
3. Se lo stato è Disabilitato, selezionare Aggiorna.

4. Selezionare la casella di controllo Per abilitare l'eliminazione temporanea.
5. Selezionare il numero di giorni tra 0 e 90 giorni per conservare gli artefatti eliminati soft.
6. Seleziona Salva per salvare le modifiche.

Ripristinare gli artefatti eliminati soft - Portale

1. Passare al Registro Azure Container.
2. Nella sezione Menu selezionare Servizi e Selezionare Repository.
3. In Repository selezionare il repository preferito.
4. Selezionare Gestisci artefatti eliminati per visualizzare tutti gli artefatti eliminati soft.

Nota

Dopo aver abilitato i criteri di eliminazione temporanea ed eseguire azioni come l'annullamento del tag di un manifesto o l'eliminazione di un artefatto, sarà possibile trovare questi tag e artefatti negli artefatti di eliminazione gestita prima della scadenza del numero di giorni di conservazione.

5. Filtrare l'artefatto eliminato da ripristinare.
6. Selezionare l'artefatto e selezionare ripristina nella colonna a destra.
7. Viene visualizzata una finestra Ripristina artefatto .

8. Selezionare il tag da ripristinare, qui è possibile scegliere e ripristinare eventuali tag aggiuntivi.
9. Selezionare Ripristina.

Eseguire il ripristino da repository eliminati soft - Portale

1. Passare al Registro Azure Container.
2. Nella sezione Menu selezionare Servizi,
3. Nella scheda Servizi selezionare Repository.
4. Nella scheda Repository selezionare Gestisci repository eliminati.

5. Filtrare il repository eliminato nei repository eliminati temporaneo (anteprima).

6. Selezionare il repository eliminato, filtrare l'artefatto eliminato da in Gestisci artefatti eliminati.
7. Selezionare l'artefatto e selezionare ripristina nella colonna a destra.
8. Viene visualizzata una finestra Ripristina artefatto .

9. Selezionare il tag da ripristinare, qui è possibile scegliere e ripristinare eventuali altri tag.
10. Selezionare Ripristina.

Importante

L'importazione di un'immagine eliminata temporaneamente in entrambe le risorse di origine e di destinazione è bloccata. Il push di un'immagine nel repository eliminato temporaneo ripristinerà il repository eliminato temporaneo. Non è consentito eseguire il push di un'immagine che condivide lo stesso digest del manifesto con l'immagine eliminata temporaneamente. Ripristinare invece l'immagine eliminata soft.

Passaggi successivi

• Altre informazioni sulle opzioni per eliminare immagini e repository in Registro Azure Container.