Configurar objetivos de sondas externas

En este documento se explica cómo configurar objetivos externos para el sondeo en Google Distributed Cloud (GDC) aislado. El sistema descubre y monitoriza estos destinos leyendo un ConfigMap de Kubernetes específico.

Antes de empezar

Para aplicar un ConfigMap al espacio de nombres gpc-system, debes tener acceso al clúster y permisos para crear o modificar ConfigMaps en ese espacio de nombres. También necesitas la ruta al archivo kubeconfig del clúster de servidores de la API Management. Las comprobaciones de destino externas solo se pueden configurar en clústeres de administrador raíz o de admin. de la org.

Información sobre los detalles de ConfigMap

El agente de sondeo busca un ConfigMap con las siguientes características:

  • Nombre: pnet-external-probe-targets-config
  • Espacio de nombres: gpc-system
  • Clave de datos: el ConfigMap debe contener una clave llamada targets.yaml en su campo data. El valor asociado a esta clave debe ser una cadena YAML que defina los objetivos de la sonda.

Información sobre la estructura de targets.yaml

El contenido de targets.yaml debe ser una lista de objetos YAML. Cada objeto representa un único objetivo de sonda externa y sigue esta estructura:

- name: <unique-probe-name>
  spec:
    target: <hostname-or-ip>
    probeType: <TCP or ICMP>
    port: <port-number> # Required for TCP, ignored for ICMP
    interval: <duration> # e.g., "10s", "1m"
    timeout: <duration>  # Optional, e.g., "5s". Defaults to 5s if not set.

A continuación, se describen los campos:

  • name (cadena): un identificador único de este objetivo de sondeo específico.
  • spec: define los parámetros de sondeo:
    • target (cadena): el nombre de host o la dirección IP del objetivo externo que se va a sondear.
    • probeType (cadena): el tipo de sondeo que se va a realizar. Los valores admitidos son:
      • TCP: intenta establecer una conexión TCP con el target y el port especificados.
      • ICMP: envía una solicitud de eco ICMP (ping) a target.
    • port (int32): número de puerto que se usará para las sondas TCP. Este campo es obligatorio cuando probeType es TCP y se ignora en las sondas ICMP.
    • interval (cadena): la frecuencia con la que se debe ejecutar la sonda. Debe ser una cadena de Kubernetes metav1.Duration válida (por ejemplo, "5s" o "1m30s").
    • timeout (cadena, opcional): el tiempo máximo que se debe esperar para que se complete un único intento de sondeo. Esto también es una cadena metav1.Duration. Si no se especifica, se usa un tiempo de espera predeterminado de 5s.

Crear y aplicar el ConfigMap

Para crear o actualizar el ConfigMap, sigue estos pasos:

  1. Crea un archivo YAML llamado external-probe-configmap.yaml. En el siguiente ejemplo se definen tres objetivos de sondeo:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: pnet-external-probe-targets-config
      namespace: gpc-system
    data:
      targets.yaml: |
        - name: "example-tcp-server"
          spec:
            target: "192.0.2.1"
            probeType: "TCP"
            port: 80
            interval: "10s"
            timeout: "3s"
        - name: "example-icmp-host"
          spec:
            target: "8.8.8.8"
            probeType: "ICMP"
            interval: "30s"
        - name: "another-tcp-service"
          spec:
            target: "my-service.example.com"
            probeType: "TCP"
            port: 443
            interval: "1m"
            # Using default timeout of 5s
    
  2. Aplica el ConfigMap a tu clúster:

    kubectl apply -f external-probe-configmap.yaml -n gpc-system --kubeconfig=MANAGEMENT_API_SERVER
    

    Sustituye MANAGEMENT_API_SERVER por la ruta al archivo kubeconfig del servidor de la API Management.

El prober detecta automáticamente los cambios en este ConfigMap e inicia, detiene o actualiza los procesos de sondeo en función de los objetivos definidos.