terragrunt.hcl to your projectinclude blockdependency blockTerragrunt supports a Content Addressable Store (CAS) to deduplicate content across multiple Terragrunt configurations. This feature is still experimental and not recommended for general production usage.
At the moment, the only supported use case for the CAS is to speed up catalog cloning. In the future, the CAS can be used to store more content.
To use the CAS, you will need to enable the cas experiment.
When you enable the cas experiment, Terragrunt will automatically use the CAS when cloning any compatible source (right now, only Git repositories).
# root.hcl
catalog {
urls = [
"git@github.com:acme/modules.git"
]
}
When Terragrunt clones a repository while using the CAS. If the repository is not found in the CAS, Terragrunt will clone the repository from the original URL and store it in the CAS for future use.
When generating a repository from the CAS, Terragrunt will hard link entries from the CAS to the new repository. This allows Terragrunt to deduplicate content across multiple repositories.
In the event that hard linking fails due to some operating system / host incompatibility with hard links, Terragrunt will fall back to performing copies of the content from the CAS.
The CAS is stored in the ~/.cache/terragrunt/cas directory. This directory can be safely deleted at any time, as Terragrunt will automatically regenerate the CAS as needed.
Avoid partial deletions of the CAS directory without care, as that might result in partially cloned repositories and unexpected behavior.
Install
