Odzyskiwanie usuniętych artefaktów przy użyciu zasad usuwania nietrwałego w usłudze Azure Container Registry (wersja zapoznawcza)

Usługa Azure Container Registry (ACR) umożliwia zasady usuwania nietrwałego w celu odzyskania wszelkich przypadkowo usuniętych artefaktów dla ustawionego okresu przechowywania.

Aspekty zasad usuwania nietrwałego

Zasady usuwania nietrwałego można włączać/wyłączać w dowolnym momencie. Po włączeniu zasad usuwania nietrwałego w usłudze ACR zarządza usuniętymi artefaktami jako artefakty usunięte nietrwale z ustawionym okresem przechowywania. Dzięki temu masz możliwość wyświetlania listy, filtrowania i przywracania nietrwałych usuniętych artefaktów.

Okres przechowywania

Domyślny okres przechowywania artefaktów usuniętych nietrwale wynosi siedem dni, ale można ustawić wartość okresu przechowywania z zakresu od jednego do 90 dni. Można ustawić, zaktualizować i zmienić wartość zasad przechowywania. Artefakty usunięte nietrwale wygasają po zakończeniu okresu przechowywania.

Autopurge

Automatyczne generowanie jest uruchamiane co 24 godziny i zawsze uwzględnia bieżącą wartość okresu przechowywania dni przed trwałym usunięciem nietrwałych artefaktów. Na przykład po pięciu dniach usuwania nietrwałego artefaktu, jeśli zmienisz wartość dni przechowywania z siedmiu do 14 dni, artefakt wygaśnie dopiero po 14 dniach od początkowego usunięcia nietrwałego.

Informacje o dostępności i cenach

Ta funkcja jest dostępna we wszystkich warstwach usług (nazywanych również jednostkami SKU). Aby uzyskać informacje o warstwach usług rejestru, zobacz Warstwy usługi Azure Container Registry.

Uwaga

Artefakty usunięte nietrwale są rozliczane zgodnie z cennikiem aktywnych jednostek SKU dla magazynu.

Ograniczenia wersji zapoznawczej

Ważne

Zasady usuwania nietrwałego są obecnie dostępne w wersji zapoznawczej. Zobacz Dodatkowe warunki użytkowania wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta lub wersji zapoznawczej albo w inny sposób nie zostały jeszcze wydane jako ogólnie dostępne.

• Usługa ACR obecnie nie obsługuje ręcznego przeczyszczania nietrwałych artefaktów usuniętych nietrwale.
• Zasady usuwania nietrwałego nie obsługują rejestru replikowanego geograficznie.
• Usługa ACR nie zezwala na włączanie zarówno zasad przechowywania, jak i zasad usuwania nietrwałego. Zobacz Zasady przechowywania dla manifestów bez tagów.

Wymagania wstępne

• Użytkownik wymaga następujących uprawnień (na poziomie rejestru) do wykonywania operacji usuwania nietrwałego:

Uprawnienie	opis
Microsoft.ContainerRegistry/registries/deleted/read	Wyświetlanie listy artefaktów usuniętych nietrwale
Microsoft.ContainerRegistry/registries/deleted/restore/action	Przywracanie artefaktu usuniętego nietrwale

• Aby uruchomić przykłady poleceń w tym artykule, możesz użyć usługi Azure Cloud Shell lub lokalnej instalacji interfejsu wiersza polecenia platformy Azure. Jeśli chcesz używać go lokalnie, wymagana jest wersja 2.0.74 lub nowsza. Uruchom polecenie az --version dla wersji. Jeśli konieczna będzie instalacja lub uaktualnienie, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

• Zaloguj się w witrynie Azure Portal.

Włączanie zasad usuwania nietrwałego dla rejestru — interfejs wiersza polecenia

1. Zaktualizuj zasady usuwania nietrwałego dla danego MyRegistry usługi ACR z okresem przechowywania ustawionym od 1 do 90 dni.

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

2. Pokaż skonfigurowane zasady usuwania nietrwałego dla danego MyRegistry usługi ACR.

   az acr config soft-delete show -r MyRegistry 
   

Wyświetlanie listy nietrwałych artefaktów — interfejs wiersza polecenia

Polecenia az acr repository list-deleted umożliwiają pobieranie i wyświetlanie listy nietrwałych repozytoriów. Aby uzyskać więcej informacji, użyj polecenia --help.

1. Wyświetl listę nietrwałych repozytoriów usuniętych w danym MyRegistry usłudze ACR.

   az acr repository list-deleted -n MyRegistry
   

Polecenia az acr manifest list-deleted umożliwiają pobieranie i wyświetlanie listy manifestów usuwania nietrwałego.

2. Wyświetl listę nietrwałych manifestów repozytorium w danym MyRegistry usłudze hello-world ACR.

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

Polecenia az acr manifest list-deleted-tags umożliwiają pobieranie i wyświetlanie listy tagów usuwania nietrwałego.

3. Wyświetl listę tagów usuwania nietrwałego hello-world repozytorium w danym MyRegistry usłudze ACR.

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

