Updating a lifecycle policy

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

1. See the description of the CLI command for updating policy parameters:

   $ yc container repository lifecycle-policy update --help
   

2. Change the policy parameters, such as by renaming it:

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

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

1. 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"
     }
   ]    
   

2. 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
   

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

Activate the disabled policy by running the command with the --activate flag:

$ yc container repository lifecycle-policy update crp6lg1868p3i0emkv1b --activate

id: crp6lg1868p3i0emkv1b
name: test-policy
repository_id: crp3cpm16edqql0t30s2
description: disabled lifecycle-policy for tests
status: ACTIVE
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

Disable the active policy by running the command with the --disable flag:

$ yc container repository lifecycle-policy update crp6lg1868p3i0emkv1b --disable

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

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

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

• new-name: New policy name.

  • Length — from 3 to 63 characters.
  • The name may contain lowercase Latin letters, numbers, and hyphens.
  • The first character must be a letter. The last character can't be a hyphen.

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

id: crp6lg1868p3i0emkv1b
name: new-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

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

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

• new-description: New policy description.

$ yc container repository lifecycle-policy update crp6lg1868p3i0emkv1b --new-description "new description"

id: crp6lg1868p3i0emkv1b
name: test-policy
repository_id: crp3cpm16edqql0t30s2
description: new description
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