Rola Ansible dla Cloud Ops

Ta rola Ansible instaluje agentów Cloud Ops.

Instalacja roli

• [Zalecane] Aby używać Ansible Galaxy do zarządzania zależnościami, użyj tego polecenia, aby zainstalować:

  ansible-galaxy install googlecloudplatform.google_cloud_ops_agents

• Aby używać submodułów GitHub do zarządzania zależnościami, zainstaluj ten katalog w swojej ścieżce ról (zwykle w katalogu ról obok swojego playbooka) pod

  nazwą googlecloudplatform.google_cloud_ops_agents:

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

Dostępny jest również szczegółowy tutorial.

Wymagania

Uprawnienia do Google Cloud API. Jeśli uruchamiasz starszą instancję Compute Engine lub instancje Compute Engine utworzone bez domyślnych poświadczeń, musisz wykonać następujące kroki: https://cloud.google.com/monitoring/agent/authorization#before_you_begin.

Zmienne roli

Zmienna agent_type jest wymagana i służy do określenia, który agent jest konfigurowany. Dostępne opcje to monitoring, logging i ops-agent.

Zmienna package_state może być używana do określenia pożądanego stanu agenta. Dozwolone wartości to present (domyślnie) i absent.

Zmienna version może być używana do określenia, którą wersję agenta zainstalować. Dozwolone wartości to latest (domyślnie), MAJOR_VERSION.*.* i MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION, które są szczegółowo opisane poniżej.

version=latest To ustawienie ułatwia utrzymanie agenta w aktualnej wersji, jednak wiąże się z potencjalnym ryzykiem. Gdy zostanie wydana nowa wersja główna, polityka może zainstalować najnowszą wersję agenta z nowego wydania głównego, co może wprowadzić zmiany łamiące zgodność. Dla środowisk produkcyjnych, rozważ użycie ustawienia version=MAJOR_VERSION.*.*, aby zapewnić bezpieczniejsze wdrożenia agenta.

version=MAJOR_VERSION.*.* Gdy nowe wydanie główne jest dostępne, to ustawienie zapewnia, że tylko najnowsza wersja z określonej wersji głównej zostanie zainstalowana, co zapobiega przypadkowemu wprowadzeniu zmian łamiących zgodność. Jest to zalecane dla środowisk produkcyjnych, aby zapewnić bezpieczniejsze wdrożenia agenta.

version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION To ustawienie nie jest zalecane, ponieważ uniemożliwia aktualizację nowych wersji agenta, które zawierają poprawki błędów i inne ulepszenia.

Zmienna main_config_file może być używana do podania absolutnej lub względnej ścieżki do niestandardowego pliku konfiguracyjnego. Ten plik nadpisze plik konfiguracyjny na docelowej maszynie wirtualnej.

Aby uzyskać więcej informacji, zapoznaj się z Konfigurowanie agenta monitorowania, Konfigurowanie agenta logowania lub Konfigurowanie agenta operacyjnego.

Domyślnie agent monitoruje i rejestruje zasoby systemowe, takie jak CPU, pamięć, dysk itp. Monitorowanie i rejestrowanie aplikacji innych firm można skonfigurować, podając ścieżkę do katalogu zawierającego pliki konfiguracyjne wtyczek, używając zmiennej additional_config_dir. Wszystkie pliki .conf w tym katalogu będą wdrażane do katalogu wtyczek agenta na docelowej maszynie wirtualnej. Główny plik konfiguracyjny powinien zawierać linię, która uwzględnia ten katalog. Należy pamiętać, że ta zmienna może być podana tylko podczas konfigurowania agentów monitorowania lub logowania.

Aby uzyskać więcej informacji, zapoznaj się z Monitorowanie aplikacji innych firm.

Przykładowe playbooki

# Instalacja agentów monitorowania i logowania
- 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

# Instalacja agentów monitorowania i logowania z niestandardowymi konfiguracjami
- 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/

# Instalacja agenta operacyjnego
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent

# Instalacja agenta operacyjnego z niestandardową konfiguracją
- 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

Kompatybilność

Tabela poniżej pokazuje wersje tej roli Ansible oraz wersje agentów, które obsługuje.

• Wydania agenta operacyjnego releases
• Wydania agenta logowania releases
• Wydania agenta monitorowania releases

Zgłaszanie błędów i prośby o funkcje

Prosimy o zgłoszenie sprawy za pośrednictwem https://cloud.google.com/support-hub, aby uzyskać oficjalne wsparcie zgodnie z SLO.

Licencja

Copyright 2020 Google Inc. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use
this file except in compliance with the License.  You may obtain a copy of the
License at

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

Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied.  See the License for the
specific language governing permissions and limitations under the License.