Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Charts e Apps do Helm

Nesta seção, você aprenderá como gerenciar repositórios de charts do Helm e apps no Rancher.

Como os charts do Helm funcionam no Rancher

Os repositórios de charts do Helm no Rancher são gerenciados usando Apps.

O Rancher utiliza um sistema semelhante a um catálogo para importar pacotes de charts de repositórios e, em seguida, usa esses charts para implantar apps Kubernetes personalizados ou ferramentas do Rancher, como Monitoramento ou Istio. As ferramentas do Rancher vêm como repositórios pré-carregados que são implantados como charts do Helm independentes. Quaisquer repositórios adicionais são adicionados apenas ao cluster atual.

Catálogos, Apps e a UI do Rancher

xref:[Rancher v2.4 e anteriores], repositórios de apps prontos para implantação eram chamados de "catálogos". Esses repositórios eram gerenciados através da seção Catálogos da UI.

O Rancher v2.5 substituiu o antigo sistema de catálogo por um novo recurso Apps & Marketplace.

Desde o Rancher v2.6.5, o recurso Apps & Marketplace é chamado Apps na UI.

Esquema de Versionamento

O esquema de versionamento dos charts de recursos do Rancher é centrado na versão principal dos charts e na anotação +up para charts upstream, quando aplicável.

Versão Principal: As versões principais dos charts de recursos estão ligadas a versões menores específicas do Rancher. Quando você fizer upgrade para uma nova versão menor do Rancher, deve garantir que todos os seus charts de recursos também sejam atualizados para a linha de lançamento correta do chart.

Charts baseados em upstream: Ao fazer upgrade, certifique-se de que a versão do chart upstream seja compatível com a sua versão do Rancher. A anotação +up para o chart indica qual versão upstream o chart do Rancher está rastreando. Por exemplo, 100.x.x+up16.6.0 para Monitoramento rastreia o kube-prometheus-stack upstream 16.6.0 com alguns patches adicionais do Rancher.

Ao fazer upgrade de versões do Rancher, não faça downgrade da versão do chart que você está usando. Por exemplo, se você estiver usando uma versão do Monitoramento que é posterior a 16.6.0 no Rancher v2.5, você não deve fazer upgrade para 100.x.x+up16.6.0. Em vez disso, você deve fazer upgrade para a versão apropriada na próxima versão.

Versões de Pré-lançamento

Pré-lançamentos aderem à especificação definida por Versionamento Semântico 2.0.0. Por exemplo, um chart Helm com uma versão de 0.1.3-dev.12ab4f é considerado um pré-lançamento. Versões de pré-lançamento não são exibidas por padrão e devem ser configuradas para isso.

Para exibir versões de pré-lançamento:

  1. Clique no seu avatar de usuário no canto superior direito.

  2. Clique em Preferências.

  3. Em Charts Helm, selecione Incluir Versões de Pré-lançamento.

Acessar Charts

A página Charts contém todos os charts do Rancher, Parceiros e Personalizados. Você pode filtrar charts selecionando o menu suspenso mais à esquerda:

  • Ferramentas do Rancher, como Logging ou Monitoramento, estão listadas sob o rótulo Rancher.

  • Charts de Parceiros estão sob o rótulo Parceiros.

  • Charts personalizados estão listados sob o nome de seu respectivo repositório.

Todos os três tipos de charts são implantados e gerenciados da mesma forma.

Apps gerenciados pelo Cluster Manager (a visão global na interface do usuário legada do Rancher) continuam a ser gerenciados apenas pelo Cluster Manager, e apps gerenciados com Apps na nova interface devem ser gerenciados apenas por Apps.

Para acessar a página Charts:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos charts você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Charts.

Gerenciar Repositórios

A página Repositórios lista seus repositórios Helm. Isso inclui endpoints Helm tradicionais que possuem um index.yaml e repositórios Git que são clonados e apontam para um branch específico. Para usar charts personalizados, adicione seu repositório aqui. Depois de adicionar um repositório, você pode acessar charts personalizados na página Charts, listados sob o nome do repositório.

