Mit Artifact Registry-Bereinigungsrichtlinien können Sie die Aufbewahrung und Entfernung von Artefakten in Ihren Repositories automatisieren. Mit diesen Prozessen können Sie die Kosten für die Artefaktspeicherung senken. Ihre Richtlinien können „Löschen“- und „Beibehalten“-Regeln enthalten, die auf einem Tag-Status, Präfixen oder dem Alter basieren. Sie können sich die Änderungen in einem Probelauf ansehen, bevor Sie sie anwenden.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Artifact Registry-Administrator (roles/artifactregistry.admin) für das Repository-Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Anwenden oder Entfernen von Bereinigungsrichtlinien benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Anwenden oder Entfernen von Bereinigungsrichtlinien erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Bereinigungsrichtlinien anzuwenden oder zu entfernen:
-
artifactregistry.repositories.update -
So löschen Sie Artefakte, die die Kriterien einer Bereinigungsrichtlinie erfüllen:
artifactregistry.versions.delete
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Die Standardrolle für den Artifact Registry-Dienst-Agent enthält die Berechtigung artifactregistry.versions.delete, die zum Löschen von Images erforderlich ist, die die Kriterien einer Bereinigungsrichtlinie erfüllen.
Richtliniendatei erstellen
Eine Richtliniendatei ist eine JSON-Datei, in der Ihre Lösch- und Aufbewahrungsrichtlinien definiert sind. Sie können eine Richtliniendatei erstellen, indem Sie eine JSON-Datei erstellen und bearbeiten und dann die Google Cloud CLI verwenden, um die Richtlinie anzuwenden, oder die Google Cloud Console verwenden. Löschrichtlinien geben Bedingungen für das Löschen von Artefakten an. In Aufbewahrungsrichtlinien werden Bedingungen für die Aufbewahrung eines Artefakts oder eine Anzahl der neuesten Versionen angegeben, die aufbewahrt werden sollen. Sie können Bedingungen und die neuesten Versionen nicht in derselben Aufbewahrungsrichtlinie verwenden.
Löschrichtlinie erstellen
Mit einer Löschrichtlinie können Sie das Mindest- oder Höchstalter für das Löschen von Artefakten und zusätzliche Filterkriterien angeben, um die Richtlinie auf bestimmte Artefakte zu beschränken.
Wenn Sie bestimmte Artefakte haben, die Sie aus irgendeinem Grund nicht löschen möchten, erstellen Sie eine bedingte Aufbewahrungsrichtlinie oder eine Aufbewahrungsrichtlinie für die neuesten Versionen sowie eine Löschrichtlinie. Wenn ein Artefakt die Kriterien sowohl der Löschrichtlinie als auch der Aufbewahrungsrichtlinie erfüllt, wird es beibehalten.
Console
Sie können eine Löschrichtlinie für ein neues oder vorhandenes Repository erstellen.
So fügen Sie einem vorhandenen Repository eine Löschrichtlinie hinzu:
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Wählen Sie im Abschnitt Bereinigungsrichtlinien die Option Probelauf aus, um die neue Richtlinie zu testen, bevor Sie Artefakte löschen. Weitere Informationen zu den Testergebnissen finden Sie unter Probelauf.
Wenn Sie sicher sind, dass Ihre Richtlinie wie vorgesehen funktioniert, bearbeiten Sie die Repository-Einstellungen noch einmal und wählen Sie Artefakte löschen aus, um die Bereinigungsrichtlinie anzuwenden und die ausgewählten Artefakte zu löschen.
Klicken Sie auf Bereinigungsrichtlinie hinzufügen und fügen Sie Folgendes hinzu:
- Name: Geben Sie der Bereinigungsrichtlinie einen Namen. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.
- Richtlinientyp: Wählen Sie Bedingtes Löschen aus.
Tag-Status: Gibt an, ob die Richtlinie nach getaggten oder nicht getaggten Artefakten suchen soll. Artefakte werden getaggt, wenn ein Image in ein Repository übertragen oder daraus abgerufen wird. Weitere Informationen zu Docker-Tags finden Sie unter Containerkonzepte.
- Beliebiger Tag-Status: Der Tag-Status wird ignoriert und die Regel gilt sowohl für Artefakte mit als auch ohne Tags.
- Getaggt: Gilt nur für getaggte Artefakte.
- Ohne Tag: Gilt nur für Artefakte ohne Tag.
Formate, die keine Tags unterstützen, werden als
untaggedbehandelt. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.Weitere Informationen zum Tag-Status im Zusammenhang mit Bereinigungsrichtlinien finden Sie in der TagState-Referenz.
Im Folgenden finden Sie optionale Möglichkeiten, Ihre Löschrichtlinie zu definieren:
- Tag-Präfixe: Eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel: Die Präfixe
testundstagingwürden mit Bildern mit den Tagstestenvundstaging-1.5übereinstimmen.tagStatemuss aufTAGGEDgesetzt sein, damit Tag-Präfixe verwendet werden können. - Versionspräfixe: Eine durch Kommas getrennte Liste von Artefaktversionspräfixen. Beispiel:
v1,v2würde mit den Versionenv1.5,v2.0alphaundv10.2übereinstimmen. - Paketpräfixe: Eine Liste von Artefaktnamepräfixen. Sie können mehrere Präfixe eingeben, indem Sie zwischen den Präfixen
Enteroder,drücken. Beispiel:red, bluewürde zwei Präfixe erstellen,redundblue, und würde mit den Artefaktnamenred-team,redisundbluebirdübereinstimmen. - Älter als: ist die Mindestzeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.
30dentspricht beispielsweise 30 Tagen. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sies,m,hoderdanhängen. - Neuer als: die maximale Zeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.
30dentspricht beispielsweise 30 Tagen.
- Tag-Präfixe: Eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel: Die Präfixe
Sie können weitere Bereinigungsrichtlinien hinzufügen, indem Sie auf Bereinigungsrichtlinie hinzufügen klicken.
Klicken Sie auf Aktualisieren.
Die Bereinigungsrichtlinie wird auf Ihr Repository angewendet. Sie können Ihre Bereinigungsrichtlinien im Abschnitt Repository-Details aufrufen, indem Sie auf Mehr anzeigen klicken.
JSON
{
"name": "DELETE_POLICY_NAME",
"action": {"type": "Delete"},
"condition": {
"tagState": "TAG_STATUS",
"tagPrefixes": ["TAG_PREFIXES"],
"versionNamePrefixes": ["VERSION_PREFIXES"],
"packageNamePrefixes": ["PACKAGE_PREFIXES"],
"olderThan": "OLDER_THAN_DURATION",
"newerThan": "NEWER_THAN_DURATION"
}
}
Eine Löschrichtlinie muss einen Namen, eine Aktion und mindestens eine Bedingung enthalten.
name- Im Snippet zum Löschen der Richtlinie ist DELETE_POLICY_NAME der Name der Richtlinie. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.
action- Für eine Löschrichtlinie ist der Wert
{"type": "Delete"}. condition- Geben Sie eine oder mehrere der folgenden Bedingungen an:
tagState: TAG_STATUS gibt an, ob die Richtlinie nach getaggten oder nicht getaggten Artefakten suchen soll. Artefakte werden getaggt, wenn ein Image in ein Repository übertragen oder daraus abgerufen wird. Unterstützte Werte sind:tagged: Gilt nur für getaggte Artefakte.untagged: Gilt nur für Artefakte ohne Tag.any: Ignoriert den Tag-Status und gilt sowohl für Artefakte mit als auch ohne Tag.
Formate, die keine Tags unterstützen, werden als
untaggedbehandelt. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden.Weitere Informationen zu Docker-Tags finden Sie unter Containerkonzepte.
tagPrefixes: TAG_PREFIXES ist eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel:"test", "staging"würde mit Bildern mit den Tags"testenv"und"staging-1.5"übereinstimmen.tagStatemuss aufTAGGEDgesetzt sein, damit Tag-Präfixe verwendet werden können.versionNamePrefixes: VERSION_PREFIXES ist eine durch Kommas getrennte Liste von Artefaktversionspräfixen. Beispiel:"v1", "v2"würde mit den Versionen"v1.5","v2.0alpha"und"v10.2"übereinstimmen.packageNamePrefixes: PACKAGE_PREFIXES ist eine durch Kommas getrennte Liste von Artefaktnamenpräfixen. Beispiel:"red", "blue"würde mit den Artefaktnamen"red-team","redis"und"bluebird"übereinstimmen.olderThan: OLDER_THAN_DURATION ist die Mindestzeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.30dentspricht beispielsweise 30 Tagen. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sies,m,hoderdanhängen.newerThan: NEWER_THAN_DURATION ist die maximale Zeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.30dentspricht beispielsweise 30 Tagen.
Artifact Registry führt Probeläufe und aktive Ausführungen von Bereinigungsrichtlinien mithilfe eines Hintergrundjobs aus, der regelmäßig ausgeführt wird. Änderungen werden innerhalb von etwa einem Tag wirksam.
Bedingte Aufbewahrungsrichtlinie erstellen
Eine bedingte Aufbewahrungsrichtlinie gibt Kriterien für die Aufbewahrung von Artefakten an. Aufbewahrungsrichtlinien werden zusammen mit Löschrichtlinien verwendet, um Artefakte aufzubewahren, die gemäß den Spezifikationen Ihrer Löschrichtlinie gelöscht werden würden, die Sie aber behalten möchten. Wenn ein Artefakt die Kriterien sowohl einer Löschrichtlinie als auch einer Aufbewahrungsrichtlinie erfüllt, wird es aufbewahrt.
Console
Sie können eine Aufbewahrungsrichtlinie für ein neues oder vorhandenes Repository erstellen.
So fügen Sie einem vorhandenen Repository eine Aufbewahrungsrichtlinie hinzu:
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Wählen Sie im Abschnitt Bereinigungsrichtlinien die Option Probelauf aus, um die neue Richtlinie zu testen, bevor Sie Artefakte löschen. Sie müssen mindestens eine Löschrichtlinie festlegen, um die Ergebnisse Ihrer Aufbewahrungsrichtlinie zu sehen. Weitere Informationen zu den Testergebnissen finden Sie unter Probelauf.
Wenn Sie sicher sind, dass Ihre Richtlinien wie vorgesehen funktionieren, bearbeiten Sie die Repository-Einstellungen noch einmal und wählen Sie Artefakte löschen aus, um die Bereinigungsrichtlinien anzuwenden und die ausgewählten Artefakte zu löschen.
Klicken Sie auf Bereinigungsrichtlinie hinzufügen und fügen Sie Folgendes hinzu:
- Name: Geben Sie der Bereinigungsrichtlinie einen Namen. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.
- Richtlinientyp: Wählen Sie Bedingtes Beibehalten aus.
Tag-Status: Gibt an, ob die Richtlinie nach getaggten oder nicht getaggten Artefakten suchen soll. Artefakte werden getaggt, wenn ein Image in ein Repository übertragen oder daraus abgerufen wird. Weitere Informationen zu Docker-Tags finden Sie unter Containerkonzepte.
- Beliebiger Tag-Status: Der Tag-Status wird ignoriert und die Regel gilt sowohl für Artefakte mit als auch ohne Tags.
- Getaggt: Gilt nur für getaggte Artefakte.
- Ohne Tag: Gilt nur für Artefakte ohne Tag.
Formate, die keine Tags unterstützen, werden als
untaggedbehandelt. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden. Weitere Informationen zum Tag-Status im Zusammenhang mit Bereinigungsrichtlinien finden Sie in der TagState-Referenz.
Sie haben folgende optionale Möglichkeiten, Ihre Aufbewahrungsrichtlinie zu definieren:
- Tag-Präfixe: Eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel: Die Präfixe
testundstagingwürden mit Bildern mit den Tagstestenvundstaging-1.5übereinstimmen.tagStatemuss aufTAGGEDgesetzt sein, damit Tag-Präfixe verwendet werden können. - Versionspräfixe: Eine durch Kommas getrennte Liste von Artefaktversionspräfixen. Beispiel:
v1,v2würde mit den Versionenv1.5,v2.0alphaundv10.2übereinstimmen. - Paketpräfixe: Eine durch Kommas getrennte Liste von Artefaktnamenpräfixen.
Beispiel:
red, bluewürde mit den Artefaktnamenred-team,redisundbluebirdübereinstimmen.
- Älter als: ist die Mindestzeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.
30dentspricht beispielsweise 30 Tagen. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sies,m,hoderdanhängen. - Neuer als: die maximale Zeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.
30dentspricht beispielsweise 30 Tagen.
- Tag-Präfixe: Eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel: Die Präfixe
Sie können weitere Bereinigungsrichtlinien hinzufügen, indem Sie auf Bereinigungsrichtlinie hinzufügen klicken.
Klicken Sie auf Aktualisieren.
Die Bereinigungsrichtlinie wird auf Ihr Repository angewendet.
JSON
Das Format ähnelt dem einer Löschrichtlinie. Bei einer Aufbewahrungsrichtlinie ist der Wert für action {"type": "Keep"}.
{
"name": "KEEP_POLICY_NAME",
"action": {"type": "Keep"},
"condition": {
"tagState": "TAG_STATUS",
"tagPrefixes": ["TAG_PREFIXES"],
"versionNamePrefixes": ["VERSION_PREFIXES"],
"packageNamePrefixes": ["PACKAGE_PREFIXES"],
"olderThan": "OLDER_THAN_DURATION",
"newerThan": "NEWER_THAN_DURATION"
}
}
Ersetzen Sie Folgendes:
KEEP_POLICY_NAMEdurch den Namen der Bereinigungsrichtlinie. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.TAG_STATUSdurch den Tag-Status, der angibt, ob die Richtlinie nach getaggten oder nicht getaggten Artefakten suchen soll. Artefakte werden beim Übertragen oder Abrufen eines Images in ein oder aus einem Repository getaggt. Weitere Informationen zu Docker-Tags finden Sie unter Containerkonzepte.Folgende Optionen sind verfügbar:
tagged: Gilt nur für getaggte Artefakte.untagged: Gilt nur für Artefakte ohne Tag.any: gilt für alle Versionen
Formate, die keine Tags unterstützen, werden als
untaggedbehandelt. Wenn für ein Repository unveränderliche Tags aktiviert sind, können getaggte Artefakte nicht gelöscht werden. Weitere Informationen zum Tag-Status im Zusammenhang mit Bereinigungsrichtlinien finden Sie in der TagState-Referenz.TAG_PREFIXESdurch eine durch Kommas getrennte Liste von Tag-Präfixen. Beispiel: Die Präfixetestundstagingwürden mit Bildern mit den Tagstestenvundstaging-1.5übereinstimmen.tagStatemuss aufTAGGEDgesetzt sein, damit Tag-Präfixe verwendet werden können.VERSION_PREFIXESdurch eine durch Kommas getrennte Liste von Artefaktversionspräfixen. Beispiel:v1, v2würde mit den Versionenv1.5,v2.0alphaundv10.2übereinstimmen.PACKAGE_PREFIXESdurch eine durch Kommas getrennte Liste von Artefakt-Namenspräfixen. Beispiel:red, bluewürde mit den Artefaktnamenred-team,redisundbluebirdübereinstimmen.
OLDER_THAN_DURATIONdurch die Mindestzeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.30dentspricht beispielsweise 30 Tagen. Sie können die Dauer in Sekunden, Minuten, Stunden oder Tagen angeben, indem Sies,m,hoderdanhängen.NEWER_THAN_DURATIONdurch die maximale Zeit, die seit der Erstellung der Version eines Artefakts im Repository vergangen ist, angegeben als Dauer.30dentspricht beispielsweise 30 Tagen.
Artifact Registry führt Probeläufe und aktive Ausführungen von Bereinigungsrichtlinien mithilfe eines Hintergrundjobs aus, der regelmäßig ausgeführt wird. Änderungen werden innerhalb von etwa einem Tag wirksam.
Aufbewahrungsrichtlinie für die neuesten Versionen erstellen
Sie können eine Aufbewahrungsrichtlinie erstellen, um eine bestimmte Anzahl von Versionen aufzubewahren. Sie können die Kriterien Bedingtes Beibehalten und Neueste Versionen beibehalten nicht in derselben Aufbewahrungsrichtlinie verwenden.
Aufbewahrungsrichtlinien werden zusammen mit Löschrichtlinien verwendet, um Artefakte aufzubewahren, die gemäß den Spezifikationen Ihrer Löschrichtlinie gelöscht werden würden, die Sie aber behalten möchten. Wenn ein Artefakt die Kriterien sowohl einer Löschrichtlinie als auch einer Aufbewahrungsrichtlinie erfüllt, wird es aufbewahrt.
Console
Sie können eine Richtlinie zum Beibehalten der neuesten Versionen für ein neues oder vorhandenes Repository erstellen.
So fügen Sie einem vorhandenen Repository eine Richtlinie zum Beibehalten der neuesten Versionen hinzu:
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Wählen Sie im Abschnitt Bereinigungsrichtlinien die Option Probelauf aus, um die neue Richtlinie zu testen, bevor Sie Artefakte löschen. Sie müssen mindestens eine Löschrichtlinie festlegen, um die Ergebnisse Ihrer Aufbewahrungsrichtlinie zu sehen. Weitere Informationen zu den Testergebnissen finden Sie unter Probelauf.
Wenn Sie sicher sind, dass Ihre Richtlinien wie vorgesehen funktionieren, bearbeiten Sie die Repository-Einstellungen noch einmal und wählen Sie Artefakte löschen aus, um die Bereinigungsrichtlinien anzuwenden und die ausgewählten Artefakte zu löschen.
Klicken Sie auf Bereinigungsrichtlinie hinzufügen und fügen Sie Folgendes hinzu:
- Name: Geben Sie der Bereinigungsrichtlinie einen Namen. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.
- Richtlinientyp: Wählen Sie Neueste Versionen beibehalten aus.
Geben Sie im Feld Anzahl beibehalten die Anzahl der Versionen eines Artefakts ein, die in Ihrem Repository beibehalten werden sollen.
Optional: Wählen Sie Paketpräfixe aus, um Paketpräfixe anzugeben, auf die die Aufbewahrungsrichtlinie angewendet werden soll. Beispiel:
red, bluewürde mit den Artefaktnamenred-team,redisundbluebirdübereinstimmen.Sie können weitere Bereinigungsrichtlinien hinzufügen, indem Sie auf Bereinigungsrichtlinie hinzufügen klicken.
Klicken Sie auf Aktualisieren.
Die Bereinigungsrichtlinie wird auf Ihr Repository angewendet. Sie können Ihre Bereinigungsrichtlinien im Abschnitt Repository-Details aufrufen, indem Sie auf Mehr anzeigen klicken.
JSON
Das Format ähnelt dem einer Löschrichtlinie. Bei einer Aufbewahrungsrichtlinie lautet der Wert für action {"type": "Keep"}.
Eine Aufbewahrungsrichtlinie zum Beibehalten einer bestimmten Anzahl von Versionen enthält einen mostRecentVersions-Abschnitt anstelle eines condition-Abschnitts.
{
"name": "KEEP_POLICY_NAME",
"action": {"type": "Keep"},
"mostRecentVersions": {
"packageNamePrefixes": ["PACKAGE_PREFIXES"],
"keepCount": MINIMUM_NUMBER
}
}
Ersetzen Sie Folgendes:
KEEP_POLICY_NAMEdurch einen Namen für Ihre Aufbewahrungsrichtlinie. Der Name muss innerhalb der Gruppe von Richtlinien, die Sie auf ein Repository anwenden, eindeutig sein.PACKAGE_PREFIXESdurch die optionalen Paketpräfixe, auf die die Aufbewahrungsrichtlinie angewendet werden soll. Beispiel:red, bluewürde mit den Artefaktnamenred-team,redisundbluebirdübereinstimmen.
MINIMUM_NUMBERdurch die Anzahl der Versionen eines Artefakts, die in Ihrem Repository beibehalten werden sollen.
Wenn Sie die Aufbewahrungsrichtlinie auf alle Pakete in Ihrem Repository anwenden möchten, lassen Sie die Bedingung packageNamePrefixes weg. Die angegebene Anzahl der letzten Versionen jedes Pakets in Ihrem Repository wird beibehalten.
Artifact Registry führt Probeläufe und aktive Ausführungen von Bereinigungsrichtlinien mithilfe eines Hintergrundjobs aus, der regelmäßig ausgeführt wird. Änderungen werden innerhalb von etwa einem Tag wirksam.
Beispielrichtliniendatei
Das folgende Beispiel für eine Richtliniendatei enthält eine Löschrichtlinie und zwei Aufbewahrungsrichtlinien.
- Mit der Richtlinie
delete-prereleasewerden Artefaktversionen 30 Tage nach dem Upload entfernt, wenn das Artefakt mit dem Stringalphaoderv0beginnt. - Mit der Richtlinie
keep-tagged-releasewerden Artefakte mit dem Präfixreleasebeibehalten, deren Dateiname mitwebappodermobilebeginnt. - Mit der Richtlinie
keep-minimum-versionswerden die fünf neuesten Versionen von Artefakten beibehalten, deren Dateiname mitwebapp,mobileodersandboxbeginnt.
[
{
"name": "delete-prerelease",
"action": {"type": "Delete"},
"condition": {
"tagState": "tagged",
"tagPrefixes": ["alpha", "v0"],
"olderThan": "30d"
}
},
{
"name": "keep-tagged-release",
"action": {"type": "Keep"},
"condition": {
"tagState": "tagged",
"tagPrefixes": ["release"],
"packageNamePrefixes": ["webapp", "mobile"]
}
},
{
"name": "keep-minimum-versions",
"action": {"type": "Keep"},
"mostRecentVersions": {
"packageNamePrefixes": ["webapp", "mobile", "sandbox"],
"keepCount": 5
}
}
]
Richtlinien mit einem Probelauf testen
Wenn Sie Ihre Bereinigungsrichtlinien testen möchten, können Sie sie in der Console auf „Probelauf“ festlegen oder den Befehl gcloud artifacts set-cleanup-policies mit dem Flag --dry-run ausführen.
Wenn Sie die Auswirkungen Ihrer Bereinigungsrichtlinien analysieren möchten, können Sie die Audit-Logs für den Datenzugriff in Artifact Registry aufrufen. Wenn Sie Audit-Logs zum Datenzugriff für Bereinigungsrichtlinien erhalten möchten, müssen Sie den Audit-Logtyp Datenschreibvorgang für den Artifact Registry-Dienst explizit aktivieren. Informationen zum Aktivieren von Audit-Logs zum Datenzugriff finden Sie unter Audit-Logs aktivieren.
Console
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Wählen Sie im Abschnitt Bereinigungsrichtlinien die Option Probelauf aus.
Klicken Sie auf Bereinigungsrichtlinie hinzufügen und konfigurieren Sie die Optionen für die Richtlinien Bedingtes Löschen, Bedingtes Beibehalten oder Neueste Versionen beibehalten.
Klicken Sie auf Aktualisieren.
Wenn eine Löschrichtlinie zu einer BatchDeleteVersions-Aktion führt, wird der Parameter validateOnly als "true" ausgewertet.
Artifact Registry führt Probeläufe und aktive Ausführungen von Bereinigungsrichtlinien mithilfe eines Hintergrundjobs aus, der regelmäßig ausgeführt wird. Änderungen werden innerhalb von etwa einem Tag wirksam.
Warten Sie mindestens einen Tag, bevor Sie Audit-Logs für den Probelauf abfragen.
Führen Sie den folgenden Befehl aus, um Audit-Logs für Probeläufe Ihrer Bereinigungsrichtlinien abzufragen:
gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
--resource-names="projects/PROJECT_ID" \
--project=PROJECT_ID
Die Ausgabe sollte so aussehen:
insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
first: true
id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
producer: artifactregistry.googleapis.com
protoPayload:
'@type': type.googleapis.com/google.cloud.audit.AuditLog
authenticationInfo:
principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
authorizationInfo:
- granted: true
permission: artifactregistry.versions.delete
resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
resourceAttributes: {}
methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
request:
'@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
names:
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
validateOnly: true
requestMetadata:
callerIp: private
callerSuppliedUserAgent: stubby_client
destinationAttributes: {}
requestAttributes:
auth: {}
time: '2023-05-26T04:31:21.909465579Z'
resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
labels:
method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
project_id: my-project
service: artifactregistry.googleapis.com
type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'
gcloud
Führen Sie den folgenden Befehl aus, um einen Probelauf mit Ihren Bereinigungsrichtlinien durchzuführen:
gcloud artifacts repositories set-cleanup-policies REPOSITORY \
--project=PROJECT_ID \
--location=LOCATION \
--policy=POLICY_FILE \
--dry-run
Ersetzen Sie Folgendes:
REPOSITORYdurch den Namen des Repositorys.PROJECT_IDdurch die ID Ihres Projekts von Google Cloud .-
LOCATIONist der regionale oder multiregionale Speicherort des Repositorys.
Wenn eine Löschrichtlinie zu einer BatchDeleteVersions-Aktion führt, wird der Parameter validateOnly als "true" ausgewertet.
Artifact Registry führt Probeläufe und aktive Ausführungen von Bereinigungsrichtlinien mithilfe eines Hintergrundjobs aus, der regelmäßig ausgeführt wird. Änderungen werden innerhalb von etwa einem Tag wirksam.
Warten Sie mindestens einen Tag, bevor Sie Audit-Logs für den Probelauf abfragen.
Führen Sie den folgenden Befehl aus, um Audit-Logs für Probeläufe Ihrer Bereinigungsrichtlinien abzufragen:
gcloud logging read 'protoPayload.serviceName="artifactregistry.googleapis.com" AND protoPayload.request.parent="projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY/packages/-" AND protoPayload.request.validateOnly=true' \
--resource-names="projects/PROJECT_ID" \
--project=PROJECT_ID
Die Ausgabe sollte so aussehen:
insertId: qwe123ty3
logName: projects/my-project/logs/cloudaudit.googleapis.com%2Fdata_access
operation:
first: true
id: projects/my-project/locations/us-west1/operations/12345abc-fb9b-4b6f-b02c-9a397ee807d4
producer: artifactregistry.googleapis.com
protoPayload:
'@type': type.googleapis.com/google.cloud.audit.AuditLog
authenticationInfo:
principalEmail: service-774919394028@gcp-sa-staging-artreg.iam.gserviceaccount.com
authorizationInfo:
- granted: true
permission: artifactregistry.versions.delete
resource: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
resourceAttributes: {}
methodName: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
request:
'@type': type.googleapis.com/google.devtools.artifactregistry.v1.BatchDeleteVersionsRequest
names:
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:4bb3756e4e75dfbc3ced87521ed62b26d16fb4e17993ae6877165f2b6551fb55
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:e8185538b50df953529b300be4963b2c21158808becac7aa0d610f61de8ba701
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:7f7fb0a9453da49f831fe92eb8b1751be13acefe1bbd44cc3f0d63d41c422246
- projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/docker-load-thursday/versions/sha256:84ac871a34560b39dd7bde57b4d333f18a7e8c1b61c8d350c1fefeb1fcd2b3ac
parent: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
validateOnly: true
requestMetadata:
callerIp: private
callerSuppliedUserAgent: stubby_client
destinationAttributes: {}
requestAttributes:
auth: {}
time: '2023-05-26T04:31:21.909465579Z'
resourceName: projects/my-project/locations/us-west1/repositories/docker-test-dryrun/packages/-
serviceName: artifactregistry.googleapis.com
receiveTimestamp: '2023-05-26T04:31:22.641338594Z'
resource:
labels:
method: google.devtools.artifactregistry.v1.ArtifactRegistry.BatchDeleteVersions
project_id: my-project
service: artifactregistry.googleapis.com
type: audited_resource
severity: INFO
timestamp: '2023-05-26T04:31:21.909004200Z'
Richtlinien auf ein Repository anwenden
Wenn Sie die in einer lokalen JSON-Datei definierten Bereinigungsrichtlinien verwenden möchten, wenden Sie sie mit der gcloud CLI auf Repositories an, in denen Artifact Registry das automatische Löschen von Artefaktversionen übernehmen soll.
Wenn Sie Bereinigungsrichtlinien anwenden möchten, die in der Console auf Probelauf festgelegt sind, setzen Sie die Richtlinie auf Artefakte löschen.
Sie können Bereinigungsrichtlinien nur auf Standard-Repositories anwenden. Sie können Bereinigungsrichtlinien nicht auf Folgendes anwenden:
- Ein Projekt in Google Cloud .
Console
So wenden Sie Bereinigungsrichtlinien an:
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Wählen Sie im Abschnitt Bereinigungsrichtlinien die Option Artefakte löschen aus.
Artifact Registry löscht und behält Artefakte, die Ihren Richtlinien entsprechen, mithilfe eines regelmäßig ausgeführten Hintergrundjobs. Die Änderungen sollten innerhalb von etwa einem Tag wirksam werden.
gcloud
Führen Sie den folgenden Befehl im Verzeichnis mit der Datei für die Bereinigungsrichtlinie aus, um Bereinigungsrichtlinien anzuwenden.
gcloud artifacts repositories set-cleanup-policies REPOSITORY \
--project=PROJECT_ID \
--location=LOCATION \
--policy=POLICY_FILE \
--no-dry-run
Ersetzen Sie Folgendes:
REPOSITORYdurch den Namen des Repositorys.PROJECT_IDdurch die ID Ihres Projekts von Google Cloud .-
LOCATIONist der regionale oder multiregionale Speicherort des Repositorys. POLICY_FILEist der Name der Datei mit der Bereinigungsrichtlinie.
Mit dem Flag --no-dry-run wird die Probelauffunktion für das Repository deaktiviert.
Mit dem folgenden Befehl werden beispielsweise Richtlinien in policy.json auf das Repository my-repo in der Region us-west1 im Projekt my-project angewendet.
gcloud artifacts repositories set-cleanup-policies my-repo \
--project=my-project \
--location=us-west1 \
--policy=policy.json
Artifact Registry löscht und behält Artefakte, die Ihren Richtlinien entsprechen, mithilfe eines Hintergrundjobs, der regelmäßig ausgeführt wird. Die Änderungen sollten innerhalb eines Tages wirksam werden.
Richtlinie aktualisieren
Console
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Klicken Sie im Bereich Bereinigungsrichtlinien auf den Namen der Richtlinie, die Sie ändern möchten.
Bearbeiten Sie die Bereinigungsrichtlinie und klicken Sie auf Aktualisieren.
Die Bereinigungsrichtlinie wird auf Ihr Repository angewendet.
gcloud
Wenn Sie vorhandene Richtlinien aktualisieren möchten, bearbeiten Sie die Einstellungen in Ihrer Richtliniendatei und führen Sie dann den folgenden Befehl aus, um die Richtlinien noch einmal anzuwenden.
gcloud artifacts repositories set-cleanup-policies REPOSITORY \
--project=PROJECT_ID \
--location=LOCATION \
--policy=POLICY_FILE \
--no-dry-run
Ersetzen Sie Folgendes:
REPOSITORYdurch den Namen des Repositorys.PROJECT_IDdurch die ID Ihres Projekts von Google Cloud .-
LOCATIONist der regionale oder multiregionale Speicherort des Repositorys. POLICY_FILEist der Name der Datei mit der Bereinigungsrichtlinie.
Mit dem Flag --no-dry-run wird die Probelauffunktion für das Repository deaktiviert.
Repository-Bereinigungsrichtlinien auflisten
Sie können sich die mit einem Repository verknüpften Bereinigungsrichtlinien ansehen.
Console
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus, das Sie sich ansehen möchten.
Klicken Sie im Bereich Repository-Details auf Mehr anzeigen.
Die Namen der Bereinigungsrichtlinien werden angezeigt.
Klicken Sie auf Repository bearbeiten, um die Details der Bereinigungsrichtlinien des Repositorys anzusehen oder zu bearbeiten.
Die Details Ihrer vorhandenen Bereinigungsrichtlinien sind im Abschnitt Bereinigungsrichtlinien aufgeführt.
gcloud
Führen Sie dazu diesen Befehl aus:
gcloud artifacts repositories list-cleanup-policies REPOSITORY \
--project=PROJECT_ID \
--location=LOCATION
Ersetzen Sie Folgendes:
REPOSITORYdurch den Namen des Repositorys.PROJECT_IDdurch die ID Ihres Projekts von Google Cloud .-
LOCATIONist der regionale oder multiregionale Speicherort des Repositorys.
Richtlinie aus einem Repository entfernen
Entfernen Sie eine Bereinigungsrichtlinie aus einem Repository, wenn Sie nicht mehr möchten, dass Artifact Registry Artefaktversionen automatisch löscht.
Console
Öffnen Sie in der Google Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
Bewegen Sie den Mauszeiger im Abschnitt Bereinigungsrichtlinien auf den Namen der Richtlinie, die Sie löschen möchten.
Klicken Sie auf das Symbol Löschen.
Klicken Sie auf Aktualisieren.
Die Bereinigungsrichtlinie wird gelöscht.
gcloud
Führen Sie dazu diesen Befehl aus:
gcloud artifacts repositories delete-cleanup-policies REPOSITORY \
--policynames=POLICY_NAMES \
--project=PROJECT_ID \
--location=LOCATION
Ersetzen Sie Folgendes:
REPOSITORYist der Name des Repositorys.PROJECT_IDist die ID des Google Cloud -Projekts.-
LOCATIONist der regionale oder multiregionale Speicherort des Repositorys. POLICY_NAMESist eine durch Kommas getrennte Liste der Namen der Richtlinien, die Sie entfernen möchten.
Mit dem folgenden Befehl wird beispielsweise eine Richtlinie mit dem Namen delete-test aus dem Repository my-repo in der Region us-west1 im Projekt my-project entfernt:
gcloud artifacts repositories delete-cleanup-policies my-repo \
--policynames=delete-test \
--project=my-project \
--location=us-west1
Audit-Logeinträge für Bereinigungsrichtlinien
Wenn Sie Logeinträge zu Bereinigungsrichtlinien in Cloud Logging ansehen möchten, müssen Sie das Logging für DATA_WRITE aktivieren.
Wenn Sie eine Bereinigungsrichtlinie für ein Repository festlegen, wird der Vorgang als Aktualisierung des Repositorys (UpdateRepository-Vorgang) protokolliert.
Wenn Artifact Registry eine Version eines Artefakts löscht, wird das Ereignis in den Cloud Logging-Datenzugriffslogs protokolliert. Die Logeinträge zeigen, dass das Artifact Registry-Dienstkonto die Löschung durchgeführt hat. Die Artifact Registry-Dienstkonto-ID hat das Format service-PROJECT-NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com.