{"id":13646102,"url":"https://github.com/helm/helm-2to3","last_synced_at":"2025-10-02T06:32:28.510Z","repository":{"id":41390213,"uuid":"200926208","full_name":"helm/helm-2to3","owner":"helm","description":"⚠️(OBSOLETE) This is a Helm v3 plugin which migrates and cleans up Helm v2 configuration and releases in-place to Helm v3","archived":true,"fork":false,"pushed_at":"2024-07-17T16:27:24.000Z","size":593,"stargazers_count":492,"open_issues_count":0,"forks_count":82,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-09-20T23:59:05.699Z","etag":null,"topics":["chart","cncf","helm","helm-plugin","helm3","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/helm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","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":"2019-08-06T21:22:20.000Z","updated_at":"2025-08-03T14:56:04.000Z","dependencies_parsed_at":"2023-02-10T11:15:42.866Z","dependency_job_id":"79c1028c-27a0-4ec5-972f-9a48302abadf","html_url":"https://github.com/helm/helm-2to3","commit_stats":{"total_commits":127,"total_committers":26,"mean_commits":4.884615384615385,"dds":0.5984251968503937,"last_synced_commit":"3f57c50a2583d8c6a427dadd9c6856c604a736c7"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/helm/helm-2to3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helm%2Fhelm-2to3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helm%2Fhelm-2to3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helm%2Fhelm-2to3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helm%2Fhelm-2to3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helm","download_url":"https://codeload.github.com/helm/helm-2to3/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helm%2Fhelm-2to3/sbom","scorecard":{"id":460560,"data":{"date":"2025-08-11","repo":{"name":"github.com/helm/helm-2to3","commit":"199182621ee65d5c2e464fb4cf17981986a61c8b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.5,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":6,"reason":"Found 5/8 approved changesets -- score normalized to 6","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.11.0 not signed: https://api.github.com/repos/helm/helm-2to3/releases/165516089","Warn: release artifact v0.10.3 not signed: https://api.github.com/repos/helm/helm-2to3/releases/76591452","Warn: release artifact v0.10.2 not signed: https://api.github.com/repos/helm/helm-2to3/releases/74737466","Warn: release artifact v0.10.1 not signed: https://api.github.com/repos/helm/helm-2to3/releases/71062066","Warn: release artifact v0.10.0 not signed: https://api.github.com/repos/helm/helm-2to3/releases/58909188","Warn: release artifact v0.11.0 does not have provenance: https://api.github.com/repos/helm/helm-2to3/releases/165516089","Warn: release artifact v0.10.3 does not have provenance: https://api.github.com/repos/helm/helm-2to3/releases/76591452","Warn: release artifact v0.10.2 does not have provenance: https://api.github.com/repos/helm/helm-2to3/releases/74737466","Warn: release artifact v0.10.1 does not have provenance: https://api.github.com/repos/helm/helm-2to3/releases/71062066","Warn: release artifact v0.10.0 does not have provenance: https://api.github.com/repos/helm/helm-2to3/releases/58909188"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"14 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2025-3528 / GHSA-265r-hfxg-fhmg","Warn: Project is vulnerable to: GO-2024-3005 / GHSA-v23v-6jw2-98fq","Warn: Project is vulnerable to: GO-2025-3829 / GHSA-4vq8-7jfc-9cvp","Warn: Project is vulnerable to: GO-2024-3321 / GHSA-v778-237x-gjrc","Warn: Project is vulnerable to: GO-2025-3487 / GHSA-hcg3-q754-cr77","Warn: Project is vulnerable to: GO-2024-3333","Warn: Project is vulnerable to: GO-2025-3503 / GHSA-qxp5-gwg8-xv66","Warn: Project is vulnerable to: GO-2025-3595 / GHSA-vvgc-356p-c3xw","Warn: Project is vulnerable to: GO-2025-3488 / GHSA-6v2p-p543-phr9","Warn: Project is vulnerable to: GO-2025-3601 / GHSA-4hfp-h4cw-hj8p","Warn: Project is vulnerable to: GO-2025-3602 / GHSA-5xqw-8hwv-wg92","Warn: Project is vulnerable to: GO-2025-3802 / GHSA-557j-xg8c-q2mm","Warn: Project is vulnerable to: GHSA-9h84-qmv7-982p","Warn: Project is vulnerable to: GHSA-f9f8-9pmf-xv68"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T11:01:46.717Z","repository_id":41390213,"created_at":"2025-08-19T11:01:46.718Z","updated_at":"2025-08-19T11:01:46.718Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277968828,"owners_count":25907418,"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","status":"online","status_checked_at":"2025-10-02T02:00:08.890Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["chart","cncf","helm","helm-plugin","helm3","kubernetes"],"created_at":"2024-08-02T01:02:48.470Z","updated_at":"2025-10-02T06:32:28.244Z","avatar_url":"https://github.com/helm.png","language":"Go","funding_links":[],"categories":["kubernetes","Go"],"sub_categories":[],"readme":"|![](https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Warning.svg/156px-Warning.svg.png) | This project is no longer supported.\n|---|---|\n\n# Helm 2to3 Plugin\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Go Report Card](https://goreportcard.com/badge/github.com/helm/helm-2to3)](https://goreportcard.com/report/github.com/helm/helm-2to3)\n[![CircleCI](https://circleci.com/gh/helm/helm-2to3/tree/main.svg?style=svg)](https://circleci.com/gh/helm/helm-2to3/tree/main)\n[![Release](https://img.shields.io/github/release/helm/helm-2to3.svg?style=flat-square)](https://github.com/helm/helm-2to3/releases/latest)\n\n![diagram](./helm-2to3.png)\n\n**Helm v3 plugin which migrates and cleans up Helm v2 configuration and releases in-place to Helm v3**\n\n## ⚠️ Deprecation and Archive Notice\n\nThe `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.\n\n## Overview\n\nOne of the most important aspects of upgrading to a new major release of Helm is the\nmigration of data. This is especially true of Helm v2 to v3 considering the architectural\nchanges between the releases. The `2to3` plugin helps with this migration by supporting:\n\n- Migration of [Helm v2 configuration](#migrate-helm-v2-configuration).\n- Migration of [Helm v2 releases](#migrate-helm-v2-releases).\n- [Clean up](#clean-up-helm-v2-data) Helm v2 configuration, release data and Tiller deployment.\n\n## Readme before migration\n\n***WARNING:*** All data migrations carry a level of risk. Helm v2 migration is no different.\nYou should be aware of any risks specific to your environment and prepare a data migration\nstrategy for your needs.\n\nHere are some suggestions to mitigate against potential risks during migration:\n\n- Perform a data backup of the following:\n  - Helm v2 home folder.\n  - Release data from the cluster. Refer to [How Helm Uses ConfigMaps to Store Data](http://technosophos.com/2017/03/23/how-helm-uses-configmaps-to-store-data.html)\n  for details on how Helm v2 store release data in the cluster. This should apply\n  similarly if Helm v2 is configured for secrets.\n- Avoid performing operations with Helm v3 until data migration is complete and you are\n  satisfied that it is working as expected. Otherwise, Helm v3 data might be overwritten.\n  The operations to avoid are chart install, adding repositories, plugin install etc.\n- The recommended data migration path is as follows:\n  1. Backup v2 data, as suggested above.\n  2. Migrate [Helm v2 configuration](#migrate-helm-v2-configuration).\n  3. Migrate [Helm v2 releases](#migrate-helm-v2-releases).\n  4. When happy that Helm v3 is managing Helm v2 data as expected, then [clean up](#clean-up-helm-v2-data) Helm v2 data.\n     *Note:*: Only use the plugin to do clean up. Using `helm`, `kubectl` or other tools could lead to data loss and an indeterminate\n      state for the release(s).\n\n**Note:**\nA Helm v2 client:\n\n- can manage 1 to many Kubernetes clusters.\n- can connect to 1 to many Tiller instances for  a cluster.\n\nThis means that you have to cognisant of this when migrating as releases are deployed into clusters by Tiller and\nits namespace. You have to therefore be aware of migrating for each cluster and each Tiller instance that is managed\nby the Helm v2 client instance. [Clean up](#clean-up-helm-v2-data) should only be run once all migration for a Helm v2 client is complete.\n\n## Prerequisite\n\n- Helm v2 client installed on a system which manages releases on one to many clusters\n- Helm v3 client with `2to3` plugin installed on the same system\n- Access to the cluster(s) that Helm v2 client is managing and which Helm v3 will manage after migration. This access is similar to `kubectl` access using [kubeconfig files](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/).\n  The `--kubeconfig` and `--kube-context` flags can be used with the `convert` and `cleanup` commands to set the kubeconfig path and context to override the environment configuration.\n- Access to the `tiller` namespace for required RBAC roles. If `Tillerless` setup, then a service account with the proper cluster wide RBAC roles will need to be used. If not used, `forbidden` errors will be thrown when trying to access restricted resources.\n  - The plugin requires these RBAC resource permissions at the least. Additional resources might be needed depending on your environment setup\n    ```yaml\n    apiVersion: rbac.authorization.k8s.io/v1\n    kind: ClusterRole\n    metadata:\n      name: \u003cyour-helm-cluster-role-name\u003e\n    rules:\n    - apiGroups:\n        - \"\"\n      resources:\n        - pods\n      verbs:\n        - list\n        - get\n    - apiGroups:\n        - \"\"\n      resources:\n        - configmaps\n      verbs:\n        - list\n        - get\n        - delete\n    ```\n\n## Recommended Prior to Migration\n\nThis is a list of recommendations prior to migration:\n\n- [Latest](https://github.com/helm/helm/releases/tag/v2.17.0) Helm v2 version.\n- [Latest](https://github.com/helm/helm/releases) Helm v3 version.\n- Update Helm v2 releases to supported Kubernetes APIs prior to migrating. Check out [Deprecated Kubernetes APIs](https://v2.helm.sh/docs/using_helm/#deprecated-kubernetes-apis) docs and Helm [mapkubeapis plugin](https://github.com/hickeyma/helm-mapkubeapis) for more details.\n- Upgrade Kubernetes clusters to [supported versions](https://kubernetes.io/docs/setup/release/version-skew-policy/).\n\n## Install\n\nBased on the version in `plugin.yaml`, release binary will be downloaded from GitHub:\n\n```console\n$ helm plugin install https://github.com/helm/helm-2to3.git\nDownloading and installing helm-2to3 v0.1.3 ...\nhttps://github.com/helm/helm-2to3/releases/download/v0.1.3/helm-2to3_0.1.3_darwin_amd64.tar.gz\nInstalled plugin: 2to3\n```\n\n### For Windows (using WSL)\n\nHelm'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](https://docs.microsoft.com/en-us/windows/wsl/install-win10).\n\n```console\n$ wget https://get.helm.sh/helm-v3.0.0-linux-amd64.tar.gz\n$ tar xzf helm-v3.0.0-linux-amd64.tar.gz\n$ ./linux-amd64/helm plugin install https://github.com/helm/helm-2to3\n```\n\n## Usage\n\n### Migrate Helm v2 configuration\n\nMigrate Helm v2 configuration in-place to Helm v3:\n\n```console\n$ helm 2to3 move config [flags]\n\nFlags:\n\n      --dry-run  simulate a command\n      --skip-confirmation   if set, skips confirmation message before performing move\n  -h, --help     help for move\n```\n\nIt will migrate:\n\n- Chart starters\n- Repositories\n- Plugins\n\n**Note:**\n\n- The `move config` command will create the Helm v3 config and data folders if they don't exist, and will override the `repositories.yaml` file if it does exist.\n- For migration it uses default Helm v2 home and v3 config and data folders. To override those folders you need to set environment variables\n`HELM_V2_HOME`, `HELM_V3_CONFIG` and `HELM_V3_DATA`:\n\n```console\n$ export HELM_V2_HOME=$PWD/.helm2\n$ export HELM_V3_CONFIG=$PWD/.helm3\n$ export HELM_V3_DATA=$PWD/.helm3\n$ helm 2to3 move config\n```\n\n#### Readme after configuration migration\n\n- After running the command, check that all Helm v2 plugins work fine with the Helm v3. If any issue with a plugin, remove it (`\u003chelm3\u003e plugin remove`) and\nre-add (`\u003chelm3\u003e plugin install`) it as required.\n- The repository file `repositories.yaml` is copied to Helm v3 which contains references to repositories added in Helm v2. Local respoitories are not copied to Helm v3.\nYou should remove all local repositories from Helm v3 using `\u003chelm3\u003e repo remove` and re-add where necessary using `\u003chelm3\u003e repo add`. This is a necessary refresh to align references\nfor Helm v3.\n- When you are happy with your repository list, update the Helm v3 repo `\u003chelm3\u003e repo update`. This cleans up any Helm v2 cache references from Helm v3.\n\n### Migrate Helm v2 releases\n\nMigrate Helm v2 releases in-place to Helm v3\n\n```console\n$ helm 2to3 convert [flags] RELEASE\n\nFlags:\n\n      --delete-v2-releases         v2 release versions are deleted after migration. By default, the v2 release versions are retained\n      --dry-run                    simulate a command\n  -h, --help                       help for convert\n      --ignore-already-migrated    Ignore any already migrated release versions and continue migrating\n      --kube-context string        name of the kubeconfig context to use\n      --kubeconfig string          path to the kubeconfig file\n  -l, --label string               label to select Tiller resources by (default \"OWNER=TILLER\")\n  -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\")\n      --release-versions-max int   limit the maximum number of versions converted per release. Use 0 for no limit (default 10)\n  -t, --tiller-ns string           namespace of Tiller (default \"kube-system\")\n      --tiller-out-cluster         when  Tiller is not running in the cluster e.g. Tillerless\n```\n\n**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.\nWhen 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.\nIf `--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](#clean-up-helm-v2-data)\nwill remove them from storage.\n\n### Clean up Helm v2 data\n\nClean up Helm v2 configuration, release data and Tiller deployment:\n\n```console\n$ helm 2to3 cleanup [flags]\n\nFlags:\n\n      --config-cleanup           if set, configuration cleanup performed\n      --dry-run                  simulate a command\n  -h, --help                     help for cleanup\n      --kube-context string      name of the kubeconfig context to use\n      --kubeconfig string        path to the kubeconfig file\n  -l, --label string             label to select Tiller resources by (default \"OWNER=TILLER\")\n      --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\n      --release-cleanup          if set, release data cleanup performed\n  -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\")\n      --skip-confirmation        if set, skips confirmation message before performing cleanup\n      --tiller-cleanup           if set, Tiller cleanup performed\n  -t, --tiller-ns string         namespace of Tiller (default \"kube-system\")\n      --tiller-out-cluster       when  Tiller is not running in the cluster e.g. Tillerless\n```\n\nA full clean will remove the:\n\n- Configuration (Helm home directory)\n- v2 release data\n- Tiller deployment\n\n**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.\n\nCleanup of individual parts can be performed using the following flags:\n\n- `--config-cleanup` for configuration\n- `--release-cleanup` for v2 release data\n- `--tiller-cleanup` for Tiller deployment\n- `--name` for a release and its versions. This is a singular operation and is not to be used with the other cleanup operations.\n\nIf none of these flags are set, then full cleanup is performed.\n\nThe cleanup uses the default Helm v2 home folder.\nTo override this folder you need to set the environment variable `HELM_V2_HOME`:\n\n```console\n$ export HELM_V2_HOME=$PWD/.helm2\n$ helm 2to3 cleanup\n```\n\n**Warning:** The full `cleanup`  command will remove the Helm v2 Configuration, Release Data and Tiller Deployment.\nIt 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.\nHelm 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.\nHelm v2 may also become unusable depending on cleanup of individual parts.\n\n## Troubleshooting\n\n***Q. I get an error when I try to do a chart dependency update in Helm v3 after configuration migration***\n\nError might be similar to the following:\n\n```console\n$ helm dep update chrt-1/\nHang tight while we grab the latest from your chart repositories...\n...Unable to get an update from the \"local\" chart repository (http://127.0.0.1:8879/charts):\nGet http://127.0.0.1:8879/charts/index.yaml: dial tcp 127.0.0.1:8879: connect: connection refused\n...Successfully got an update from the \"stable\" chart repository\nUpdate Complete. ⎈Happy Helming!⎈\nError: open /home/usr1/.cache/helm/repository/local-index.yaml: no such file or directory\n```\n\nA. Local respoitories are not copied to Helm v3. You therefore need to remove all local repositories from Helm v3 using `\u003chelm3\u003e repo remove` and re-add where\nrequired using `\u003chelm3\u003e repo add`. This is a necessary refresh to align references for Helm v3 and remove the conflict. It is worthwhile to also refresh the\nrepository list afterwards: `\u003chelm3\u003e repo update`. You should then be able to run the chart dependency update command successfully.\n\n***Q. I get an error when I try to do a helm upgrade in Helm v3 after migration***\n\nError might be similar to the following:\n\n```console\n$ helm upgrade nginx bitnami/nginx\nError: failed to download \"bitnami/nginx\" (hint: running `helm repo update` may help)\n```\n\nA. 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.\n\n## Frequently Asked Questions\n\n***Q. How do you perform Helm v2 release migration as a batch operation?***\n\nA. You can perform batch migration of releases using a command as follows:\n\n```console\n$ kubectl get [configmap|secret] -n \u003ctiller_namespace\u003e \\\n -l \"OWNER=TILLER\" | awk '{print $1}' | grep -v NAME | cut -d '.' -f1 | uniq | xargs -n1 helm 2to3 convert\n```\n\nAn example of migrating releases which are stored as ConfigMaps in Tiller namespace `kube-system`:\n\n```console\n$ kubectl get configmap -n kube-system -l \"OWNER=TILLER\" \\\n | awk '{print $1}' | grep -v NAME | cut -d '.' -f1 | uniq | xargs -n1 helm 2to3 convert\n```\n\n## Developer (From Source) Install\n\nIf you would like to handle the build yourself, this is the recommended way to do it.\n\nYou must first have [Go v1.22](http://golang.org) installed, and then you run:\n\n```console\n$ git clone git@github.com:helm/helm-2to3.git\n$ cd helm-2to3\n$ make build\n$ export HELM_LINTER_PLUGIN_NO_INSTALL_HOOK=true\n$ helm plugin install \u003cyour_path\u003e/helm-2to3\n```\n\nThat last command will use the binary that you built.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelm%2Fhelm-2to3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelm%2Fhelm-2to3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelm%2Fhelm-2to3/lists"}