Updating a lifecycle policy

Written by

Examples

After creating a lifecycle policy, you can update its rules, status, name, and description.

To access the policy, use its ID. For information about getting a policy ID, see Getting information about lifecycle policies.

CLI

If you don't have the Yandex.Cloud command line interface yet, install and initialize it.

See the description of the CLI command for updating policy parameters:
```
yc container repository lifecycle-policy update --help
```

Change the policy parameters, such as by renaming it:

yc container repository lifecycle-policy update crp6lg1868p3i0emkv1b --new-name new-policy

Warning

You can only set a lifecycle policy for a repository. The policy applies to Docker images whose names match the repository name exactly. There is no support for prefix matching. You can't set a policy for a repository group, registry, folder, or cloud.

Examples

Updating lifecycle policy rules

CLI

Set new policy rules and save them to a file named new-rules.json.

Example of the contents of a file with rules, where:
- description: Description of the policy rule.
- tag_regexp: Docker image tag for filtering.
- untagged: Flag indicating that the rule applies to Docker images without tags.
- expire_period: Time after which the lifecycle policy may apply to the Docker image.
  Parameter format: Number and unit of measurement s, m, h, or d (seconds, minutes, hours, or days). expire_period must be a multiple of 24 hours.
- retained_top: Number of Docker images that are not deleted even if they match the rule.
```
[
  {
    "description": "delete prod Docker images older than 60 days but retain 20 last ones",
    "tag_regexp": "prod",
    "expire_period": "60d",
    "retained_top": 20
  },
  {
    "description": "delete all test Docker images except 10 last ones",
    "tag_regexp": "test.*",
    "retained_top": 10
  },
  {
    "description": "delete all untagged Docker images older than 48 hours",
    "untagged": true,
    "expire_period": "48h"
  }
]    
```

Change the policy rules by running the command with the following parameter:

new-rules: Path to the file with the new policy description.

Alert

Updating the policy completely overwrites all current rules by destroying them.

yc container repository lifecycle-policy update crp6lg1868p3i0emkv1b --new-rules ./new-rules.json
WARN: All current lifecycle rules will be overwritten. Are you sure?[y/N] y
id: crp6lg1868p3i0emkv1b
name: test-policy
repository_id: crp3cpm16edqql0t30s2
description: disabled lifecycle-policy for tests
status: DISABLED
created_at: "2020-05-28T15:05:58.143719Z"
rules:
- description: remove prod images older than 60 days except 20 last ones
  expire_period: 5184000s
  tag_regexp: prod
  retained_top: "20"
- description: remove all test and untagged images older than 48 hours
  expire_period: 172800s
  tag_regexp: test.*
  untagged: true