Obnovení odstraněných artefaktů pomocí zásad obnovitelného odstranění ve službě Azure Container Registry (Preview)

  • Článek

Azure Container Registry (ACR) umožňuje zásadě obnovitelného odstranění obnovit případné náhodně odstraněné artefakty po nastavenou dobu uchovávání.

Diagram of soft delete artifacts lifecycle.

Aspekty zásad obnovitelného odstranění

Zásady obnovitelného odstranění je možné kdykoli povolit nebo zakázat. Jakmile v ACR povolíte zásady obnovitelného odstranění, spravuje odstraněné artefakty jako artefakty s nastaveným obdobím uchovávání. Díky tomu máte možnost vypsat, filtrovat a obnovit artefakty obnovitelného odstranění.

Doba uchovávání

Výchozí doba uchovávání artefaktů obnovitelného odstranění je sedm dnů, ale je možné nastavit hodnotu doby uchovávání mezi 1 až 90 dny. Můžete nastavit, aktualizovat a změnit hodnotu zásad uchovávání informací. Po dokončení doby uchovávání vyprší platnost artefaktů obnovitelného odstranění.

Automatické výpurge

Automatický účel se spouští každých 24 hodin a vždy považuje aktuální hodnotu dnů uchovávání před trvalým odstraněním obnovitelně odstraněných artefaktů. Pokud například po pěti dnech obnovitelného odstranění artefaktu změníte hodnotu dnů uchovávání od sedmi na 14 dnů, platnost artefaktu vyprší pouze po 14 dnech od počátečního obnovitelného odstranění.

Diagram of soft delete artifacts lifecycle.

Informace o dostupnosti a cenách

Tato funkce je dostupná ve všech úrovních služby (označovaných také jako skladové položky). Informace o úrovních služby registru najdete v tématu Úrovně služby Azure Container Registry.

Poznámka:

Artefakty obnovitelného odstranění se účtují podle cen aktivní skladové položky úložiště.

Omezení verze Preview

Důležité

Zásady obnovitelného odstranění jsou aktuálně ve verzi PREVIEW. Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.

  • ACR v současné době nepodporuje ruční vymazání obnovitelně odstraněných artefaktů.
  • Zásady obnovitelného odstranění nepodporují geograficky replikovaný registr.
  • ACR neumožňuje povolit zásady uchovávání informací i zásady obnovitelného odstranění. Viz zásady uchovávání informací pro neoznačené manifesty.

Požadavky

  • Uživatel k provádění operací obnovitelného odstranění vyžaduje následující oprávnění (na úrovni registru):
Oprávnění Popis
Microsoft.ContainerRegistry/registry/deleted/read Výpis obnovitelně odstraněných artefaktů
Microsoft.ContainerRegistry/registry/deleted/restore/action Obnovení obnovitelně odstraněného artefaktu

  • Ke spuštění příkladů příkazů v tomto článku můžete použít Azure Cloud Shell nebo místní instalaci Azure CLI. Pokud ho chcete používat místně, vyžaduje se verze 2.0.74 nebo novější. Spusťte az --version verzi. Pokud potřebujete instalaci nebo upgrade, přečtěte si téma Instalace Azure CLI.

  • Přihlaste se k portálu Azure.

Povolení zásad obnovitelného odstranění pro registr – ROZHRANÍ příkazového řádku

  1. Aktualizujte zásady obnovitelného odstranění pro danou MyRegistry službu ACR s dobou uchování nastavenou mezi 1 a 90 dny.

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

  2. Zobrazí nakonfigurované zásady obnovitelného odstranění pro danou MyRegistry službu ACR.

    az acr config soft-delete show -r MyRegistry

Výpis obnovitelně odstraněných artefaktů – rozhraní příkazového řádku

Příkazy az acr repository list-deleted umožňují načítat a vypisovat obnovitelně odstraněná úložiště. Další informace potřebujete.--help

  1. Výpis obnovitelně odstraněných úložišť v dané MyRegistry službě ACR

    az acr repository list-deleted -n MyRegistry

Příkazy az acr manifest list-deleted umožňují načtení a výpis manifestů obnovitelného odstranění.

  1. Výpis obnovitelně odstraněných manifestů hello-world úložiště v dané MyRegistry službě ACR

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

Příkazy az acr manifest list-deleted-tags umožňují načítání a výpis značek obnovitelného odstranění.

  1. Vypište značky obnovitelného hello-world odstranění úložiště v dané MyRegistry službě ACR.

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

  2. Vyfiltrujte značky obnovitelného hello-world odstranění úložiště tak, aby odpovídaly značce latest v dané MyRegistry službě ACR.

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

