Connect a registered cluster to ARMS - Container Service for Kubernetes

Application Real-Time Monitoring Service (ARMS) ofrece un monitoreo integral que le ayuda a dar seguimiento al estado de sus aplicaciones. Puede instalar el componente de monitoreo de ARMS en un clúster registrado para supervisar las aplicaciones que se ejecutan dentro de este.

Requisitos previos

Paso 1: Instalar el componente de ARMS

Uso de onectl

Instale y configure onectl en su computadora local. Para obtener más información, consulte Manage registered clusters using onectl.

Ejecute el siguiente comando para otorgar permisos de RAM al componente ack-onepilot.

onectl ram-user grant --addon ack-onepilot

Resultado esperado:

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

Ejecute el siguiente comando para instalar el componente ack-onepilot.
```
onectl addon install ack-onepilot
```
Resultado esperado:
```
Addon ack-onepilot, version **** installed.
```

Uso de la consola

Configure los permisos de RAM. Antes de instalar el componente, debe proporcionarle un AccessKey que le otorgue permisos para acceder a los servicios de Alibaba Cloud.
1. Create a RAM user.
2. Create a custom policy. El componente ack-onepilot requiere los permisos de la siguiente directiva:
  { "Version": "1", "Statement": [ { "Action": "arms:*", "Resource": "*", "Effect": "Allow" }, { "Action": "cms:*", "Resource": "*", "Effect": "Allow" } ] }
3. Grant permissions to a RAM user. Asigne al usuario de RAM la directiva personalizada que creó en el paso anterior.
4. Create an AccessKey para el usuario de RAM.
  
  Aviso
  Para mejorar la seguridad, configure una directiva de control de acceso de red para el AccessKey. Esto restringe el acceso a entornos de red de confianza y aumenta la protección. Para obtener más información, consulte AccessKey-based network access restriction policies.
5. Use el AccessKey para crear un Secret llamado alibaba-addon-secret en el clúster registrado.
  Ejecute el siguiente comando para crear el Secret del componente ack-onepilot.
  
  Nota
  Antes de ejecutar el comando, reemplace los valores de los parámetros access-key-id y access-key-secret con el AccessKey ID y el AccessKey Secret que creó en el paso 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>'
Instale el componente ack-onepilot.
1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Components and Add-ons .
3. En la página Add-ons, haga clic en la pestaña Install, busque y seleccione el componente ack-onepilot, y luego haga clic en Next.
4. Siga las instrucciones en pantalla para completar la configuración del componente y luego haga clic en Next.
5. Compruebe la información de configuración y luego haga clic en OK.

Paso 2: Habilitar ARMS para una aplicación Java

Agregue tres etiquetas a la sección spec.template.metadata.labels de su archivo YAML de Deployment para habilitar el monitoreo de ARMS:

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

Label	Value	Description
`armsPilotAutoEnable`	`"on"`	Habilita la inyección automática del agente en el pod
`armsPilotCreateAppName`	`"<your-deployment-name>"`	Nombre de la aplicación que se muestra en la consola de ARMS. Reemplácelo con el nombre de su aplicación.
`aliyun.com/app-language`	`java`	Especifica el lenguaje de la aplicación para el agente

Aplicar las etiquetas a un Deployment existente

Inicie sesión en la consola de ACK. Haga clic en Clusters y luego en el nombre del clúster.
En el panel de navegación izquierdo, elija Workloads > Deployments.
En la página Stateless, haga clic en > YAML Edit junto a la aplicación de destino.
Agregue las tres etiquetas a spec.template.metadata.labels y haga clic en Update.

Nota

Para obtener más información sobre la seguridad de las aplicaciones, consulte What is Application Security?.

Para conocer los detalles de facturación de la seguridad de aplicaciones, 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:

En la página Stateless, haga clic en > ARMS Console en la columna Actions de la aplicación de destino para consultar los detalles de monitoreo.

A continuación

Desinstalar el agente de todas las aplicaciones
Uso de onectl
1. Ejecute el siguiente comando para desinstalar el componente ack-onepilot.
  onectl addon uninstall ack-onepilot
  Resultado esperado:
  Addon ack-onepilot uninstalled.
2. Reinicie los pods de la aplicación para aplicar los cambios.
Uso de la consola
1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
2. En la página Clusters, haga clic en el nombre de su clúster. En el panel de navegación izquierdo, haga clic en Components and Add-ons .
3. En la página Add-ons, busque el componente ack-onepilot y luego haga clic en Uninstall.
4. En el cuadro de diálogo que aparece, haga clic en Uinstall.
5. Reinicie los pods de la aplicación para aplicar los cambios.
Desinstalar el agente de una aplicación específica
1. Inicie sesión en la consola de ACK. En el panel de navegación izquierdo, haga clic en Clusters.
2. En la página Clusters, haga clic en el nombre de su clúster y, en el panel de navegación izquierdo, elija Workloads > Deployments.
3. En la página Deployments, elija More > Edit YAML en la columna Actions de la aplicación de destino. En el cuadro de diálogo Edit YAML, elimine las labels agregadas en Step 2 y haga clic en Update.
4. Reinicie los pods de la aplicación para aplicar los cambios.