helm/helm-2to3
Được TopGit lập chỉ mục từ metadata GitHub: helm/helm-2to3 có 491 sao, viết chủ yếu bằng Go. ⚠️(OBSOLETE) This is a Helm v3 plugin which migrates and cleans up Helm v2 configuration and releases in-place to Helm v3
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Snapshot
Cộng tác viên hàng đầu
Xem cộng tác viên hàng đầu
| This project is no longer supported. |
|---|
Helm 2to3 Plugin

Helm v3 plugin which migrates and cleans up Helm v2 configuration and releases in-place to Helm v3
⚠️ Deprecation and Archive Notice
The 2to3 plugin is deprecated and no longer supported. Helm 3 was released in November 2019 and Helm 2 became unsupported in November 2020. It would be expected that all users should be migrated to Helm 3 by this time. Therefore, the plugin has now been deprecated by the maintainers.
Overview
One of the most important aspects of upgrading to a new major release of Helm is the
migration of data. This is especially true of Helm v2 to v3 considering the architectural
changes between the releases. The 2to3 plugin helps with this migration by supporting:
- Migration of Helm v2 configuration.
- Migration of Helm v2 releases.
- Clean up Helm v2 configuration, release data and Tiller deployment.
Readme before migration
WARNING: All data migrations carry a level of risk. Helm v2 migration is no different. You should be aware of any risks specific to your environment and prepare a data migration strategy for your needs.
Here are some suggestions to mitigate against potential risks during migration:
- Perform a data backup of the following:
- Helm v2 home folder.
- Release data from the cluster. Refer to How Helm Uses ConfigMaps to Store Data for details on how Helm v2 store release data in the cluster. This should apply similarly if Helm v2 is configured for secrets.
- Avoid performing operations with Helm v3 until data migration is complete and you are satisfied that it is working as expected. Otherwise, Helm v3 data might be overwritten. The operations to avoid are chart install, adding repositories, plugin install etc.
- The recommended data migration path is as follows:
- Backup v2 data, as suggested above.
- Migrate Helm v2 configuration.
- Migrate Helm v2 releases.
- When happy that Helm v3 is managing Helm v2 data as expected, then clean up Helm v2 data.
Note:: Only use the plugin to do clean up. Using
helm,kubectlor other tools could lead to data loss and an indeterminate state for the release(s).
Note: A Helm v2 client:
- can manage 1 to many Kubernetes clusters.
- can connect to 1 to many Tiller instances for a cluster.
This means that you have to cognisant of this when migrating as releases are deployed into clusters by Tiller and its namespace. You have to therefore be aware of migrating for each cluster and each Tiller instance that is managed by the Helm v2 client instance. Clean up should only be run once all migration for a Helm v2 client is complete.
Prerequisite
- Helm v2 client installed on a system which manages releases on one to many clusters
- Helm v3 client with
2to3plugin installed on the same system - Access to the cluster(s) that Helm v2 client is managing and which Helm v3 will manage after migration. This access is similar to
kubectlaccess using kubeconfig files. The--kubeconfigand--kube-contextflags can be used with theconvertandcleanupcommands to set the kubeconfig path and context to override the environment configuration. - Access to the
tillernamespace for required RBAC roles. IfTillerlesssetup, then a service account with the proper cluster wide RBAC roles will need to be used. If not used,forbiddenerrors will be thrown when trying to access restricted resources.- The plugin requires these RBAC resource permissions at the least. Additional resources might be needed depending on your environment setup
apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: <your-helm-cluster-role-name> rules: - apiGroups: - "" resources: - pods verbs: - list - get - apiGroups: - "" resources: - configmaps verbs: - list - get - delete
- The plugin requires these RBAC resource permissions at the least. Additional resources might be needed depending on your environment setup
Recommended Prior to Migration
This is a list of recommendations prior to migration:
- Latest Helm v2 version.
- Latest Helm v3 version.
- Update Helm v2 releases to supported Kubernetes APIs prior to migrating. Check out Deprecated Kubernetes APIs docs and Helm mapkubeapis plugin for more details.
- Upgrade Kubernetes clusters to supported versions.
Install
Based on the version in plugin.yaml, release binary will be downloaded from GitHub:
$ helm plugin install https://github.com/helm/helm-2to3.git
Downloading and installing helm-2to3 v0.1.3 ...
https://github.com/helm/helm-2to3/releases/download/v0.1.3/helm-2to3_0.1.3_darwin_amd64.tar.gz
Installed plugin: 2to3
For Windows (using WSL)
Helm's plugin install hook system relies on /bin/sh, regardless of the operating system present. Windows users can work around this by using Helm under WSL.
$ wget https://get.helm.sh/helm-v3.0.0-linux-amd64.tar.gz
$ tar xzf helm-v3.0.0-linux-amd64.tar.gz
$ ./linux-amd64/helm plugin install https://github.com/helm/helm-2to3
Usage
Migrate Helm v2 configuration
Migrate Helm v2 configuration in-place to Helm v3:
$ helm 2to3 move config [flags]
Flags:
--dry-run simulate a command
--skip-confirmation if set, skips confirmation message before performing move
-h, --help help for move
It will migrate:
- Chart starters
- Repositories
- Plugins
Note:
- The
move configcommand will create the Helm v3 config and data folders if they don't exist, and will override therepositories.yamlfile if it does exist. - For migration it uses default Helm v2 home and v3 config and data folders. To override those folders you need to set environment variables
HELM_V2_HOME,HELM_V3_CONFIGandHELM_V3_DATA:
$ export HELM_V2_HOME=$PWD/.helm2
$ export HELM_V3_CONFIG=$PWD/.helm3
$ export HELM_V3_DATA=$PWD/.helm3
$ helm 2to3 move config
Readme after configuration migration
- After running the command, check that all Helm v2 plugins work fine with the Helm v3. If any issue with a plugin, remove it (
<helm3> plugin remove) and re-add (<helm3> plugin install) it as required. - The repository file
repositories.yamlis copied to Helm v3 which contains references to repositories added in Helm v2. Local respoitories are not copied to Helm v3. You should remove all local repositories from Helm v3 using<helm3> repo removeand re-add where necessary using<helm3> repo add. This is a necessary refresh to align references for Helm v3. - When you are happy with your repository list, update the Helm v3 repo
<helm3> repo update. This cleans up any Helm v2 cache references from Helm v3.
Migrate Helm v2 releases
Migrate Helm v2 releases in-place to Helm v3
$ helm 2to3 convert [flags] RELEASE
Flags:
--delete-v2-releases v2 release versions are deleted after migration. By default, the v2 release versions are retained
--dry-run simulate a command
-h, --help help for convert
--ignore-already-migrated Ignore any already migrated release versions and continue migrating
--kube-context string name of the kubeconfig context to use
--kubeconfig string path to the kubeconfig file
-l, --label string label to select Tiller resources by (default "OWNER=TILLER")
-s, --release-storage string v2 release storage type/object. It can be 'secrets' or 'configmaps'. This is only used with the 'tiller-out-cluster' flag (default "secrets")
--release-versions-max int limit the maximum number of versions converted per release. Use 0 for no limit (default 10)
-t, --tiller-ns string namespace of Tiller (default "kube-system")
--tiller-out-cluster when Tiller is not running in the cluster e.g. Tillerless
Note: There is a limit set on the number of versions/revisions of a release that are converted. It is defaulted to 10 but can be configured with the --release-versions-max flag.
When the limit set is less that the actual number of versions then only the latest release versions up to the limit will be converted. Older release versions with not be converted.
If --delete-v2-releases is set, these older versions will remain in Helm v2 storage but will no longer be visible to Helm v2 commands like helm list. Clean up
will remove them from storage.
Clean up Helm v2 data
Clean up Helm v2 configuration, release data and Tiller deployment:
$ helm 2to3 cleanup [flags]
Flags:
--config-cleanup if set, configuration cleanup performed
--dry-run simulate a command
-h, --help help for cleanup
--kube-context string name of the kubeconfig context to use
--kubeconfig string path to the kubeconfig file
-l, --label string label to select Tiller resources by (default "OWNER=TILLER")
--name string the release name. When it is specified, the named release and its versions will be removed only. Should not be used with other cleanup operations
--release-cleanup if set, release data cleanup performed
-s, --release-storage string v2 release storage type/object. It can be 'secrets' or 'configmaps'. This is only used with the 'tiller-out-cluster' flag (default "secrets")
--skip-confirmation if set, skips confirmation message before performing cleanup
--tiller-cleanup if set, Tiller cleanup performed
-t, --tiller-ns string namespace of Tiller (default "kube-system")
--tiller-out-cluster when Tiller is not running in the cluster e.g. Tillerless
A full clean will remove the:
- Configuration (Helm home directory)
- v2 release data
- Tiller deployment
Note: Before performing a full or release data clean, remove any Helm v2 releases which have not been migrated to Helm v3 and are unwanted. They can be removed using the Helm v2 delete command. If they are not removed before clean up of the v2 release data then the Kubernetes resources deployed by the Helm release will remain in your cluster. In other words, the resources will be 'orphaned' without any Helm release associated.
Cleanup of individual parts can be performed using the following flags:
--config-cleanupfor configuration--release-cleanupfor v2 release data--tiller-cleanupfor Tiller deployment--namefor a release and its versions. This is a singular operation and is not to be used with the other cleanup operations.
If none of these flags are set, then full cleanup is performed.
The cleanup uses the default Helm v2 home folder.
To override this folder you need to set the environment variable HELM_V2_HOME:
$ export HELM_V2_HOME=$PWD/.helm2
$ helm 2to3 cleanup
Warning: The full cleanup command will remove the Helm v2 Configuration, Release Data and Tiller Deployment.
It cleans up all releases managed by Helm v2. It will not be possible to restore them if you haven't made a backup of the releases.
Helm v2 will not be usable afterwards. Full cleanup should only be run once all migration (clusters and Tiller instances) for a Helm v2 client instance is complete.
Helm v2 may also become unusable depending on cleanup of individual parts.
Troubleshooting
Q. I get an error when I try to do a chart dependency update in Helm v3 after configuration migration
Error might be similar to the following:
$ helm dep update chrt-1/
Hang tight while we grab the latest from your chart repositories...
...Unable to get an update from the "local" chart repository (http://127.0.0.1:8879/charts):
Get http://127.0.0.1:8879/charts/index.yaml: dial tcp 127.0.0.1:8879: connect: connection refused
...Successfully got an update from the "stable" chart repository
Update Complete. ⎈Happy Helming!⎈
Error: open /home/usr1/.cache/helm/repository/local-index.yaml: no such file or directory
A. Local respoitories are not copied to Helm v3. You therefore need to remove all local repositories from Helm v3 using <helm3> repo remove and re-add where
required using <helm3> repo add. This is a necessary refresh to align references for Helm v3 and remove the conflict. It is worthwhile to also refresh the
repository list afterwards: <helm3> repo update. You should then be able to run the chart dependency update command successfully.
Q. I get an error when I try to do a helm upgrade in Helm v3 after migration
Error might be similar to the following:
$ helm upgrade nginx bitnami/nginx
Error: failed to download "bitnami/nginx" (hint: running `helm repo update` may help)
A. This can happen when there are conflicts in the local repository list that Helm v3 cannot resolve. This can be fixed by running the helm repo update command.
Frequently Asked Questions
Q. How do you perform Helm v2 release migration as a batch operation?
A. You can perform batch migration of releases using a command as follows:
$ kubectl get [configmap|secret] -n <tiller_namespace> \
-l "OWNER=TILLER" | awk '{print $1}' | grep -v NAME | cut -d '.' -f1 | uniq | xargs -n1 helm 2to3 convert
An example of migrating releases which are stored as ConfigMaps in Tiller namespace kube-system:
$ kubectl get configmap -n kube-system -l "OWNER=TILLER" \
| awk '{print $1}' | grep -v NAME | cut -d '.' -f1 | uniq | xargs -n1 helm 2to3 convert
Developer (From Source) Install
If you would like to handle the build yourself, this is the recommended way to do it.
You must first have Go v1.22 installed, and then you run:
$ git clone [email protected]:helm/helm-2to3.git
$ cd helm-2to3
$ make build
$ export HELM_LINTER_PLUGIN_NO_INSTALL_HOOK=true
$ helm plugin install <your_path>/helm-2to3
That last command will use the binary that you built.
Repo liên quan
Helm is the standard way to package and deploy applications to Kubernetes clusters — think apt for containers. It wraps your YAML manifests into Charts, which bundle a Chart.yaml metadata file with Kubernetes templates that Helm renders and pushes directly to the cluster API. The release management side is what separates it from raw kubectl apply: you can upgrade, roll back, and track exactly what changed between versions, which matters enormously when you're debugging a production incident. The v4 mainline is where active development lives, while v3 is in extended support until late 2026, so most shops are either already on v4 or have a runway to migrate. Installation is trivial — a single binary you drop on your PATH, available through every package manager worth mentioning. The ecosystem is enormous: Artifact Hub surfaces thousands of community-maintained Charts for nearly every piece of infrastructure you might need. The catch is that writing good Charts from scratch requires learning the template syntax and Helm's values injection system, which has a real learning curve, and debugging a bad render is not fun when you just wanted to understand why your Deployment isn't picking up the right image tag.
D3.js comments on Hacker News and GitHub disagree on whether the library is hard, or only its reputation. What the 113,895-star repo's evidence shows.
The System Design Primer is donnemartin's GitHub collection for learning large-scale system design and preparing for the system design interview. It combines topic explainers, a four-step interview framework, worked case studies, and Anki flashcards into one repository.
Oh My Zsh is an open-source framework built by its community to manage Zsh configuration, hosted at ohmyzsh/ohmyzsh. It bundles a large plugin collection (300+) and a wide selection of themes (140+) behind one install script, adds a background update checker, and ships under the MIT license.
Trả lời nhanh
Đọc thêm về helm/helm-2to3 ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/helm/helm-2to3 là nguồn chính thức.
helm/helm-2to3 có bao nhiêu sao?
helm/helm-2to3 có 491 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/helm/helm-2to3. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
helm/helm-2to3 có phải mã nguồn mở không?
Có — helm/helm-2to3 phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/helm/helm-2to3.
helm/helm-2to3 còn đang phát triển không?
Commit gần nhất trên helm/helm-2to3 là 2.3 năm trước (theo timestamp GitHub). Repo có 80 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
helm/helm-2to3 là gì?
helm/helm-2to3 (helm/helm-2to3) là dự án Go trên GitHub. Theo mô tả gốc: ⚠️(OBSOLETE) This is a Helm v3 plugin which migrates and cleans up Helm v2 configuration and releases in-place to Helm v3
helm/helm-2to3 so với các dự án UI / UX khác thế nào?
helm/helm-2to3 được TopGit xếp vào nhóm UI / UX, với 491 sao GitHub và viết bằng Go. Xem trang chủ đề UI / UX trên TopGit để so sánh với các dự án tương tự theo số sao và mức độ hoạt động.
Đọc đầy đủ README ở tab phía trên.
Muốn nghe thêm một ý kiến về helm-2to3?
Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về helm-2to3.