Conversão um release do Helm v2 para v3

Contexto

O CCE suporta totalmente o Helm v3. Esta seção orienta você a converter um release de Helm v2 para Helm v3. Helm v3 descarta ou reconstrói algumas funções Helm v2 na camada inferior. Portanto, a conversão é arriscada até certo ponto. A simulação é necessária antes da conversão.

Para obter detalhes, consulte a documentação da comunidade.

Precauções

• Informações de release das lojas Helm v2 em ConfigMaps. Helm v3 faz isso em segredos.
• Quando você consulta, atualiza ou opera um release do Helm v2 no console do CCE, o CCE tentará converter o release para v3. Se você operar em segundo plano, converta o release seguindo as instruções abaixo.

Processo de conversão (sem usar o cliente de Helm v3)

1. Faça o download do plug-in de conversão helm 2to3 no nó do CCE.

   wget https://github.com/helm/helm-2to3/releases/download/v0.10.2/helm-2to3_0.10.2_linux_amd64.tar.gz

2. Descompacte o pacote de plug-in.

   tar -xzvf helm-2to3_0.10.2_linux_amd64.tar.gz

3. Realize a conversão simulada.

   Tome o release test-convert como exemplo. Execute o seguinte comando para simular a conversão: se as informações a seguir forem exibidas, a simulação é bem-sucedida.

   # ./2to3 convert --dry-run --tiller-out-cluster -s configmaps test-convert
   NOTE: This is in dry-run mode, the following actions will not be executed.
   Run without --dry-run to take the actions described below:
   Release "test-convert" will be converted from Helm v2 to Helm v3.
   [Helm 3] Release "test-convert" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" will be created.

4. Realize a conversão. Se as informações a seguir forem exibidas, a conversão será bem-sucedida.

   # ./2to3 convert --tiller-out-cluster -s configmaps test-convert
   Release "test-convert" will be converted from Helm v2 to Helm v3.
   [Helm 3] Release "test-convert" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" created.
   [Helm 3] Release "test-convert" created.
   Release "test-convert" was converted successfully from Helm v2 to Helm v3.
   Note: The v2 release information still remains and should be removed to avoid conflicts with the migrated v3 release.
   v2 release information should only be removed using `helm 2to3` cleanup and when all releases have been migrated over.

5. Após a conclusão da conversão, simule a liberação de recursos. Após a simulação, limpe os recursos de release de v2.

   Liberação simulada:

   # ./2to3 cleanup --dry-run --tiller-out-cluster -s configmaps --name test-convert
   NOTE: This is in dry-run mode, the following actions will not be executed.
   Run without --dry-run to take the actions described below:
   WARNING: "Release 'test-convert' Data" will be removed. 
    
   [Cleanup/confirm] Are you sure you want to cleanup Helm v2 data? [y/N]: y
   Helm v2 data will be cleaned up.
   [Helm 2] Release 'test-convert' will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" will be deleted.

   Liberação formal:

   # ./2to3 cleanup --tiller-out-cluster -s configmaps --name test-convert
   WARNING: "Release 'test-convert' Data" will be removed. 
    
   [Cleanup/confirm] Are you sure you want to cleanup Helm v2 data? [y/N]: y
   Helm v2 data will be cleaned up.
   [Helm 2] Release 'test-convert' will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" d

Processo de conversão (usando o cliente de Helm v3)

1. Instale o cliente de Helm v3. Para mais detalhes, consulte Instalar Helm v3.
2. Instale o plug-in de conversão.

   # helm plugin install https://github.com/helm/helm-2to3
   Downloading and installing helm-2to3 v0.10.2 ...
   https://github.com/helm/helm-2to3/releases/download/v0.10.2/helm-2to3_0.10.2_linux_amd64.tar.gz
   Installed plugin: 2to3

3. Verifique se o plug-in foi instalado

   # helm plugin list
   NAME VERSION DESCRIPTION                                                               
   2to3  0.10.2      migrate and cleanup Helm v2 configuration and releases in-place to Helm v3

4. Realize a conversão simulada.

   Tome o release test-convert como exemplo. Execute o seguinte comando para simular a conversão: se as informações a seguir forem exibidas, a conversão simulada será bem-sucedida.

   # helm 2to3 convert --dry-run --tiller-out-cluster -s configmaps test-convert
   NOTE: This is in dry-run mode, the following actions will not be executed.
   Run without --dry-run to take the actions described below:
   Release "test-convert" will be converted from Helm v2 to Helm v3.
   [Helm 3] Release "test-convert" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" will be created.

5. Realize a conversão. Se as informações a seguir forem exibidas, a conversão será bem-sucedida.

   # helm 2to3 convert --tiller-out-cluster -s configmaps test-convert
   Release "test-convert" will be converted from Helm v2 to Helm v3.
   [Helm 3] Release "test-convert" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" will be created.
   [Helm 3] ReleaseVersion "test-convert.v1" created.
   [Helm 3] Release "test-convert" created.
   Release "test-convert" was converted successfully from Helm v2 to Helm v3.
   Note: The v2 release information still remains and should be removed to avoid conflicts with the migrated v3 release.
   v2 release information should only be removed using `helm 2to3` cleanup and when all releases have been migrated over.

6. Após a conversão, você pode visualizar a versão convertida executando helm list.

   # helm list
   NAME                NAMESPACE    REVISION UPDATED                           STATUS      CHART              APP VERSION
   test-convert      default   1                2022-08-29 06:56:28.166918487 +0000 UTC       deployed    test-helmold-1 

7. Após a conclusão da conversão, simule a liberação de recursos. Após a simulação, limpe os recursos de release de v2.

   Liberação simulada:

   # helm 2to3 cleanup --dry-run --tiller-out-cluster -s configmaps --name test-convert
   NOTE: This is in dry-run mode, the following actions will not be executed.
   Run without --dry-run to take the actions described below:
   WARNING: "Release 'test-convert' Data" will be removed. 
    
   [Cleanup/confirm] Are you sure you want to cleanup Helm v2 data? [y/N]: y
   Helm v2 data will be cleaned up.
   [Helm 2] Release 'test-convert' will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" will be deleted.

   Liberação formal:

   # helm 2to3 cleanup --tiller-out-cluster -s configmaps --name test-convert
   WARNING: "Release 'test-convert' Data" will be removed. 
    
   [Cleanup/confirm] Are you sure you want to cleanup Helm v2 data? [y/N]: y
   Helm v2 data will be cleaned up.
   [Helm 2] Release 'test-convert' will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" will be deleted.
   [Helm 2] ReleaseVersion "test-convert.v1" deleted.
   [Helm 2] Release 'test-convert' deleted.
   Helm v2 data was cleaned up successfully.