4. Filtruj tagi usuwania nietrwałego hello-world repozytorium, aby dopasować tag latest w danym MyRegistry usłudze ACR.

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

Przywracanie nietrwałych usuniętych artefaktów — interfejs wiersza polecenia

Polecenia az acr manifest restore przywracają pojedynczy obraz według tagu i skrótu.

1. Przywróć obraz repozytorium według tagu latesti skrótu hello-world sha256:abc123 w danym MyRegistry usłudze ACR.

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

2. Przywróć ostatnio usunięty manifest repozytorium według tagu hello-world latest w danym MyRegistry usłudze ACR.

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

Wymuszanie przywracania zastępuje istniejący tag o tej samej nazwie w repozytorium. Jeśli zasady usuwania nietrwałego są włączone podczas wymuszania przywracania. Zastąpiony tag jest usuwany nietrwale. Możesz wymusić przywracanie z określonymi argumentami --force, -f.

3. Wymuś przywrócenie obrazu repozytorium według tagu hello-world latesti skrótu sha256:abc123 w danym MyRegistry usłudze ACR.

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

Ważne

Przywracanie listy manifestów nie będzie rekursywnie przywracać żadnych podstawowych nietrwałych manifestów usuniętych nietrwało. Jeśli przywracasz nietrwałe usunięte artefakty ORAS, przywracanie tematu nie jest rekursywnie przywracane łańcuch odwołań. Ponadto temat musi zostać przywrócony najpierw, tylko wtedy manifest odwołania może zostać przywrócony. W przeciwnym razie zgłasza błąd.

Włączanie zasad usuwania nietrwałego dla rejestru — portal

Możesz również włączyć zasady usuwania nietrwałego rejestru w witrynie Azure Portal.

1. Przejdź do usługi Azure Container Registry.
2. Na karcie Przegląd sprawdź stan usuwania nietrwałego (wersja zapoznawcza).
3. Jeśli stan ma wartość Wyłączone, wybierz pozycję Aktualizuj.

4. Zaznacz pole wyboru, aby włączyć usuwanie nietrwałe.
5. Wybierz liczbę dni między 0 i 90 dni przechowywania nietrwałych usuniętych artefaktów.
6. Wybierz Zapisz, aby zapisać zmiany.

Przywracanie nietrwałych usuniętych artefaktów — portal

1. Przejdź do usługi Azure Container Registry.
2. W sekcji Menu wybierz pozycję Usługi i wybierz pozycję Repozytoria.
3. W obszarze Repozytoria wybierz preferowane repozytorium.
4. Wybierz pozycję Zarządzaj usuniętymi artefaktami , aby wyświetlić wszystkie nietrwałe usunięte artefakty.

Uwaga

Po włączeniu zasad usuwania nietrwałego i wykonaniu akcji, takich jak anulowanie tagu manifestu lub usunięcie artefaktu, będzie można znaleźć te tagi i artefakty w artefaktach usunięcia zarządzanego przed wygaśnięciem liczby dni przechowywania.

5. Odfiltruj usunięty artefakt, który musisz przywrócić.
6. Wybierz artefakt i wybierz pozycję Przywróć w prawej kolumnie.
7. Zostanie wyświetlone okno Przywracanie artefaktu .

8. Wybierz tag, który chcesz przywrócić, w tym miejscu możesz wybrać i odzyskać wszelkie dodatkowe tagi.
9. Wybierz pozycję Przywróć.

Przywracanie z nietrwałych repozytoriów — portal

1. Przejdź do usługi Azure Container Registry.
2. W sekcji Menu wybierz pozycję Usługi,
3. Na karcie Usługi wybierz pozycję Repozytoria.
4. Na karcie Repozytoria wybierz pozycję Zarządzaj usuniętymi repozytoriami.

5. Przefiltruj usunięte repozytorium w repozytoriach usuniętych nietrwale (wersja zapoznawcza).

6. Wybierz usunięte repozytorium, odfiltruj usunięty artefakt z obszaru Zarządzaj usuniętymi artefaktami.
7. Wybierz artefakt i wybierz pozycję Przywróć w prawej kolumnie.
8. Zostanie wyświetlone okno Przywracanie artefaktu .

9. Wybierz tag do przywrócenia. W tym miejscu możesz wybrać i odzyskać inne tagi.
10. Wybierz pozycję Przywróć.

Ważne

Importowanie nietrwałego usuniętego obrazu zarówno w zasobach źródłowych, jak i docelowych jest zablokowane. Wypychanie obrazu do nietrwałego usuniętego repozytorium spowoduje przywrócenie nietrwałego repozytorium usuniętego. Wypychanie obrazu, który udostępnia ten sam skrót manifestu z obrazem usuniętym nietrwale, jest niedozwolone. Zamiast tego przywróć obraz usunięty nietrwale.

Następne kroki

• Dowiedz się więcej o opcjach usuwania obrazów i repozytoriów w usłudze Azure Container Registry.