Para acessar a página Repositórios:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Repositórios.

Adicionar Repositórios Git Personalizados

Para adicionar um repositório Git personalizado que contém seus charts Helm ou definições de modelo de cluster:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Repositórios.

  4. Clique em Criar.

  5. Selecione o alvo, Repositório Git contendo gráfico Helm…​.

  6. Você deve inserir um nome e uma URL de repositório Git. Os outros campos, incluindo a descrição, são opcionais. Insira um nome de branch alternativo se você não quiser puxar de qualquer branch que o proprietário do repositório definiu como padrão. Normalmente, o branch padrão é nomeado como main ou master.

  7. Clique em Criar para adicionar o repositório.

Após adicionar um repositório de charts ao Rancher, ele se torna disponível imediatamente.

Adicionar Repositórios de Charts Helm Personalizados

Você pode adicionar seus próprios repositórios de charts Helm para fornecer pacotes de charts ao Rancher. Você pode usar qualquer servidor HTTP, desde que o servidor possa responder a solicitações GET e servir arquivos YAML e tarballs.

Para mais informações sobre repositórios de charts Helm, consulte a documentação oficial do Helm.

Para adicionar um repositório de charts Helm personalizado ao Rancher:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Repositórios.

  4. Clique em Criar.

  5. Selecione o destino, URL http(s) para um índice gerado pelo Helm.

  6. Digite um nome de repositório e o endereço URL do índice do repositório de charts.

  7. Clique em Criar para adicionar o repositório.

Adicionar Repositórios Privados de Git/Charts Helm

Você pode adicionar repositórios Git ou charts Helm privados com credenciais de chave SSH ou um segredo de autenticação básica HTTP, como um nome de usuário e senha.

Adicionar uma CA Privada aos Repositórios

Para adicionar uma CA privada aos repositórios de charts Helm, você deve adicionar uma cópia codificada em base64 do certificado CA no formato DER ao spec.caBundle field do repositório de charts, como openssl x509 -outform der -in ca.pem | base64 -w0. As instruções são as mesmas para repositórios baseados em Git e baseados em HTTP:

  1. Clique ☰. Em Explorar Cluster no menu de navegação à esquerda, selecione um cluster.

  2. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Repositórios.

  3. Encontre a linha associada ao repositório baseado em Git ou HTTP ao qual você deseja adicionar uma CA privada e clique em ⋮ > Editar YAML.

  4. Defina o valor de caBundle, como no seguinte exemplo:

    [...]
    spec:
      caBundle:
    MIIFXzCCA0egAwIBAgIUWNy8WrvSkgNzV0zdWRP79j9cVcEwDQYJKoZIhvcNAQELBQAwPzELMAkGA1UEBhMCVVMxCzAJBgNVBAgMAkNBMRQwEgYDVQQKDAtNeU9yZywgSW5jLjENMAsGA1UEAwwEcm9vdDAeFw0yMTEyMTQwODMyMTdaFw0yNDEwMDMwODMyMT
    ...
    nDxZ/tNXt/WPJr/PgEB3hQdInDWYMg7vGO0Oz00G5kWg0sJ0ZTSoA10ZwdjIdGEeKlj1NlPyAqpQ+uDnmx6DW+zqfYtLnc/g6GuLLVPamraqN+gyU8CHwAWPNjZonFN9Vpg0PIk1I2zuOc4EHifoTAXSpnjfzfyAxCaZsnTptimlPFJJqAMj+FfDArGmr4=
    [...]
Repositórios de charts Helm com autenticação

O Repo.Spec contém um valor de disableSameOriginCheck. Esse valor permite que você ignore as verificações de mesma origem, enviando as informações de autenticação do repositório como um cabeçalho de autenticação básica com todas as chamadas de API. Isso não é recomendado, mas pode ser usado como uma solução temporária em casos de repositórios de charts Helm não padrão, como aqueles que têm redirecionamentos para uma URL de origem diferente.

Para usar este recurso em um repositório de charts Helm existente, siga os passos anteriores até editar o YAML. Na parte spec do arquivo YAML, adicione disableSameOriginCheck e defina como true.

