Todos os produtos
Search

Este produto

    Container Service for Kubernetes:Connect a registered cluster to ARMS

    Central de documentação

    Container Service for Kubernetes:Connect a registered cluster to ARMS

    Última atualização: Oct 20, 2026

    O Application Real-Time Monitoring service (ARMS) oferece monitoramento abrangente para ajudar você a acompanhar a integridade das suas aplicações. Instale o componente de monitoramento do ARMS em um cluster registrado para monitorar as aplicações executadas nele.

    Pré-requisitos

    Etapa 1: Instale o componente ARMS

    Usando onectl

    1. Instale e configure o onectl na sua máquina local. Para mais informações, consulte Manage registered clusters using onectl.

    2. Execute o comando a seguir para conceder permissões do RAM ao componente ack-onepilot.

      onectl ram-user grant --addon ack-onepilot

      Saída esperada:

      Ram policy ack-one-registered-cluster-policy-ack-onepilot granted to ram user **** successfully.

    3. Execute o comando a seguir para instale o componente ack-onepilot.

      onectl addon install ack-onepilot

      Saída esperada:

      Addon ack-onepilot, version **** installed.

    Usando o console

    1. Configure as permissões do RAM. Antes de instale o componente, forneça uma AccessKey que conceda permissões de acesso aos services da Alibaba Cloud.

      1. Create a RAM user.

      2. Create a custom policy. O componente ack-onepilot requer as permissões na política a seguir:

        {
    "Version": "1",
    "Statement": [
        {
            "Action": "arms:*",
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": "cms:*",
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

      3. Grant permissions to a RAM user. Anexe a política personalizada criada na etapa anterior ao usuário do RAM.

      4. Create an AccessKey para o usuário do RAM.

        Aviso

        Para maior segurança, configure uma política de controle de acesso à rede para a AccessKey, restringindo o acesso a ambientes de rede confiáveis e melhorando a proteção. Para mais informações, consulte AccessKey-based network access restriction policies.

      5. Use a AccessKey para crie um Secret chamado alibaba-addon-secret no cluster registrado.

        Execute o comando a seguir para crie o Secret do componente ack-onepilot.

        Nota

        Antes de execute o comando, substitua os valores dos parâmetros access-key-id e access-key-secret pelo AccessKey ID e AccessKey Secret criados na etapa anterior.

        kubectl -n ack-onepilot create secret generic alibaba-addon-secret --from-literal='access-key-id=<your AccessKey ID>' --from-literal='access-key-secret=<your AccessKey Secret>'

    2. Instale o componente ack-onepilot.

      1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

      2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons .

      3. Na página Add-ons, clique em na aba Install, localize e selecione o componente ack-onepilot e, em seguida, clique em Next.

      4. Siga as instruções na tela para concluir a configuração do componente e clique em Next.

      5. Verifique as informações de configuração e clique em OK.

    Aviso

    Ao instale o componente ack-onepilot em um cluster registrado, ele puxa imagens da VPC da Alibaba Cloud por padrão. Se o seu cluster não conseguir acessar a rede VPC da Alibaba Cloud, após instale o componente, localize ack-onepilot na página Applications > Helm do cluster e clique em Update. Na seção registry, remova -vpc do endereço do repositório de imagens para usar imagens públicas. Em seguida, defina ALIYUN_NETWORK como public para forçar o componente a usar o modo público. Para mais informações, consulte Network mode for the ack-onepilot component.

    Etapa 2: Ative o ARMS para uma aplicação Java

    Adicione três rótulos à seção spec.template.metadata.labels do YAML do seu Deployment para ative o monitoramento do ARMS:

    labels:
  armsPilotAutoEnable: "on"
  armsPilotCreateAppName: "<your-deployment-name>"    # Replace <your-deployment-name> with your application name.
  aliyun.com/app-language: java

    Rótulo

    Valor

    Descrição

    armsPilotAutoEnable

    "on"

    Ativa a injeção automática de agente para o pod

    armsPilotCreateAppName

    "&lt;your-deployment-name&gt;"

    Nome da aplicação exibido no console do ARMS. Substitua pelo nome da sua aplicação.

    aliyun.com/app-language

    java

    Especifica a linguagem da aplicação para o agente

    Aplique os rótulos a um Deployment existente

    1. Faça login no ACK console. Clique em Clusters e, em seguida, clique no nome do cluster.

    2. No painel de navegação à esquerda, escolha Workloads > Deployments.

    3. Na página Stateless, clique em image > YAML Edit ao lado da aplicação alvo.

    4. Adicione os três rótulos em spec.template.metadata.labels e clique em Update.

    Nota

    Para mais informações sobre segurança de aplicações, consulte What is Application Security?.

    Para mais informações sobre o faturamento de segurança de aplicações, consulte Billing.

    apiVersion: v1
kind: Namespace
metadata:
  name: arms-demo
---
apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-springboot-demo
  namespace: arms-demo
  labels:
    app: arms-springboot-demo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo
  template:
    metadata:
      labels:
        app: arms-springboot-demo
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "arms-k8s-demo"
    spec:
      containers:
        - resources:

    1. Na página Stateless, clique em image > ARMS Console na coluna Actions da aplicação alvo para visualize os detalhes de monitoramento da aplicação.

    Próximas etapas

    • Desinstale o agente para todas as aplicações

      Usando onectl

      1. Execute o comando a seguir para desinstalar o componente ack-onepilot.

        onectl addon uninstall ack-onepilot

        Saída esperada:

        Addon ack-onepilot uninstalled.

      2. Reinicie os pods da aplicação para aplicar as alterações.

      Usando o console

      1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

      2. Na página Clusters, clique no nome do seu cluster. No painel de navegação à esquerda, clique em Components and Add-ons .

      3. Na página Add-ons, localize o componente ack-onepilot e clique em Uninstall.

      4. Na caixa de diálogo exibida, clique em Uinstall.

      5. Reinicie os pods da aplicação para aplicar as alterações.

    • Desinstale o agente para uma aplicação específica

      1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

      2. Na página Clusters, clique no nome do seu cluster e, no painel de navegação à esquerda, escolha Workloads > Deployments.

      3. Na página Deployments, escolha More > Edit YAML na coluna Actions da aplicação alvo. Na caixa de diálogo Edit YAML, remova os labels adicionados em Step 2 e clique em Update.

      4. Reinicie os pods da aplicação para aplicar as alterações.