christopherfriedrich/vendir

Easy way to vendor portions of git repos, github releases, helm charts, docker image contents, etc. declaratively

vendir

• Website: https://carvel.dev/vendir
• Slack: #carvel in Kubernetes slack
• Docs with example workflow and other details
• Install: Grab prebuilt binaries from the Releases page or Homebrew Carvel tap
• Backlog: See what we're up to.

vendir allows you to declaratively state what should be in a directory. It can be used for vendoring software.

$ vendir sync # from a directory that contains vendir.yml

Features:

• Various sources
  • pull Git repositories (examples/git, semver tag resolution in examples/versionselection)
    • including tag semver selection, GPG verification
  • pull Github releases (examples/github-release, semver tag resolution in examples/versionselection)
  • pull HTTP asset (examples/http)
  • pull Docker image contents (examples/image)
  • pull Helm chart contents (examples/helm-chart)
  • ...let us know sources you'd like to see
• Keep only particular portions of pulled content via includePaths/excludePaths or newRootPath
• Override specific directory with a local directory source for quick development
• State which directories are manually managed
• Specify inline content for a directory
• Generates lock file
• Keep common legal files (LICENSE, etc.)

See all examples.

Join the Community and Make Carvel Better

Carvel is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings. Details can be found on our Carvel website.

You can chat with us on Kubernetes Slack in the #carvel channel and follow us on Twitter at @carvel_dev.

Check out which organizations are using and contributing to Carvel: Adopter's list