Obnovení obnovitelně odstraněných artefaktů – rozhraní příkazového řádku

Příkazy az acr manifest restore obnoví jednu image podle značky a digestu.

  1. Obnovte image hello-world úložiště značkou latesta hodnotou hash sha256:abc123 v dané MyRegistry službě ACR.

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

  2. Obnovte naposledy odstraněný manifest hello-world úložiště podle značky latest v dané MyRegistry službě ACR.

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

Vynucení obnovení přepíše existující značku se stejným názvem v úložišti. Pokud je během vynuceného obnovení povolená zásada obnovitelného odstranění. Přepsáná značka je obnovitelně odstraněna. Obnovení můžete vynutit pomocí konkrétních argumentů --force, -f.

  1. Vynuťte obnovení image hello-world úložiště značkou latesta hodnotou hash sha256:abc123 v dané MyRegistry službě ACR.

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

Důležité

Obnovení seznamu manifestu nebude rekurzivně obnovovat žádné podkladové obnovitelné odstraněné manifesty. Pokud obnovujete obnovitelně odstraněné artefakty ORAS, obnovení předmětu rekurzivně neobnoví řetěz refererů. Dále musí být předmět nejprve obnoven, pouze pak je možné obnovit manifest referreru. V opačném případě vyvolá chybu.

Povolení zásad obnovitelného odstranění pro registr – portál

Zásady obnovitelného odstranění registru můžete povolit také na webu Azure Portal.

  1. Přejděte do služby Azure Container Registry.
  2. Na kartě Přehled ověřte stav obnovitelného odstranění (Preview).
  3. Pokud je stav zakázaný, vyberte Aktualizovat.

Screenshot to view the soft delete policy.

  1. Zaškrtnutím políčka povolíte obnovitelné odstranění.
  2. Vyberte počet dní mezi 0 a 90 dny pro zachování artefaktů obnovitelného odstranění.
  3. Výběrem možnosti Uložit uložte změny.

Screenshot to enable soft delete policy.

Obnovení obnovitelně odstraněných artefaktů – portál

  1. Přejděte do služby Azure Container Registry.
  2. V části Nabídka vyberte služby a vyberte úložiště.
  3. V úložištích vyberte preferované úložiště.
  4. Výběrem možnosti Spravovat odstraněné artefakty zobrazíte všechny obnovitelné odstraněné artefakty.

Poznámka:

Jakmile povolíte zásady obnovitelného odstranění a provedete akce, jako je zrušení označení manifestu nebo odstranění artefaktu, budete moci tyto značky a artefakty najít v artefaktech spravovaného odstranění před vypršením počtu dnů uchovávání.

Screenshot of manage deleted artifacts.

  1. Vyfiltrujte odstraněný artefakt, který musíte obnovit.
  2. Vyberte artefakt a v pravém sloupci vyberte Obnovit .
  3. Zobrazí se okno Obnovit artefakt.

Screenshot to restore soft delete artifacts.

  1. Vyberte značku, kterou chcete obnovit, tady máte možnost zvolit a obnovit všechny další značky.
  2. Vyberte možnost Obnovit.

Screenshot of restore window.

Obnovení z obnovitelně odstraněných úložišť – portál

  1. Přejděte do služby Azure Container Registry.
  2. V části Nabídka vyberte Služby.
  3. Na kartě Služby vyberte úložiště.
  4. Na kartě Úložiště vyberte možnost Spravovat odstraněná úložiště.

Screenshot of manage delete repositories.

  1. Vyfiltrujte odstraněné úložiště v obnovitelně odstraněných úložištích (Preview).

Screenshot of soft delete repositories.

  1. Vyberte odstraněné úložiště, vyfiltrujte odstraněný artefakt ze správě odstraněných artefaktů.
  2. Vyberte artefakt a v pravém sloupci vyberte Obnovit .
  3. Zobrazí se okno Obnovit artefakt.

Screenshot to restore soft delete repositories.

  1. Vyberte značku, kterou chcete obnovit, tady máte možnost zvolit a obnovit všechny ostatní značky.
  2. Vyberte možnost Obnovit.

Screenshot of restore window for soft delete repositories.

Důležité

Import obnovitelně odstraněné image ve zdrojovém i cílovém prostředku je blokovaný. Nahrání image do obnovitelného odstraněného úložiště obnoví obnovitelně odstraněné úložiště. Nasdílením image, která sdílí stejnou hodnotou hash manifestu s obnovitelně odstraněnou imagí, není povoleno. Místo toho obnovte obnovitelně odstraněnou image.

Další kroky

  • Přečtěte si další informace o možnostech odstranění imagí a úložišť ve službě Azure Container Registry.