Zarządzanie czyszczeniem zasobów Publisher

W tym artykule opisano nową funkcję programu Azure Operator Service Manager (AOSM), która wykrywa nieużywane artefakty wydawcy i automatyzuje usuwanie zasobów. Ta funkcja pomaga zmniejszyć rozmiar magazynu zasobów, obniżając ogólne koszty usług. Ta funkcja zwiększa również bezpieczeństwo przez przeczyszczanie niepotrzebnych zasobów w odpowiednim czasie, zapobieganie dalszemu dostępowi lub potencjalnemu manipulowaniu.

Podejście historyczne dotyczące czyszczenia zasobów programu Publisher

Przed wprowadzeniem tej funkcji, aby wyczyścić zasoby wydawcy AOSM, użytkownik najpierw wykonywał zapytanie usługi Azure Resource Graph (ARG), aby sprawdzić odwołania do zasobów docelowych, które są w użyciu. Na przykład sprawdź, czy wersja projektu usługi sieciowej (NSDV) jest nadal używana przez usługi sieci lokacji (SNS). Jeśli wynik zapytania ARG nie zawiera odwołań, użytkownik wykonuje polecenie w celu usunięcia zasobu docelowego. Podczas gdy większość typów zasobów obsługuje odnajdywanie odwołań, odwołania do artefaktów w magazynie artefaktów nie były obsługiwane, co utrudniało bezpieczne czyszczenie artefaktów. Inne historyczne braki obejmują:

  • NSDV i NFDV zawierają jedynie odniesienia artifact-store, co uniemożliwia wykonywanie zapytań w celu wykrywania odniesień do artefaktów.
  • Artefakty bezpośrednio przesłane do artifact-store Azure Container Registry (ACR) nie tworzą żadnych odwołań.
  • W przypadkach, gdy helm charts odwołują się do artefaktów w usługach ACR spoza Azure, trudno jest ustalić te odwołania.

Nowe podejście do czyszczenia zasobów programu Publisher

Ta funkcja wprowadza zautomatyzowany, dwuetapowy proces, który najpierw odtagowuje, a później trwale usuwa nieużywane artefakty po usunięciu artifact manifest. Aby wspierać tę funkcję, typ zasobu artifact manifest jest rozszerzany o odniesienia między artefaktem, takim jak wykres Helm lub obraz kontenera, a innymi zasobami, takimi jak Network Function Design Version (NFDV) lub NSDV.

Po próbie artifact manifestusunięcia , te odniesienia są sprawdzane, aby upewnić się, że artefakt nie jest powiązany z żadnymi używanymi zasobami. Jeśli ta walidacja zakończy się pomyślnie, artefakty zostaną oznaczone do usunięcia (bez tagów) i zostanie zwrócony komunikat o powodzeniu. Jeśli ta weryfikacja zakończy się niepowodzeniem, żądanie usunięcia skutkuje niepowodzeniem i zwraca komunikat o błędzie wskazującym, że artefakt jest używany wraz z zasobem, który go nadal używa. Poniżej znajduje się przykład komunikatu o awarii: The resource '<artifactmanifest resourceId>' has some resources attached to it. The dependent resources are: "<NSDV/NFDV resource ids>"

Aby usunąć nieoznaczone artefakty, uruchamia się polecenie Azure CLI. Prawidłowe scenariusze użycia obejmują: administratora wykonującego polecenie ad hoc, zautomatyzowany potok klienta wykonujący polecenie lub harmonogram czasowy, taki jak crontab, wykonujący polecenie. Podejście opóźnionego usuwania zapewnia dodatkowy czas na konieczną ręczną weryfikację lub zatwierdzenia, aby zapewnić dokładność usunięcia lub całkowicie cofnąć żądanie usunięcia.

Zmiany w typie zasobu manifestu artefaktu

Aby wspierać rozszerzone specyfikacje artifact manifest typu zasobów, wprowadzane są zmiany w API dostawcy zasobów, zaczynając od wersji 2025-03-30. W poniższych sekcjach opisano zachowanie rozwiązania AOSM przed i po wdrożeniu tej zmiany funkcji. Migracja do tego nowego rozszerzonego typu zasobów jest opcjonalna, a migracja jest omówiona później w tym artykule.

Manifest artefaktu wykorzystuje silną korelację

