Todos os produtos
Search

Este produto

    Container Service for Kubernetes:Simplifique a implantação de aplicações com Helm

    Central de documentação

    Container Service for Kubernetes:Simplifique a implantação de aplicações com Helm

    Última atualização: Jun 27, 2026

    Implante e gerencie aplicações do ACK empacotando recursos do Kubernetes em Helm Charts reutilizáveis.

    Crie uma aplicação Helm

    Este exemplo implanta uma aplicação Dify pelo console do ACK. O cluster deve ter pelo menos 2 núcleos de vCPU e 4 GB de memória disponíveis.

    1. Crie as StorageClasses do Container Network File System (CNFS) e do Network Attached Storage (NAS) para o Dify.

      1. Faça login no console do ACK e acesse a página Clusters. Clique em o cluster desejado e escolha Volumes > StorageClasses no painel de navegação à esquerda.

      2. Na página StorageClasses, clique em Create from YAML. Cole o YAML abaixo no modelo e clique em Create.

        Se já existir um recurso com o mesmo nome, as StorageClasses CNFS e NAS já foram criadas. Prossiga com a implantação da aplicação. A criação de um sistema de arquivos NAS gera custos. Consulte Faturamento do NAS .
        apiVersion: storage.alibabacloud.com/v1beta1
kind: ContainerNetworkFileSystem
metadata:
  name: cnfs-nas-filesystem
spec:
  description: "cnfs"
  type: nas
  reclaimPolicy: Retain  # Only Retain is supported. Deleting the CNFS will not delete the backend NAS instance.
---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: alibabacloud-cnfs-nas
mountOptions:
  - nolock,tcp,noresvport
  - vers=3
parameters:
  volumeAs: subpath # Each persistent volume claim (PVC) will create a separate subdirectory in the NAS file system.
  containerNetworkFileSystem: cnfs-nas-filesystem # Associates with the CNFS instance defined above.
  path: "/"
provisioner: nasplugin.csi.alibabacloud.com
reclaimPolicy: Retain
allowVolumeExpansion: true # Optional: Set to true to allow volume expansion for directory quotas.

    2. Implante a aplicação Dify.

      Na página de detalhes do cluster, escolha Applications > Helm no painel de navegação à esquerda. Na página Helm, clique em Deploy.

      • Basic Information: Na seção Chart, pesquise e selecione ack-dify.

      • Parameters: Em Chart Version, selecione a versão mais recente.

    3. Acesse a aplicação Dify.

      1. Exponha o serviço ack-dify na internet pública.

        O acesso público serve apenas para demonstração. Em produção, utilize controle de acesso para proteger os dados da sua aplicação.

        Acesse Network > Services e selecione o namespace dify-system. Localize o serviço chamado ack-dify, clique em Update, configure os itens a seguir e clique em OK.

        • Service Type : clique em SLB .

        • Access Method: selecione Public Access.

        • VSwitch: selecione os vSwitches apropriados para as zonas de disponibilidade da sua Virtual Private Cloud (VPC).

      2. Acesse a aplicação Dify.

        Copie o endereço External IP e abra-o no navegador para acessar o Dify.

    Gerencie aplicações Helm

    Gerencie as aplicações implantadas na página Helm do console.

    Ação

    Descrição

    Visualize

    Clique em o nome da aplicação ou em Details para visualizar recursos, manifesto YAML e histórico de releases.

    Atualizar

    Clique em Update. No painel Update Release, modifique os parâmetros conforme necessário e clique em OK.

    Importante

    Atualizações podem causar reinicializações de serviços ou problemas funcionais. Avalie o impacto antes de fazer alterações e atualize fora dos horários de pico.

    Excluir

    Clique em Delete. Na caixa de diálogo Delete, selecione Clear Release Records e clique em OK para excluir a aplicação e seus recursos, como Services e Deployments.

    Excluir a aplicação Dify não remove os recursos de backend do NAS. Exclua manualmente o sistema de arquivos NAS.
    Importante

    Se você não selecionar Clear Release Records, o nome da aplicação será preservado. A implantação de outra aplicação com o mesmo nome falhará.

    FAQ

    Como implanto uma aplicação de terceiros usando a CLI do Helm?

    Caso os Charts do ACK não atendam às suas necessidades, use a CLI do Helm para implantar aplicações.

    1. Conecte-se ao seu cluster.

      Cloud-based

      Conecte clusters com kubectl no Workbench ou CloudShell.

      A CLI baseada em navegador da Alibaba Cloud já inclui o Helm pré-instalado. Nenhuma configuração adicional é necessária.

      Local machine

      1. Conecte-se a um cluster ACK usando kubectl.

      2. Instale a CLI do Helm.

        curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

    2. Adicione um repositório de Charts.

      Substitua REPO_NAME pelo alias do repositório e REPO_URL pela URL correspondente .
      helm repo add REPO_NAME REPO_URL

    3. Atualize as informações do repositório local.

      helm repo update

    4. Implante a aplicação de terceiros.

      Substitua APP_NAME pelo nome da sua aplicação e CHART_NAME pelo nome do chart.
      helm install APP_NAME REPO_NAME/CHART_NAME

    Consulte a documentação oficial do Helm para mais comandos.

    Por que não consigo excluir uma aplicação Helm?

    Sintomas

    • No console, a aplicação Helm permanece no estado "Uninstalling" por muito tempo.

    • O comando helm uninstall falha com um erro semelhante a:

      no matches for kind "***" in version "***"
ensure CRDs are installed first

    Causa

    Isso geralmente ocorre quando uma atualização de cluster remove uma versão de API usada por um recurso do chart Helm. A desinstalação falha porque a versão de API especificada não existe mais.

    Consulte o Guia de Migração de APIs Obsoletas para verificar as APIs obsoletas em cada versão do Kubernetes.

    Solução

    1. Use o plugin helm-mapkubeapis para mapear APIs obsoletas para versões suportadas e, em seguida, exclua a aplicação.

      Substitua RELEASE_NAME e NAMESPACE pelo nome e namespace da sua aplicação Helm.
      helm plugin install https://github.com/helm/helm-mapkubeapis
helm mapkubeapis RELEASE_NAME -n NAMESPACE

      Uma mensagem ...completed successfully confirma que as versões de API foram mapeadas.

    2. Desinstale a aplicação novamente.

      helm uninstall RELEASE_NAME -n NAMESPACE

      A saída release "***" uninstalled confirma que a aplicação Helm foi excluída.

    Referências