Implementação de uma aplicação a partir de um gráfico

Restrições

• O número de gráficos que podem ser carregados por um único usuário é limitado. O valor exibido no console de cada região é a quantidade permitida.
• O CCE usa Helm v3.8.2 e permite o upload de pacotes de gráficos Helm v3.
• Um gráfico com várias versões consome a mesma quantidade de parte da cota do gráfico.
• Os usuários com permissões de operação de gráfico podem executar várias operações em clusters. Portanto, tenha cuidado ao atribuir aos usuários as permissões de gerenciamento do ciclo de vida do gráfico, incluindo o upload de gráficos e a criação, exclusão e atualização de versões do gráfico.

Especificações de gráfico

A carga de trabalho do Redis é usada como exemplo para ilustrar as especificações do gráfico.

• Requisito de nomeação

  Um pacote de gráficos é nomeado no formato de {name}-{version}.tgz, onde {version} indica o número da versão no formato de Major version number.Minor version number.Revision number, por exemplo, redis-0.4.2.tgz.

  

  O nome de gráfico {name} pode conter um máximo de 64 caracteres.

  O número da versão deve estar em conformidade com as regras de controle de versão semântico.

  • Os números da versão principal e secundária são obrigatórios, e o número de revisão é opcional.
  • Os números de versão principal e secundária e o número de revisão devem ser inteiros, maior ou igual a 0, e menor ou igual a 99.
• Estrutura de diretórios

  A estrutura de diretórios de um gráfico é a seguinte:

  redis/
    templates/
    values.yaml
    README.md
    Chart.yaml
    .helmignore

  Conforme listado em Tabela 1, os parâmetros marcados com * são obrigatórios.

  Tabela 1 Parâmetros na estrutura de diretórios de um gráfico

  Parâmetro	Descrição
  * templates	Armazena todos os modelos.
  * values.yaml	Descreve os parâmetros de configuração exigidos pelos modelos. AVISO: Certifique-se de que o endereço de imagem definido no arquivo values.yaml é o mesmo que o endereço de imagem no repositório de imagens de contêiner. Caso contrário, uma exceção ocorre quando você cria uma carga de trabalho e o sistema exibe uma mensagem indicando que a imagem não pode ser extraída. Para obter o endereço da imagem, execute as seguintes operações: efetue logon no console do CCE. No painel de navegação, escolha Image Repository para acessar o console do SWR. Escolha My Images > Private Images e clique no nome da imagem carregada. Na página de guia Image Tags, obtenha o endereço da imagem a partir do comando pull. Você pode clicar em para copiar o comando na coluna Image Pull Command.
  README.md	Um arquivo de markdown, incluindo: A carga de trabalho ou serviços fornecidos pelo gráfico. Pré-requisitos para executar o gráfico. Configurações no arquivo values.yaml. Informações sobre a instalação e configuração do gráfico.
  * Chart.yaml	Informações básicas sobre o gráfico. Observação: a versão da API do Helm v3 foi alterada de v1 para v2.
  .helmignore	Arquivos ou dados que não precisam ler modelos durante a instalação da carga de trabalho.

Carregar um gráfico

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster. Escolha Charts no painel de navegação e clique em Upload Chart no canto superior direito.
2. Clique em Select File, selecione o gráfico a ser carregado e clique em Upload.
   

   Quando você carrega um gráfico, a regra de nomeação do bucket do OBS é alterada de cce-charts-{region}-{domain_name} para cce-charts-{region}-{domain_id}. Na regra de nomeação antiga, o sistema converte o valor domain_name em uma cadeia de Base64 e usa os primeiros 63 caracteres. Se não for possível localizar o gráfico no bucket do OBS com o novo nome, procure o bucket com o nome antigo.

Criar uma release

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster. No painel de navegação, escolha Charts.
2. Na página de guia My Charts, clique em Install do gráfico de destino.
3. Defina os parâmetros de instalação da carga de trabalho referindo-se a Tabela 2.

   Tabela 2 Parâmetros de instalação

   Parâmetro	Descrição
   Instance	Nome exclusivo da release do gráfico.
   Namespace	Namespace ao qual a carga de trabalho será implementada.
   Select Version	Versão de um gráfico.
   Configuration File	Você pode importar e substituir o arquivo values.yaml ou editar diretamente os parâmetros do gráfico on-line. NOTA: Um arquivo values.yaml importado deve estar em conformidade com as especificações de YAML, ou seja, formato KEY:VALUE. Os campos no arquivo não são restritos. O valor da chave do values.yaml importado deve ser o mesmo do pacote de gráficos selecionado. Caso contrário, o values.yaml não terá efeito. Ou seja, a chave não pode ser alterada. Clique em Select File. Selecione o arquivo values.yaml correspondente e clique em Open.

4. Clique em Install.

   Na página de guia Releases, você pode exibir o status da instalação da release.

Atualizar uma carga de trabalho baseada em gráfico

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster. Escolha Charts no painel de navegação e clique na guia Releases.
2. Clique em Upgrade na linha em que reside a carga de trabalho desejada e defina os parâmetros para a carga de trabalho.
3. Selecione uma versão do gráfico para Chart Version.
4. Siga os prompts para modificar os parâmetros do gráfico. Clique em Upgrade e, em seguida, clique em Submit.
5. Clique em Back to Release List. Se o status do gráfico for alterado para Upgrade successful, a carga de trabalho será atualizada com êxito.

Reverter uma carga de trabalho baseada em gráficos

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster. Escolha Charts no painel de navegação e clique na guia Releases.
2. Clique em More > Roll Back para a carga de trabalho a ser revertida, selecione a versão da carga de trabalho e clique em Roll back to this version.

   Na lista de cargas de trabalho, se o status for Rollback successful, a carga de trabalho será revertida com sucesso.

Desinstalar uma carga de trabalho baseada em gráfico

1. Efetue logon no console do CCE e clique no nome do cluster para acessar o console do cluster. Escolha Charts no painel de navegação e clique na guia Releases.
2. Clique em More > Uninstall ao lado da versão a ser desinstalada e clique em Yes. Tenha cuidado ao executar esta operação porque as versões não podem ser restauradas após serem desinstaladas.