Aufbewahrungsregeln für Tags konfigurieren

Auf dieser Seite finden Sie eine Anleitung zum Erstellen und Verwalten von Tag-Aufbewahrungsregeln für Administratoren oder Entwickler, die Harbor-Repositories verwalten und warten. Harbor-Regeln zur Aufbewahrung von Tags sind eine Reihe von Richtlinien, mit denen Image-Tags in Harbor-Repositories automatisch verwaltet und optimiert werden.

Mit Tag-Aufbewahrungsregeln können Sie folgende Aktionen ausführen:

  • Speicherplatz freigeben: Um unnötige Daten zu vermeiden, können Sie Regeln definieren, mit denen Artefakte für einen bestimmten Zeitraum aufbewahrt werden. Sie können auch ungenutzte Bild-Tags manuell löschen.
  • Repository sauber halten: Behalten Sie nur die neuesten oder relevantesten Tags bei, um die Organisation und Auffindbarkeit zu verbessern.
  • Tag-Verwaltung automatisieren: Manuelles Löschen vermeiden und die Wartung Ihrer Bild-Repositories optimieren.

Mit Tag-Aufbewahrungsregeln können Sie Images in Ihrem Repository verwalten, indem Sie nicht mehr benötigte Image-Tags automatisch löschen. Filter für Aufbewahrungsregeln durchlaufen Ihre Tags in drei aufeinanderfolgenden Schritten, um zu bestimmen, welche Bilder Sie behalten und welche Sie löschen möchten:

  1. Repositories (Repositories): Geben Sie den Namen des Repositorys ein. Harbor wendet zuerst den Repository-Filter an und dann die Aufbewahrungsregel auf alle Repositorys an, die dem Repository-Namen entsprechen. Platzhalter wie *repo, repo* und ** sind zulässig. Weitere Informationen finden Sie unter Filter mit Platzhaltermustern anwenden. Sie können den Repository-Filter beispielsweise auf ** festlegen. Das bedeutet, dass alle Repositories im Projekt berücksichtigt werden.
  2. Beizubehaltende Menge: Geben Sie die maximale Anzahl von Tags oder einen maximalen Zeitraum an, für den Tags beibehalten werden sollen. Sie können beispielsweise die Aufbewahrungsrichtlinie so festlegen, dass die 10 zuletzt abgerufenen Artefakte in jedem Repository beibehalten werden.
  3. Beizubehaltende Tags: Geben Sie die Namen der Image-Tags ein, die Sie beibehalten möchten. Harbor wendet die Aufbewahrungsregel auf Image-Tags an, die mit dem eingegebenen Text übereinstimmen. Mit dem Kästchen können Sie auswählen, ob Sie nicht getaggte Artefakte als Teil der Artefakte erfassen möchten, die für die Tag-Aufbewahrung infrage kommen, oder Tags, die diesen Namen nicht haben. Platzhalter wie *tag, tag* und ** sind zulässig. Weitere Informationen finden Sie unter Filter mit Platzhaltermustern anwenden.

Hinweise

Bevor Sie Aufbewahrungsregeln für Tags erstellen, benötigen Sie Folgendes:

Regel zur Tag-Aufbewahrung erstellen

Die Regeln für Aufbewahrungstags in Harbor folgen einer bestimmten Reihenfolge und Logik. Beachten Sie beim Erstellen von Harbor-Tag-Aufbewahrungsregeln die folgenden Grundsätze:

  • Definieren Sie Tag-Aufbewahrungsregeln für Repositories, nicht für Projekte. Wenn Sie eine Aufbewahrungsregel für ein Repository definieren, geben Sie die beizubehaltenden Tags an.
  • Definieren Sie keine Regeln, um Tags explizit zu entfernen. Wenn Sie eine Regel festlegen, werden alle Tags in einem Repository, die Sie nicht als für die Aufbewahrung infrage kommend identifizieren, vom System verworfen.
  • Der OR-Algorithmus wird zwischen Regeln verwendet.

