Ansible Rolle für Cloud-Operationen

Diese Ansible-Rolle installiert die Cloud-Operations-Agenten.

Rolle installieren

• [Empfohlen] Verwenden Sie Ansible Galaxy, um Abhängigkeiten zu verwalten. Verwenden Sie diesen Befehl, um zu installieren:

  ansible-galaxy install googlecloudplatform.google_cloud_ops_agents

• Um GitHub-Submodule zur Verwaltung von Abhängigkeiten zu verwenden, installieren Sie dieses Verzeichnis in Ihrem Rollenverzeichnis (normalerweise im Rollenverzeichnis neben Ihrem Playbook) unter dem Namen googlecloudplatform.google_cloud_ops_agents:

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

Es gibt außerdem ein ausführliches Tutorial.

Anforderungen

Berechtigungen für die Google Cloud API. Wenn Sie eine alte Compute Engine-Instanz oder Compute Engine-Instanzen ohne die Standardanmeldeinformationen ausführen, müssen Sie die folgenden Schritte durchführen: https://cloud.google.com/monitoring/agent/authorization#before_you_begin.

Rollenvariablen

Die Variable agent_type ist erforderlich und wird verwendet, um anzugeben, welcher Agent konfiguriert wird. Die verfügbaren Optionen sind monitoring, logging und ops-agent.

Die Variable package_state kann verwendet werden, um den gewünschten Zustand des Agenten anzugeben. Die erlaubten Werte sind present (Standard) und absent.

Die Variable version kann verwendet werden, um die zu installierende Version des Agenten anzugeben. Die erlaubten Werte sind latest (Standard), MAJOR_VERSION.*.* und MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION, die unten genauer beschrieben werden.

version=latest Diese Einstellung erleichtert es, die Agenten-Version auf dem neuesten Stand zu halten, birgt jedoch potenzielle Risiken. Wenn eine neue Hauptversion veröffentlicht wird, kann die Richtlinie die neueste Version des Agenten aus der neuen Hauptversion installieren, was zu incompatiblen Änderungen führen kann. Für Produktionsumgebungen sollten Sie die untenstehende Einstellung version=MAJOR_VERSION.*.* für sicherere Agenten-Installationen in Betracht ziehen.

version=MAJOR_VERSION.*.* Wenn eine neue Hauptversion verfügbar ist, stellt diese Einstellung sicher, dass nur die neueste Version der angegebenen Hauptversion installiert wird, was verhindert, dass unbeabsichtigt inkompatible Änderungen eingeführt werden. Dies wird für Produktionsumgebungen empfohlen, um sicherere Agenteneinstellungen zu gewährleisten.

version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION Diese Einstellung wird nicht empfohlen, da sie Upgrades neuer Versionen des Agenten verhindert, die Fehlerbehebungen und andere Verbesserungen enthalten.

Die Variable main_config_file kann verwendet werden, um einen absoluten oder relativen Pfad zu einer benutzerdefinierten Konfigurationsdatei anzugeben. Diese Datei überschreibt die Konfigurationsdatei auf der Ziel-VM.

Für weitere Informationen siehe Konfiguration des Monitoring-Agents, Konfiguration des Logging-Agents oder Konfiguration des Ops-Agents.

Standardmäßig überwacht und protokolliert der Agent nur Systemressourcen wie CPU, Arbeitsspeicher, Festplatte usw. Das Monitoring und Logging von Drittanbieteranwendungen kann konfiguriert werden, indem ein Pfad zu einem Verzeichnis angegeben wird, das Plugin-Konfigurationsdateien enthält, unter Verwendung der Variablen additional_config_dir. Alle .conf-Dateien in diesem Verzeichnis werden im Plugin-Verzeichnis des Agenten auf der Ziel-VM bereitgestellt. Die Hauptkonfigurationsdatei sollte eine Zeile enthalten, die dieses Verzeichnis einbezieht. Bitte beachten Sie, dass diese Variable nur beim Konfigurieren der Monitoring- oder Logging-Agents angegeben werden kann.

Für weitere Informationen siehe Monitoring von Drittanbieteranwendungen.

Beispiel-Playbooks

# Installation der Monitoring- und Logging-Agents
- 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 der Monitoring- und Logging-Agents mit benutzerdefinierten Konfigurationen
- 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 des Ops-Agents
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent

# Installation des Ops-Agents mit benutzerdefinierter Konfiguration
- 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

Kompatibilität

Die folgende Matrix listet die Versionen dieser Ansible-Rolle und die auf unterstützten Agenten-Versionen auf.

• Ops-Agent Veröffentlichungen
• Logging-Agent Veröffentlichungen
• Monitoring-Agent Veröffentlichungen

Fehlerbericht und Funktionsanfrage

Bitte melden Sie einen Fall über https://cloud.google.com/support-hub, um offiziellen Support zu erhalten, der SLOs einhält.

Lizenz

Copyright 2020 Google Inc. Alle Rechte vorbehalten.

Lizenz unter der Apache License, Version 2.0 ("Lizenz"); Sie dürfen diese Datei nicht verwenden, es sei denn, Sie halten sich an die Lizenz. Sie können eine Kopie der Lizenz unter

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

erhalten. Sofern nicht gesetzlich vorgeschrieben oder schriftlich vereinbart, wird Software, die unter der Lizenz verteilt wird, auf einer "AS IS"-Basis ohne Gewähr für irgendeine Art, weder ausdrücklich noch stillschweigend, bereitgestellt. Weitere Informationen finden Sie in der Lizenz, die die spezifischen Bedingungen und Einschränkungen regelt.