Настройка политик жизненного цикла

Политики жизненного цикла позволяют автоматически управлять хранением и удалением артефактов в реестре. В этом руководстве приведены примеры настройки политик для различных сценариев использования.

Подготовьте облако к работеПодготовьте облако к работе

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

Пример 1: Политика для Docker-образов UbuntuПример 1: Политика для Docker-образов Ubuntu

В этом примере создается политика для управления Docker-образами с префиксом пути ubuntu.*. Политика содержит три правила:

1. Жесткое удаление всех Docker-образов без тегов старше 7 дней.
2. Мягкое удаление Docker-образов с тегами, если их количество превышает 10 (период ожидания — 7 дней).
3. Сохранение последних 5 версий образов с тегами.

Подготовьте правилаПодготовьте правила

Создайте файл ubuntu-policy-rules.json со следующим содержимым:

[
  {
    "path_prefix": "ubuntu.*",
    "delete": {
      "type": "HARD_DELETE",
      "older_than_days": 7
    },
    "docker_filters": {
      "tag_status": "UNTAGGED"
    }
  },
  {
    "path_prefix": "ubuntu.*",
    "delete": {
      "type": "SOFT_DELETE",
      "cooldown_period_days": 7,
      "version_condition": {
        "versions_count_greater_than": 10
      }
    },
    "docker_filters": {
      "tag_status": "TAGGED"
    }
  },
  {
    "path_prefix": "ubuntu.*",
    "keep_by_version": {
      "keep_versions_count": 5
    },
    "docker_filters": {
      "tag_status": "TAGGED"
    }
  }
]

1. Первое правило (HARD_DELETE) безвозвратно удаляет все Docker-образы без тегов, которые старше 7 дней. Это помогает очистить реестр от промежуточных образов, созданных в процессе сборки.

2. Второе правило (SOFT_DELETE) помечает для удаления Docker-образы с тегами, если количество Docker-образов превышает 10. Docker-образы остаются в реестре в течение 7 дней (период ожидания), после чего удаляются безвозвратно. Это позволяет сохранить историю версий, но ограничивает их количество.

3. Третье правило (keep_by_version) защищает от удаления последние 5 версий Docker-образов с тегами, даже если они попадают под условия второго правила. Это гарантирует, что всегда будут доступны последние рабочие версии.

Создайте политикуСоздайте политику

yc cloud-registry registry lifecycle-policy create \
  --name ubuntu-lifecycle-policy \
  --description "Политика для управления Docker-образами Ubuntu" \
  --registry-id <идентификатор_реестра> \
  --state DISABLED \
  --rules ubuntu-policy-rules.json

Пример 2: Политика для Java-артефактовПример 2: Политика для Java-артефактов

В этом примере создается политика для управления Java-артефактами с префиксом пути com/example/myapp/.*. Политика содержит два правила:

1. Жесткое удаление всех снапшотов.
2. Сохранение последних 2 снапшотов.

Подготовьте правилаПодготовьте правила

Создайте файл maven-policy-rules.json со следующим содержимым:

[
  {
    "path_prefix": "com/example/myapp/.*",
    "delete": {
      "type": "HARD_DELETE",
      "always": true
    },
    "maven_filters": {
      "version_type": "SNAPSHOT"
    }
  },
  {
    "path_prefix": "com/example/myapp/.*",
    "keep_by_version": {
      "keep_versions_count": 2
    },
    "maven_filters": {
      "version_type": "SNAPSHOT"
    }
  }
]

1. Первое правило (HARD_DELETE) удаляет все снапшоты Java-артефактов, соответствующих префиксу пути. Это помогает автоматически очищать реестр от устаревших снапшотов, которые обычно используются только для разработки и тестирования.

2. Второе правило (keep_by_version) защищает от удаления последние 2 снапшота. Это гарантирует, что разработчики всегда имеют доступ к последним собранным снапшотам, даже если они будут удалены первым правилом.

Создайте политикуСоздайте политику

yc cloud-registry registry lifecycle-policy create \
  --name maven-snapshot-policy \
  --description "Политика для управления снапшотами Java-артефактов" \
  --registry-id <идентификатор_реестра> \
  --state DISABLED \
  --rules maven-policy-rules.json

РекомендацииРекомендации

• Создавайте политики в состоянии DISABLED — это позволит проверить правила перед их применением.
• Используйте мягкое удаление (SOFT_DELETE) для важных артефактов, чтобы иметь возможность восстановить их в течение периода ожидания.
• Используйте правила сохранения (KEEP) для явной защиты артефактов от удаления — правила keep_by_version и keep_by_age имеют более высокий приоритет, чем правила удаления, и гарантируют сохранение указанных артефактов.
• Комбинируйте правила сохранения и удаления для гибкого управления артефактами.

См. такжеСм. также

• Создание политики жизненного цикла
• Политика жизненного цикла в Yandex Cloud Registry
• Реестр в Yandex Cloud Registry