Version: 0.7.1

.driftignore

.driftignore is a simple way to ignore resources, you put resources in a .driftignore file like a .gitignore.

If you need only to exclude a set of resources you should use .driftignore, if you need something more advanced, check filter rules.

Create the .driftignore file where you launch driftctl (usually the root of your IaC repo).

Each line must be of kind

  • resource_type.resource_id, resource_id could be a wildcard to exclude all resources of a given type.
  • resource_type.resource_id.path.to.FieldName, resource_id can be wildcard to ignore a drift on given field for a given type, path could also contain wildcards.
note

Fields are not case-sensitive.

If your resource id or the path of a field contains dot or backslash you can escape them with backslashes:

resource_type.resource\.id\.containing\.dots.path.to.dotted\.FieldName
resource_type.resource_id_containing\\backslash.path.to.backslash\\FieldName

Examples#

# Will ignore S3 bucket called my-bucket
aws_s3_bucket.my-buckey
# Will ignore every aws_instance resource
aws_instance.*
# Will ignore environment for all lambda functions
aws_lambda_function.*.Environment
# Will ignore lastModified for my-lambda-name lambda function
aws_lambda_function.my-lambda-name.LastModified