Recuperare gli artefatti eliminati con il criterio di eliminazione temporanea in Registro Azure Container (anteprima)

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

Aspetti del criterio di eliminazione temporanea

È possibile abilitare/disabilitare i criteri di eliminazione temporanea in qualsiasi momento. Una volta abilitati, i criteri di eliminazione temporanea in Registro Azure Container gestiscono gli artefatti eliminati come artefatti eliminati temporaneamente con un periodo di conservazione impostato. In questo modo è possibile elencare, filtrare e ripristinare gli artefatti eliminati temporaneamente.

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

La rimozione automatica viene eseguita ogni 24 ore e, prima di eliminare definitivamente gli artefatti eliminati temporaneamente, prende sempre in considerazione il valore corrente dei giorni di conservazione. Ad esempio, dopo cinque giorni dall'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'iniziale eliminazione temporanea.

Informazioni su disponibilità e 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 temporaneamente 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.

• Al momento Registro Azure Container non supporta la rimozione 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 Impostare un criterio di conservazione per i manifesti senza tag.

Prerequisiti

• L'utente ha bisogno delle 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 temporaneamente
Microsoft.ContainerRegistry/registries/deleted/read	Recuperare gli artefatti eliminati temporaneamente

• 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 visualizzare 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 - Interfaccia della riga di comando

1. Aggiornare i criteri di eliminazione temporanea per un determinato Registro Azure Container MyRegistry 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 determinato Registro Azure Container MyRegistry.

   az acr config soft-delete show -r MyRegistry 
   

Elencare gli artefatti eliminati temporaneamente - Interfaccia della riga di comando

I comandi az acr repository list-deleted abilitano il recupero e l'elenco dei repository eliminati temporaneamente. Per altre informazioni, usare --help.

1. Elencare i repository eliminati temporaneamente in un determinato Registro Azure Container MyRegistry.

   az acr repository list-deleted -n MyRegistry
   

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

2. Elencare i manifesti eliminati temporaneamente di un repository di hello-world in un determinato Registro Azure Container MyRegistry.

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

I comandi az acr manifest list-deleted-tags permettono di recuperare ed elencare i tag di eliminazione temporanea.

3. Elencare i tag eliminati temporaneamente di un repository di hello-world in un determinato Registro Azure Container MyRegistry.

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

4. Filtrare i tag eliminati temporaneamente di un repository hello-world per abbinare latest tag in un dato ACR MyRegistry.

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

Recuperare gli artefatti eliminati temporaneamente - Interfaccia della riga di comando

I comandi az acr manifest restore ripristinano una singola immagine in base a tag e digest.

1. Ripristinare l'immagine di un repository hello-world contrassegnando latest ed eseguendo il digest di sha256:abc123 in un determinato record di controllo di accesso MyRegistry.

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

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

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

Il ripristino forzato 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 temporaneamente. È possibile forzare il ripristino con argomenti specifici --force, -f.

3. Forzare il ripristino dell'immagine di un repository hello-world contrassegnando latest ed eseguendo il digest di sha256:abc123 in un determinato record di controllo di accesso MyRegistry.

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

Importante

Il ripristino di un elenco manifesti non ripristina in modo ricorsivo i manifesti sottostanti eliminati in modo temporaneo. 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, viene restituito un errore.

Abilitare i criteri di eliminazione temporanea per il registro - Portale

È possibile abilitare i criteri di eliminazione temporanea anche 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 Abilita eliminazione temporanea.
5. Selezionare il numero di giorni tra 0 e 90 giorni per la conservazione degli artefatti eliminati temporaneamente.
6. Seleziona Salva per salvare le modifiche.

Recuperare gli artefatti eliminati temporaneamente - Portale

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

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 il 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.

Ripristinare da repository eliminati temporaneamente - 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 nel Repositori eliminati temporaneamente (anteprima).

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

9. Selezionare il tag da ripristinare. Qui è possibile scegliere e ripristinare eventuali tag aggiuntivi.
10. Selezionare Ripristina.

Importante

Non è possibile importare un'immagine eliminata temporaneamente sia nelle risorse di origine e che in quelle di destinazione. 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. Invece, recuperare gli artefatti eliminati temporaneamente.

Passaggi successivi

• Altre informazioni sulle opzioni che consentono di eliminare immagini e repository in Registro Azure Container.