So erstellen Sie eine Tag-Aufbewahrungsregel mit der Harbor-Konsole:

  1. Melden Sie sich in der Harbor-Konsole mit einem Konto an, das Projektadministratorberechtigungen hat.
  2. Rufen Sie Projekte auf und wählen Sie ein Projekt aus.
  3. Klicken Sie im Projektfenster auf den Tab Richtlinie und dann auf Tag Retention (Tag-Aufbewahrung).
  4. Klicken Sie auf Add Rule (Regel hinzufügen).

  5. Wählen Sie im Menü Repositories die Option matching (übereinstimmend) oder excluding (ausschließend) aus.

    Wenn Sie matching auswählen, wendet Harbor die Regel auf die von Ihnen angegebenen Repositorys an. Wenn Sie excluding (ausschließen) auswählen, wendet Harbor die Regel auf alle Repositories im Projekt an, mit Ausnahme der von Ihnen angegebenen.

  6. Geben Sie im Feld Repositories die Namen der Repositorys ein, auf die die Regel angewendet werden soll. Hier einige Beispiele für Texteingaben:

    • Ein Repository-Name wie example_repo_1.
    • Eine durch Kommas getrennte Liste von Repository-Namen, z. B. example_repo_1,example_repo_2,example_repo_3.
    • Ein partieller Repository-Name mit Platzhaltern wie example_*, *_3 oder *_repo_*.
    • Wenn Sie die Regel auf alle Repositories im Projekt anwenden möchten, verwenden Sie den Platzhalter **.
    • Weitere Informationen finden Sie unter Filter mit Platzhaltermustern anwenden.

  7. Wählen Sie im Menü Nach Anzahl der Artefakte oder Anzahl der Tage aus, wie viele Tags beibehalten werden sollen oder für welchen Zeitraum Tags beibehalten werden sollen. Folgende Optionen sind verfügbar:

    • Die zuletzt gepushten # Artefakte beibehalten: Eine bestimmte Anzahl von Artefakten beibehalten, wobei die zuletzt gepushten Artefakte priorisiert werden. Für Artefakte gilt keine Altersbeschränkung.
    • Die zuletzt abgerufenen # Artefakte beibehalten: Eine bestimmte Anzahl von Artefakten beibehalten, wobei die zuletzt abgerufenen Artefakte priorisiert werden. Für Artefakte gilt keine Altersbeschränkung.
    • Die in den letzten # Tagen übertragenen Artefakte beibehalten: Artefakte, die innerhalb eines bestimmten Zeitraums übertragen wurden, werden beibehalten. Die Anzahl der Artefakte ist unbegrenzt.
    • In den letzten # Tagen abgerufene Artefakte beibehalten: Artefakte, die innerhalb eines bestimmten Zeitraums abgerufen wurden, werden beibehalten. Die Anzahl der Artefakte ist unbegrenzt.
    • Immer beibehalten: Artefakte, die dieser Regel entsprechen, werden immer beibehalten.

  8. Wählen Sie im Menü Tags die Option Übereinstimmung oder Ausschluss aus.

    Wenn Sie Abgleich auswählen, wendet Harbor die Regel auf die von Ihnen angegebenen Tags an. Wenn Sie excluding auswählen, wendet Harbor die Regel auf alle Tags im Repository an, mit Ausnahme der von Ihnen angegebenen.

  9. Geben Sie im Feld Tags die Namen der Tags ein, auf die die Regel angewendet werden soll.

    Hier einige Beispiele für Texteingaben:

    • Ein Tag-Name wie example_tag_1.
    • Eine durch Kommas getrennte Liste von Tagnamen, z. B. example_tag_1,example_tag_2,example_tag_3.
    • Ein Teil-Tag-Name mit Platzhaltern wie example_*, *_3 oder *_tag_*.
    • Wenn Sie die Regel auf alle Tags im Projekt anwenden möchten, verwenden Sie den Platzhalter **.
    • Weitere Informationen finden Sie unter Filter mit Platzhaltermustern anwenden.

  10. Klicken Sie auf Hinzufügen, um die Regel zu speichern.

  11. Optional: Wenn Sie weitere Regeln hinzufügen möchten, klicken Sie auf Regel hinzufügen. Sie können maximal 15 Regeln pro Projekt hinzufügen.

  12. Optional: Klicken Sie im Menü Zeitplan auf Bearbeiten und wählen Sie aus, wie oft die Regel ausgeführt werden soll. Wenn Sie Benutzerdefiniert auswählen, geben Sie einen Cronjob-Befehl ein, um die Regel zu planen. Wenn Sie mehrere Regeln definieren, wendet Harbor den Zeitplan auf alle Regeln an. Sie können nicht festlegen, dass verschiedene Regeln zu unterschiedlichen Zeiten ausgeführt werden.

  13. Wenn Sie die von Ihnen definierten Regeln testen möchten, klicken Sie auf Probelauf.

  14. Wenn Sie die Regel sofort ausführen möchten, klicken Sie auf Jetzt ausführen.