[...]
spec:
  disableSameOriginCheck: true
[...]

Adicionar Repositórios de Charts OCI Personalizados

O Helm v3 introduziu o armazenamento de Helm charts como artefatos da Iniciativa de Contêineres Abertos (OCI) em registros de contêiner. Com o Rancher v2.9.0, você pode adicionar repositórios de charts Helm baseados em OCI ao lado de repositórios baseados em HTTP e Git. Isso significa que você pode implantar apps que estão armazenados como artefatos OCI. Para mais informações, veja Usando Repositórios de Helm Chart OCI.

Compatibilidade do Helm

Apenas charts compatíveis com Helm 3 são suportados.

Atualizar Repositórios de Chart

O botão Atualizar pode ser usado para sincronizar alterações dos repositórios de Helm chart selecionados na página Repositórios.

Para atualizar um repositório de chart:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Repositórios.

  4. Use o alternador ao lado do campo Estado para selecionar todos os repositórios ou alternar repositórios de chart especificados para sincronizar alterações.

  5. Clique em Atualizar.

  6. O ⋮ no final de cada linha de repositório de chart também inclui uma opção Atualizar, que pode ser clicada para atualizar o respectivo repositório.

Instalações do Rancher não Airgap, ao atualizar, refletirão imediatamente quaisquer alterações no repositório de chart e você verá o campo Estado para repositórios atualizados mudar de In Progress para Active uma vez que a ação seja concluída.

Instalações air gap onde o Rancher está configurado para usar a cópia embalada dos charts do sistema Helm (useBundledSystemChart=true) só se referirão ao repositório chart-do-sistema que vem incluído e não poderão ser atualizados ou sincronizados.

Renovar Intervalo

O Rancher v2.10.0 adiciona o campo refreshInterval ao CRD ClusterRepo. O valor padrão é 3600 segundos, o que significa que o Rancher sincroniza cada repositório de Helm a cada 3600 segundos.

Para modificar o intervalo de atualização de um repositório de chart:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps > Repositórios.

  4. Encontre o repositório que você deseja modificar e clique em ⋮ > Editar YAML.

  5. Defina o campo refreshInterval em Spec para o valor desejado em segundos.

  6. Clique em Salvar.

Habilitar/Desabilitar Repositórios de Helm Chart

O Rancher v2.10.0 adiciona a capacidade de habilitar e desabilitar repositórios de Helm. Os repositórios de Helm estão habilitados por padrão.

Para desabilitar um repositório de chart:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps > Repositórios.

  4. Encontre o repositório que você deseja desabilitar e clique em ⋮ > Editar YAML.

  5. Defina o campo Enabled em Spec para false.

  6. Clique em Salvar.

  7. Quando você desabilita um repositório, as atualizações são desativadas e novas alterações no clusterRepo não são aplicadas.

Para habilitar um repositório de chart:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps > Repositórios.

  4. Encontre o repositório que você deseja habilitar e clique em ⋮ > Editar YAML.

  5. Defina o campo Enabled em Spec para true.

  6. Clique em Salvar.

Implantar e Atualizar Charts

Para instalar e implantar um chart:

  1. Clique em ☰ > Gerenciamento de Cluster.

  2. Encontre o nome do cluster cujos repositórios você deseja acessar. Clique em Explorar no final da linha do cluster.

  3. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Charts.

  4. Selecione um chart e clique em Instalar.

Os charts do Rancher e dos parceiros podem ter configurações extras disponíveis através de páginas personalizadas ou arquivos questions.yaml. No entanto, todas as instalações de charts podem modificar o values.yaml e outras configurações básicas. Após clicar em Instalar, um trabalho de operação do Helm é implantado e o console para o trabalho é exibido.

Para ver todas as alterações recentes, clique em Apps  Operações Recentes no menu de navegação à esquerda. A partir daí, você pode visualizar as chamadas, condições, eventos e logs.

