Rôle Ansible pour Cloud Ops

Ce rôle Ansible installe les agents Cloud Ops.

Installer le Rôle

• [Recommandé] Pour utiliser Ansible Galaxy pour gérer les dépendances, utilisez cette commande pour installer :

  ansible-galaxy install googlecloudplatform.google_cloud_ops_agents

• Pour utiliser les sous-modules GitHub pour gérer les dépendances, installez ce répertoire dans votre chemin de rôles (habituellement dans un répertoire de rôles à côté de votre playbook) sous le nom googlecloudplatform.google_cloud_ops_agents :

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

Il y a aussi un tutoriel détaillé.

Exigences

Permissions pour l'API Google Cloud. Si vous exécutez une ancienne instance de Compute Engine ou des instances de Compute Engine créées sans les identifiants par défaut, vous devez suivre les étapes suivantes : https://cloud.google.com/monitoring/agent/authorization#before_you_begin.

Variables du Rôle

La variable agent_type est requise pour spécifier quel agent est configuré. Les options disponibles sont monitoring, logging et ops-agent.

La variable package_state peut être utilisée pour spécifier l'état souhaité de l'agent. Les valeurs autorisées sont present (défaut) et absent.

La variable version peut être utilisée pour spécifier quelle version de l'agent installer. Les valeurs autorisées sont latest (défaut), MAJOR_VERSION.*.* et MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION, qui sont expliquées en détail ci-dessous.

version=latest Ce paramètre permet de maintenir la version de l'agent à jour, mais présente un risque potentiel. Lorsqu'une nouvelle version majeure est publiée, la politique peut installer la dernière version de l'agent de la nouvelle version majeure, ce qui peut introduire des changements perturbateurs. Pour les environnements de production, envisagez d'utiliser le paramètre version=MAJOR_VERSION.*.* ci-dessous pour des déploiements d'agents plus sûrs.

version=MAJOR_VERSION.*.* Lorsque qu'une nouvelle version majeure est publiée, ce paramètre garantit que seule la dernière version de la version majeure spécifiée est installée, évitant ainsi d'introduire accidentellement des changements perturbateurs. Ceci est recommandé pour les environnements de production afin d'assurer des déploiements d'agents plus sûrs.

version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION Ce paramètre n'est pas recommandé car il empêche les mises à jour des nouvelles versions de l'agent qui incluent des corrections de bugs et d'autres améliorations.

La variable main_config_file peut être utilisée pour fournir un chemin absolu ou relatif vers un fichier de configuration personnalisé. Ce fichier remplacera le fichier de configuration sur la VM cible.

Pour plus d'informations, veuillez consulter Configuration de l'Agent de Surveillance, Configuration de l'Agent de Journalisation ou Configuration de l'Ops Agent.

Par défaut, l'agent ne surveille et n'enregistre que les ressources système telles que le CPU, la mémoire, le disque, etc. La surveillance et l'enregistrement des applications tierces peuvent être configurés en fournissant un chemin vers un répertoire contenant des fichiers de configuration de plugin en utilisant la variable additional_config_dir. Tous les fichiers .conf dans ce répertoire seront déployés dans le répertoire des plugins de l'agent sur la VM cible. Le fichier de configuration principal doit inclure une ligne qui fait référence à ce répertoire. Veuillez noter que cette variable ne peut être spécifiée que lors de la configuration des agents de surveillance ou de journalisation.

Pour plus d'informations, veuillez consulter Surveillance des applications tierces.

Exemples de Playbooks

# Installation des agents de Surveillance et de Journalisation
- 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

# Installation des agents de Surveillance et de Journalisation avec des configurations personnalisées
- 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/

# Installation de l'Ops-Agent
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent

# Installation de l'Ops-Agent avec une configuration personnalisée
- 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

Compatibilité

Le tableau ci-dessous liste les versions de ce rôle Ansible et les versions de l'agent qu'il prend en charge.

• Versions de l'Ops Agent
• Versions de l'Agent de Journalisation
• Versions de l'Agent de Surveillance

Rapport de bogue et demande de fonctionnalité

Veuillez soumettre un cas via https://cloud.google.com/support-hub pour obtenir un support officiel qui suit les SLO.

Licence

Copyright 2020 Google Inc. Tous droits réservés.

Distribué sous la licence Apache, version 2.0 (la "Licence"); vous ne pouvez pas utiliser
ce fichier sauf en conformité avec la Licence. Vous pouvez obtenir une copie de la
Licence à l'adresse suivante :

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

À moins que la loi applicable n'exige ou que cela ne soit convenu par écrit, 
le logiciel distribué sous la Licence est distribué sur une base "EN L'ÉTAT", 
SANS GARANTIES OU CONDITIONS D'AUCUNE SORTE, explicites ou implicites. 
Voir la Licence pour la langue spécifique régissant les permissions et les limitations sous la Licence.