Filter mit Platzhaltermustern anwenden

Harbor verwendet den Doublestar-Musterabgleich. Platzhaltermuster sind Sonderzeichen oder Sequenzen, die verwendet werden, um ein oder mehrere Zeichen in einem String abzugleichen oder darzustellen. Verwenden Sie Platzhaltermuster, wenn Sie Filter auf Ihre Repository- oder Tag-Namen anwenden, wenn Sie Tag-Aufbewahrungsregeln erstellen. Platzhalter bieten die folgenden Funktionen:

  • Stellen Sie ein oder mehrere Zeichen dar, ohne sie explizit anzugeben.

  • Gängige Platzhalter werden so verwendet:

    • *: Entspricht null oder mehr Zeichen.
    • ?: entspricht einem beliebigen einzelnen Zeichen.

    Beispiel: file* entspricht jedem Dateinamen, der mit file beginnt.

  • Ermöglicht flexibles Abgleichen, was nützlich ist, wenn Sie die genauen Zeichen nicht kennen.

Verwenden Sie die folgenden unterstützten Platzhaltermuster, wenn Sie Regeln für die Aufbewahrung von Tags angeben:

Muster Beschreibung
* Entspricht einer beliebigen Folge von Zeichen, die keine Pfadtrennzeichen sind.
** Entspricht null oder mehr Verzeichnissen.
? Entspricht einem beliebigen einzelnen Zeichen, das kein Pfadtrennzeichen ist.
[class] Entspricht einem einzelnen Zeichen, das kein Pfadtrennzeichen ist, in einer Zeichenklasse. Weitere Informationen finden Sie unter Filter mit Zeichenklassen anwenden.
{alt1,...} Entspricht einer Zeichenfolge, wenn eine der durch Kommas getrennten Alternativen übereinstimmt.

Weitere Informationen zum Abgleich von Doublestar-Mustern finden Sie unter https://github.com/bmatcuk/doublestar.

Filter mit Zeichenklassen anwenden

Sowohl Zeichenklassen als auch Platzhalter werden für den Musterabgleich verwendet. Verwenden Sie Zeichenklassen, wenn Sie Filter auf Ihre Repository- oder Tag-Namen anwenden, um Tag-Aufbewahrungsregeln zu erstellen. Zeichenklassen bieten im Vergleich zu Platzhaltermustern die folgenden Möglichkeiten:

  • Definieren Sie eine Reihe bestimmter Zeichen, die an einer bestimmten Position übereinstimmen können.
  • Setzen Sie das Set in eckige Klammern ([]). Beispielsweise stimmt [aeiou] mit einem beliebigen einzelnen Vokal überein.
  • Ermöglicht einen genaueren Abgleich, da Sie die zulässigen Zeichen explizit auflisten.

Verwenden Sie die folgenden Zeichenklassen, um Repositories zu filtern und Ihre Aufbewahrungsregeln zu konfigurieren:

Klasse Beschreibung
[abc] Stimmt mit einem beliebigen einzelnen Zeichen in der Gruppe überein.
[a-z] Stimmt mit einem beliebigen einzelnen Zeichen im Bereich überein.
[^class] Entspricht jedem einzelnen Zeichen, das nicht der Klasse entspricht.
[!class] Negiert die Klasse.

Vorhandene Tag-Aufbewahrungsregel aktualisieren

Wenn Sie eine vorhandene Regel ändern möchten, verwenden Sie das Menü Aktion neben der Regel, um sie zu deaktivieren, zu bearbeiten oder zu löschen.

So ändern Sie vorhandene Tag-Aufbewahrungsregeln über die Harbor-Konsole:

  1. Melden Sie sich mit einem Konto mit Projektadministratorberechtigungen in der Harbor-Oberfläche an.
  2. Rufen Sie Projekte auf und wählen Sie ein Projekt aus.
  3. Klicken Sie im Projektfenster auf den Tab Richtlinie und dann auf Tag Retention (Tag-Aufbewahrung).

  4. Wenn Sie eine vorhandene Regel ändern möchten, wählen Sie im Menü Aktion eine der folgenden Optionen aus:

    • Deaktivieren: Die Regel wird deaktiviert. Sie können diese Regel später wieder aktivieren.
    • Bearbeiten: Aktualisieren Sie die Einstellungen einer vorhandenen Regel.
    • Löschen: Die Regel wird vollständig entfernt.