Rol de Ansible para Cloud Ops

Este rol de Ansible instala los agentes de Cloud Ops.

Instalar el Rol

• [Recomendado] Para usar Ansible Galaxy para manejar dependencias, usa este comando para instalar:

  ansible-galaxy install googlecloudplatform.google_cloud_ops_agents

• Para usar submódulos de GitHub para manejar dependencias, instala este directorio en tu ruta de roles (generalmente en un directorio de roles junto a tu playbook) bajo

  el nombre googlecloudplatform.google_cloud_ops_agents:

  git clone <este-repo-git> roles/googlecloudplatform.google_cloud_ops_agents

También hay un tutorial detallado.

Requisitos

Permisos para la API de Google Cloud. Si estás ejecutando una instancia antigua de Compute Engine o instancias de Compute Engine creadas sin las credenciales predeterminadas, debes completar los siguientes pasos https://cloud.google.com/monitoring/agent/authorization#before_you_begin.

Variables del Rol

La variable agent_type es obligatoria y se usa para especificar qué agente se está configurando. Las opciones disponibles son monitoring, logging y ops-agent.

La variable package_state se puede usar para especificar el estado deseado del agente. Los valores permitidos son present (predeterminado) y absent.

La variable version se puede usar para especificar qué versión del agente instalar. Los valores permitidos son latest (predeterminado), MAJOR_VERSION.*.* y MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION, que se describen en detalle a continuación.

version=latest Esta configuración facilita mantener la versión del agente actualizada, sin embargo, tiene un riesgo potencial. Cuando se lanza una nueva versión principal, la política puede instalar la última versión del agente de la nueva versión principal, lo que puede introducir cambios disruptivos. Para entornos de producción, considera usar la configuración version=MAJOR_VERSION.*.* a continuación para despliegues más seguros del agente.

version=MAJOR_VERSION.*.* Cuando hay un nuevo lanzamiento principal, esta configuración asegura que solo se instale la última versión de la versión principal especificada, evitando introducir cambios disruptivos accidentalmente. Se recomienda para entornos de producción para asegurar despliegues más seguros del agente.

version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION Esta configuración no se recomienda ya que impide actualizaciones de nuevas versiones del agente que incluyen correcciones y otras mejoras.

La variable main_config_file se puede usar para proporcionar una ruta absoluta o relativa a un archivo de configuración personalizado. Este archivo sobrescribirá el archivo de configuración en la VM de destino.

Para más información, consulta Configurando el Agente de Monitoreo, Configurando el Agente de Registro o Configurando el Agente Ops.

Por defecto, el agente solo monitorea y registra recursos del sistema como CPU, memoria, disco, etc. La supervisión y el registro de aplicaciones de terceros se pueden configurar proporcionando una ruta a un directorio que contenga archivos de configuración de plugins usando la variable additional_config_dir. Todos los archivos .conf en este directorio se desplegarán en el directorio de plugins del agente en la VM de destino. El archivo de configuración principal debe tener una línea que incluya este directorio. Ten en cuenta que esta variable solo se puede especificar al configurar los agentes de monitoreo o registro.

Para más información, consulta Monitoreo de aplicaciones de terceros.

Ejemplos de Playbooks

# Instalando los agentes de Monitoreo y Registro
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: monitoring

    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: logging

# Instalando los agentes de Monitoreo y Registro con configuraciones personalizadas
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: monitoring
        version: latest
        main_config_file: monitoring_agent.conf
        additional_config_dir: monitoring_agent_dir/

    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: logging
        version: 1.*.*
        main_config_file: logging_agent.conf
        additional_config_dir: logging_agent_dir/

# Instalando el Agente Ops
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent

# Instalando el Agente Ops con configuración personalizada
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent
        version: 1.0.1
        main_config_file: ops_agent.yaml

Compatibilidad

La matriz a continuación lista las versiones de este rol de Ansible y las versiones de los agentes que soporta.

• Lanzamientos del Agente Ops
• Lanzamientos del Agente de Registro
• Lanzamientos del Agente de Monitoreo

Reporte de errores y solicitudes de características

Por favor, presenta un caso a través de https://cloud.google.com/support-hub para obtener soporte oficial que siga los SLO.

Licencia

Copyright 2020 Google Inc. Todos los derechos reservados.

Licenciado bajo la Licencia Apache, Versión 2.0 (la "Licencia"); no se puede usar
este archivo excepto en cumplimiento con la Licencia. Puedes obtener una copia de la
Licencia en

    http://www.apache.org/licenses/LICENSE-2.0

Salvo que la ley aplicable exija lo contrario o se acuerde por escrito, el software distribuido
bajo la Licencia se distribuye "TAL CUAL", SIN GARANTÍAS O CONDICIONES DE NINGÚN TIPO, ya sean expresas o implícitas. Ve la Licencia para el
lenguaje específico que rige los permisos y limitaciones bajo la Licencia.