Ansible角色用于云运维

这个Ansible角色安装云运维代理。

安装角色

• [推荐] 使用Ansible Galaxy管理依赖项，请使用以下命令安装：

  ansible-galaxy install googlecloudplatform.google_cloud_ops_agents

• 如果要使用GitHub子模块管理依赖项，请在您的角色路径中（通常与剧本在同一目录下的roles目录中）安装此目录，命名为googlecloudplatform.google_cloud_ops_agents：

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

这里还有一个详细的教程。

要求

需要Google Cloud API的权限。如果您正在运行旧的Compute Engine实例或使用非默认凭据创建的Compute Engine实例，则必须完成以下步骤 https://cloud.google.com/monitoring/agent/authorization#before_you_begin。

角色变量

agent_type是一个必需的变量，用于指定正在配置的代理。可选项包括monitoring（监控），logging（日志）和ops-agent（运维代理）。

package_state变量可用于指定代理的期望状态。允许的值为present（默认）和absent。

version变量可用于指定要安装的代理的版本。允许的值为latest（默认），MAJOR_VERSION.*.*和MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION，详细说明如下。

version=latest 此设置使代理版本保持更新更容易，但也存在潜在风险。当新主版本发布时，策略可能会从新主版本中安装最新版本的代理，这可能会引入不兼容的变化。对于生产环境，建议使用以下version=MAJOR_VERSION.*.*设置以更安全地部署代理。

version=MAJOR_VERSION.*.* 当新的主版本发布时，此设置确保仅安装指定主版本中的最新版本，避免意外引入不兼容变化。这推荐用于生产环境，以确保更安全的代理部署。

version=MAJOR_VERSION.MINOR_VERSION.PATCH_VERSION 由于此设置阻止了包含错误修复和其他改进的新版本的升级，因此不推荐使用。

main_config_file变量可用于提供自定义配置文件的绝对或相对路径。此文件将覆盖目标虚拟机上的配置文件。

有关更多信息，请参阅配置监控代理，配置日志代理或配置运维代理。

默认情况下，代理只监控和记录系统资源，如 CPU、内存、磁盘等。可以通过使用additional_config_dir变量提供包含插件配置文件的目录路径来配置第三方应用程序的监控和日志记录。此目录下的所有.conf文件将被部署到目标虚拟机上代理的插件目录。主配置文件应包含此目录的相关行。请注意，此变量只能在配置监控或日志代理时指定。

有关更多信息，请参阅监控第三方应用程序。

示例剧本

# 安装监控和日志代理
- 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

# 安装带有自定义配置的监控和日志代理
- 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/

# 安装运维代理
- hosts: all
  become: true
  roles:
    - role: googlecloudplatform.google_cloud_ops_agents
      vars:
        agent_type: ops-agent

# 安装带有自定义配置的运维代理
- 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

兼容性

下表列出了此Ansible角色的版本及其支持的代理版本。

• 运维代理版本发布
• 日志代理版本发布
• 监控代理版本发布

bug报告与功能请求

请通过 https://cloud.google.com/support-hub 提交案例，以获得遵循SLO的官方支持。

许可证

版权所有 2020 Google Inc. 保留所有权利。

根据Apache许可证第2.0版（“许可证”）授权；您只能在遵循许可证的情况下使用此文件。您可以在以下网址获得许可证的副本：

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

除非适用法律要求或书面同意，否则根据许可证分发的软件在“按现状”基础上分发，不提供任何形式的明示或暗示的担保或条件。有关许可证下的权限和限制的具体语言，请参见许可证。