Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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ą:
-
NSDViNFDVzawierają jedynie odniesieniaartifact-store, co uniemożliwia wykonywanie zapytań w celu wykrywania odniesień do artefaktów. - Artefakty bezpośrednio przesłane do
artifact-storeAzure 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-220rozszerzenia 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,NFDViartifact manifestna nową wersję API. - Zmień odwołania
artifact-store, aby korzystać z nowychartifact manifest. - Zaktualizuj
artifact manifestso 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.
- Zmień
- 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
- Zasoby utworzone w starszej wersji można zaktualizować do wersji
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