Typ zasobu artifact manifest ma silną korelację z artefaktami Helm (obrazami i wykresami) wgranymi do magazynu artefaktów stanowiącego zaplecze usługi ACR. Wszystkie artefakty używane przez aplikację nfApp są przechowywane w unikatowych wersjach wystąpień manifestu artefaktu. To tworzy połączenia referencyjne między artefaktami i nfApps.

Przed 2025-03-30

W typie zasobu artifact manifest nie istnieje silna korelacja.

Repositories

  • nginx
  • testapp
"artifacts": [ 
            { 
                "artifactName": "testapp", 
                "artifactType": "OCIArtifact", 
                "artifactVersion": "1.0.0" 
            }, 
            { 
                "artifactName": "nginx", 
                "artifactType": "OCIArtifact", 
                "artifactVersion": "1.0.0" 
            } 

Z 2025-03-30

Typ artifact manifest zasobu sprawdza artefakty w artifact manifest ścieżce. Brak zmian w sekcji artifact manifest body.

Repositories

  • cnfmanifest/nginx
  • cnfmanifest/testapp
"artifacts": [ 
            { 
                "artifactName": "testapp", 
                "artifactType": "OCIArtifact", 
                "artifactVersion": "1.0.0" 
            }, 
            { 
                "artifactName": "nginx", 
                "artifactType": "OCIArtifact", 
                "artifactVersion": "1.0.0" 
            } 
        ]

Token mapy zakresów manifestu artefaktu

Typ artifact manifest zasobu tworzy tokeny mapy zakresu z nazwą artefaktu zawartą w ścieżce.

Przed 2025-03-30

Nie utworzono tokenów mapy zakresu.

Repositories

  • nginx
  • testapp

Z 2025-03-30

Tokeny mapy zakresu ze ścieżką są tworzone w tym samym czasie co artifact manifest.

Repositories

  • cnfmanifest/nginx
  • cnfmanifest/testapp

Ścieżka przesyłania manifestu artefaktu

Wszystkie obrazy należące do obiektu artifact manifest są przesyłane przy użyciu nazwy artifact manifest w ścieżce docelowej.

Przed 2025-03-30

Brak wymagań dotyczących ścieżki podczas przesyłania artefaktów.

Repositories

  • nginx
  • testapp

Z 2025-03-30

Wymagania dotyczące ścieżek są egzekwowane dla artefaktów w typie zasobu artifact manifest.

Repositories

  • cnfmanifest/nginx
  • cnfmanifest/testapp

Usuń tag manifestu artefaktu, aby go usunąć

artifact manifest Usunięcie typu zasobu usuwa tagi ze wszystkich artefaktów zawartych w tej wersji manifestu.

Przed 2025-03-30

Nie wprowadzono zmian w powiązanym repozytorium ACR dla magazynu artefaktów podczas usuwania zasobu typu artifact manifest.

Z 2025-03-30

Artefakty nie są oznaczane w magazynie artefaktów stanowiącym zaplecze usługi ACR podczas usuwania typu zasobu artifact manifest.

Warunek skasowania manifestu artefaktu

Typ artifact manifest zasobu można usunąć tylko wtedy, gdy nie są skojarzone żadne zasoby odwołujące się.

Przed 2025-03-30

Żaden warunek nie uniemożliwił usunięciu typu zasobu artifact manifest.

Z 2025-03-30

W przypadku pomyślnego usunięcia element artifact manifest nie może zawierać żadnych odwołań do zasobów oznaczonych tagiem.

Usuń nieotagowane artefakty z manifestu

Usuń nieoznaczone artefakty, używając polecenia az acr repository delete Azure CLI z odpowiednimi parametrami harmonogramowania.

Przed 2025-03-30

Żaden warunek nie uniemożliwił trwałego usuwania usuniętych artefaktów.

Z 2025-03-30

Następujące polecenie interfejsu wiersza polecenia platformy Azure może służyć do przeczyszczania artefaktów. Polecenie można zaplanować za pomocą narzędzia crontab lub uruchomić na żądanie.

Przykład programu PowerShell:

az acr manifest list-metadata -n myRegistry –r myRepository --query "[?tags[0]==null].digest" -o tsv | %{ az acr repository delete -n myRegistry --image myRepository@$_ --yes }

Przykład Basha:

az acr manifest list-metadata $(destination_acr_name).azurecr.io/$repo --query "[?tags[0]==null].digest" -o tsv --only-show-errors | while read -r line; do az acr repository delete -n $(destination_acr_name) --image "$repo@$line" --yes

Uwaga / Notatka

Do uruchomienia tego polecenia potrzebne są odpowiednie uprawnienia RBAC. Zazwyczaj potrzebujesz albo roli ArcDelete lub Container Registry Repository Contributor. Jeśli nie masz odpowiednich uprawnień, polecenie zwraca wynik Error: authentication required.

Zaktualizowane odniesienie do manifestu artefaktu NSDV/NFDV

NSDV i NFDV obejmują odwołanie do typu zasobu artifact manifest.

Przed 2025-03-30

NSDV i NFDV odwołują się do typu zasobu artfact-store.

 "artifactStore": { 
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testgroup/providers/Microsoft.HybridNetwork/publishers/testpublisher/artifactStores/as "
 }

Z 2025-03-30

NSDV i NFDV odwołują się do typu zasobu artfact manifest.

 "artifactStore": { 
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testgroup/providers/Microsoft.HybridNetwork/publishers/testpublisher/artifactStores/as/artifactManifests/cnfmanifest"   } 

Wersja interfejsu API NSDV/NFDV

NSDV i NFDV, do których odwołuje się artifact manifest, muszą zostać utworzone w wersji 2025-03-30 lub nowszej.

Przed 2025-03-30

Nie ma takiego ograniczenia.

Z 2025-03-30

Aby utworzyć typy zasobów artifact manifest, należy użyć odpowiedniej wersji interfejsu API.

Migrowanie do nowego manifestu artefaktu

Użyj następującej listy zadań, aby przeprowadzić migrację wdrożonego artifact manifest zasobu utworzonego przed wersją 20025-03-30interfejsu API do nowego artifact manifest typu zasobu dostępnego po wersji 2025-03-30interfejsu API:

  • Przygotuj platformę, instalując wersję 3.0.3131-220 rozszerzenia operatora funkcji sieciowej (NFO) lub nowszą.
  • Aby migrować istniejące zasoby stworzone za pomocą starszych API, wykonaj następujące kroki. Nie wdrażaj żadnych zmian, dopóki nie osiągniesz etapu wdrożenia.
    • Zmień NSDV, NFDV i artifact manifest na nową wersję API.
    • Zmień odwołania artifact-store, aby korzystać z nowych artifact manifest.
    • Zaktualizuj artifact manifests o nowe rozszerzone odniesienia do artefaktów.
    • Przesyłaj artefakty, aby spełnić nowe wymagania dotyczące ścieżki artifact manifest.
    • Wdrażaj zmiany i aktualizacje wprowadzone we wszystkich zasobach.
  • Akcja czyszczenia wydawcy obsługuje tylko zasoby utworzone przy użyciu wersji interfejsu API 2025-03-30
    • Zasoby utworzone w starszej wersji można zaktualizować do wersji 2025-03-30.
    • Tylko artefakty przekazywane po uaktualnieniu są brane pod uwagę przy czyszczeniu.
    • Artefakty przekazane przed uaktualnieniem nie są brane pod uwagę podczas czyszczenia

Uwaga / Notatka

Zasoby utworzone za pomocą NSDV i NFDV, które nadal mają odwołanie do magazynów artefaktów zamiast manifestów artefaktów, nie mogą być używane do znajdowania zlikwidowanych artefaktów, chyba że zostaną uaktualnione.

Zapytanie w celu odnalezienia odwołania do manifestu artefaktu

Poniższe zapytanie ARG może zostać użyte do wylistowania wszystkich woluminów NFDV lub NSDV, które zawierają odwołania do manifestu artefaktu. Jeśli w tych danych wyjściowych pojawi się zasób, próba usunięcia manifestu artefaktu zakończy się niepowodzeniem.

resources
 | where type == "microsoft.hybridnetwork/publishers/networkfunctiondefinitiongroups/networkfunctiondefinitionversions" or type  == "microsoft.hybridnetwork/publishers/networkservicedesigngroups/networkservicedesignversions"
 | where properties contains "<artifactmanifestresoruceid>"
 | project id,subscriptionId,resourceGroup

Opcjonalnie, aby zapytać o konkretny NFDV lub NSDV, wstaw referencję do zapytania z identyfikatorem zasobu.

resources
 | where type == "microsoft.hybridnetwork/publishers/networkfunctiondefinitiongroups/networkfunctiondefinitionversions" or type  == "microsoft.hybridnetwork/publishers/networkservicedesigngroups/networkservicedesignversions"
 | where id == "nfdv id" or id == "nsdv id"
 | where properties contains "<artifactmanifestresoruceid>"
 | project id,subscriptionId,resourceGroup