pulumi-aws-kotlin/com.pulumi.aws.ecr.kotlin/LifecyclePolicy

LifecyclePolicy

class LifecyclePolicy : KotlinCustomResource

Manages an ECR repository lifecycle policy.

NOTE: Only one aws.ecr.LifecyclePolicy resource can be used with the same ECR repository. To apply multiple rules, they must be combined in the policy JSON. NOTE: The AWS ECR API seems to reorder rules based on rulePriority. If you define multiple rules that are not sorted in ascending rulePriority order in the this provider code, the resource will be flagged for recreation every deployment.

Example Usage

Policy on untagged image

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.LifecyclePolicy;
import com.pulumi.aws.ecr.LifecyclePolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var foo = new Repository("foo");
        var foopolicy = new LifecyclePolicy("foopolicy", LifecyclePolicyArgs.builder()
            .repository(foo.name())
            .policy("""
{
    "rules": [
        {
            "rulePriority": 1,
            "description": "Expire images older than 14 days",
            "selection": {
                "tagStatus": "untagged",
                "countType": "sinceImagePushed",
                "countUnit": "days",
                "countNumber": 14
            },
            "action": {
                "type": "expire"
            }
        }
    ]
}
            """)
            .build());
    }
}

Policy on tagged image

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.LifecyclePolicy;
import com.pulumi.aws.ecr.LifecyclePolicyArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var foo = new Repository("foo");
        var foopolicy = new LifecyclePolicy("foopolicy", LifecyclePolicyArgs.builder()
            .repository(foo.name())
            .policy("""
{
    "rules": [
        {
            "rulePriority": 1,
            "description": "Keep last 30 images",
            "selection": {
                "tagStatus": "tagged",
                "tagPrefixList": ["v"],
                "countType": "imageCountMoreThan",
                "countNumber": 30
            },
            "action": {
                "type": "expire"
            }
        }
    ]
}
            """)
            .build());
    }
}

Import

ECR Lifecycle Policy can be imported using the name of the repository, e.g.,

$ pulumi import aws:ecr/lifecyclePolicy:LifecyclePolicy example tf-example

Properties

val id: Output<String>

policy

val policy: Output<String>

The policy document. This is a JSON formatted string. See more details about Policy Parameters in the official AWS docs.

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

registryId

val registryId: Output<String>

The registry ID where the repository was created.

repository

val repository: Output<String>

Name of the repository to apply the policy.

urn

val urn: Output<String>