{"id":13645550,"url":"https://github.com/Qovery/helm-freeze","last_synced_at":"2025-04-21T14:31:30.089Z","repository":{"id":40387484,"uuid":"290868509","full_name":"Qovery/helm-freeze","owner":"Qovery","description":"Freeze your charts in the wished versions","archived":false,"fork":false,"pushed_at":"2024-05-24T16:28:43.000Z","size":422,"stargazers_count":58,"open_issues_count":1,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-20T21:12:24.024Z","etag":null,"topics":["helm","kubernetes"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Qovery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-27T19:54:07.000Z","updated_at":"2025-03-20T14:38:31.000Z","dependencies_parsed_at":"2024-06-19T04:24:17.486Z","dependency_job_id":null,"html_url":"https://github.com/Qovery/helm-freeze","commit_stats":{"total_commits":24,"total_committers":3,"mean_commits":8.0,"dds":0.08333333333333337,"last_synced_commit":"9c2d068aae86ab801ef483c6025f700abb971955"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qovery%2Fhelm-freeze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qovery%2Fhelm-freeze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qovery%2Fhelm-freeze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qovery%2Fhelm-freeze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Qovery","download_url":"https://codeload.github.com/Qovery/helm-freeze/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250070173,"owners_count":21369839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["helm","kubernetes"],"created_at":"2024-08-02T01:02:37.119Z","updated_at":"2025-04-21T14:31:29.800Z","avatar_url":"https://github.com/Qovery.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# helm-freeze\n[![Go Report Card](https://goreportcard.com/badge/github.com/Qovery/helm-freeze)](https://goreportcard.com/report/github.com/Qovery/helm-freeze)\n[![Powered](https://img.shields.io/badge/Powered%20by-Qovery-blueviolet)](https://www.qovery.com)\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./helm_freeze_logo.png\" width=420 /\u003e\n\u003c/p\u003e\n\nFreeze your charts in the wished versions. Helm freeze helps you to declare the charts\nyou want to use in a desired version and download them locally. This to freeze/lock them\ndirectly in your Git repository.\n\nThe advantages are:\n* Follow GitOps philosophy\n* Know exactly what has changed between 2 charts version with a `git diff`\n* One place to list them all\n* Works well with monorepo\n* Declarative configuration (YAML file)\n* Supports git repositories in addition to charts repositories\n\n## Installation\n\n### Mac OS\nOn Mac, you need to have [brew](https://brew.sh/) installed, then you can run those commands:\n```bash\nbrew tap Qovery/helm-freeze\nbrew install helm-freeze\n```\n\n### Arch Linux\nAn AUR package exists called `helm-freeze`, you can install it with `yay`:\n```bash\nyay helm-freeze\n```\n\n### Others\nYou can download binaries from the [release section](https://github.com/Qovery/helm-freeze/releases).\n\n## Usage\nTo use helm-freeze, you need a configuration file. You can generate a default file like this:\n\n```shell script\nhelm-freeze init\n```\nA minimal file named `helm-freeze.yaml` will be generated. Here is an example of a more complex one:\n\n```yaml\ncharts:\n    # Chart name\n  - name: cert-manager\n    # Chart version\n    version: v1.7.0\n    # The repo to use (declared below in the repos section)\n    repo_name: jetstack\n    # No destinations is declared, the default one will be used\n    comment: \"You can add comments\"\n  - name: cert-manager\n    # Chart version\n    version: v1.8.0\n    # The repo to use (declared below in the repos section)\n    repo_name: jetstack\n    # Override the folder path\n    dest_folder_override: cert-manager-1.8\n  - name: fluent-bit\n    repo_name: lifen\n    version: 2.8.0\n    # If you temporary want to stop syncing a specific chart\n    no_sync: true\n  - name: nginx-ingress\n    # No repo_name is specified, stable will be used\n    version: 1.35.0\n    # Change the destination to another one (declared in destinations section)\n    dest: custom\n  - name: pleco\n    repo_name: git-repo\n    # When using a git repo, chart_path is mandatory, you need to specify the chart folder path\n    chart_path: /charts/pleco\n    dest: custom\n    # Set git reference\n    version: 5e05faddb0fde1f5ddd822c3d3ba72925f094e67\n\nrepos:\n    # Stable is the default one\n  - name: stable\n    url: https://charts.helm.sh/stable\n  - name: jetstack\n    url: https://charts.jetstack.io\n  - name: lifen\n    url: https://honestica.github.io/lifen-charts\n  - name: git-repo\n    url: https://github.com/Qovery/pleco.git\n    # If you want to directly use a chart folder in a git repo, set type to git\n    type: git\n\ndestinations:\n  - name: default\n    path: /my/absolute/path\n  - name: custom\n    path: ./my/relative/path\n```\n\nThen use `sync` arg to locally download the declared versions, here is an example:\n```bash\n$ helm-freeze sync\n\n[+] Adding helm repos\n -\u003e stable\n -\u003e aws\n -\u003e git-repo\n\n[+] Updating helm repos\n\n[+] Downloading charts\n -\u003e stable/nginx-ingress 1.35.0\n -\u003e stable/prometheus-operator 8.15.12\n -\u003e stable/elasticsearch-curator 2.1.5\n -\u003e aws/aws-node-termination-handler 0.8.0\n -\u003e aws/aws-vpc-cni 1.0.9\n -\u003e git/pleco 5e05faddb0fde1f5ddd822c3d3ba72925f094e67\n\nSync succeed!\n```\n\nIf you update a chart, launch `sync` and you'll be able to see the differences with `git diff`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQovery%2Fhelm-freeze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FQovery%2Fhelm-freeze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FQovery%2Fhelm-freeze/lists"}