Após instalar um chart, você pode visualizá-lo clicando em Apps  Aplicativos Instalados no menu de navegação à esquerda. Você pode atualizar ou excluir a instalação e ver mais detalhes. A atualização utiliza os mesmos formulários e valores que você viu durante a instalação inicial.

A maioria das ferramentas do Rancher possui páginas adicionais localizadas na barra de ferramentas abaixo da seção Apps para ajudar a gerenciar e usar os recursos. Essas páginas incluem links para painéis, formulários para adicionar Recursos Personalizados facilmente e informações adicionais.

Se você estiver atualizando seu chart usando Personalizar opções do Helm antes da atualização, e seu chart contiver campos imutáveis, usar a opção --force pode resultar em erros. Isso ocorre porque alguns objetos no Kubernetes não podem ser alterados após serem criados. Para evitar esse erro:

  • Use a opção de fazer upgrade padrão (ou seja, não use --force).

  • Desinstale o chart existente e instale o chart atualizado.

  • Exclua os recursos com campos imutáveis do cluster antes de realizar um upgrade forçado.

Aplicativos Legados

O botão de atualização não está disponível para aplicativos legados na página Apps  Aplicativos Instalados.

Se você quiser fazer upgrade de um aplicativo legado instalado, o sinalizador de recurso legado deve estar ativado. Esse sinalizador é ativado automaticamente se você já tinha um aplicativo legado em execução antes de fazer upgrade do Rancher.

  1. Ative o sinalizador de recurso legado, se ainda não estiver ativado.

  2. Clique em ☰ > Gerenciamento de Cluster.

  3. Encontre o nome do cluster cujos aplicativos você deseja acessar. Clique em Explorar no final da linha do cluster.

  4. Clique em Legado  Projeto  Aplicativos.

Se você não ver Apps listado sob Legado  Projeto, clique na barra de pesquisa de projeto/namespace na navegação superior e selecione o projeto relevante no menu suspenso.

Para fazer upgrade de aplicativos legados de múltiplos clusters:

  1. Clique ☰.

  2. Sob Aplicativos Legados, clique em Aplicativos de Múltiplos Clusters.

Informações Específicas do Chart

Depreciação e Migração do Chart sriov

O chart sriov (operador de rede SR-IOV) do repositório Rancher Charts está descontinuado e será removido no Rancher v2.10. Por favor, migre para o chart sriov-network-operator do repositório SUSE Edge (https://github.com/suse-edge/charts) em vez disso.

Para migrar, siga estas etapas:

  1. Adicione o repositório SUSE Edge ao seu cluster seguindo os passos em Adicionar Repositórios Git Personalizados.

  2. Para o campo URL do Repositório Git, insira https://github.com/suse-edge/charts.

  3. Clique em Criar.

  4. No menu de navegação à esquerda no Painel do Cluster, clique em Apps  Charts.

  5. Encontre o chart sriov-network-operator e clique nele.

  6. Clique em Instalar.

  7. No campo Nome, insira o mesmo nome que você usou para a instalação do chart sriov existente.

  8. Clique em Próximo.

  9. Clique em Instalar.

Resultado: O Rancher redireciona para a página Aplicativos Instalados onde sua instalação existente entra no estado Atualizando. A migração está completa quando entra no estado Implantado.

Limitações

  • Aplicativos de painel ou charts de recursos do Rancher não podem ser instalados usando o Rancher CLI.

  • Ao determinar a versão mais recente a ser exibida para a coluna Fazer upgrade disponível na página Aplicativos  Aplicativos Instalados, em vez de considerar apenas as versões do chart Helm do repositório de onde foi instalada, o Rancher considera as versões do chart Helm de todos os repositórios no cluster.

    Por exemplo, suponha que você instale cert-manager v1.13.0 do repositório A, onde v1.14.0 é agora a versão mais recente disponível. Nesse caso, você espera que Atualizável exiba v1.14.0. No entanto, se o cluster também tiver acesso ao repositório B onde v1.15.0 de cert-manager está disponível, então Atualizável exibe v1.15.0, mesmo que a instalação original tenha usado o repositório A.