Skip to content

Latest commit

 

History

History
195 lines (152 loc) · 5.49 KB

README.md

File metadata and controls

195 lines (152 loc) · 5.49 KB
Raw

desc

这里其实没有必要使用import_role的操作，单纯就是为了体验这个特性。

这是一个用来部署“通用应用”的role。 这些“通用应用”需要具有如下条件：

  • 包类型
    • tgz:tar.gz格式，目录名最好带有版本号，方便更新操作。
    • jar: 比如jmx_exporter.jar
    • binary: 比如redis_expoter这个二进制文件，连目录都没有的
  • 有配置文件，配置文件是个列表，没有也没关系
  • 可以使用supervisor或systemd来进行管理

思想是定义出一些通用的操作。

针对个别有特殊需求的，单独为其再进行定义一个针对性的task。这样就大大减少了代码量。

不足之处

这种用法有局限性，如果一台主机上同时有 kafka, zookeeper, 使用这个role安装的话，就得将变量写在playbook当中

如果各主机配置上有些差异，就没法做区分了，因为变量名是相同的。

变量名不同时，可以在各主机或各组内定义变量，来达到差异化配置的目的。

  • https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#id13: ansible 变量优先级说明

对此，有如下方案。

方案一

  1. 在vars目录下，分别为各app定义各自的变量文件;
  2. 运行时，使用include_vars加载各自的变量，实现相应的需求。
  3. 即使是这种方案，也需要至少一个变量定义在入口处
    • app_base_name: 这个是用来选择加载变量和特殊任务的入口。没有这个，仍然是不行的。

方案二

比如对于kibana, 定义一个 kibana_install 的role,引用当前的role, 在kibana_install中将这些变量覆盖，好像软链一样。

方案三

在default中定义各app开头的命名的变量(如kibana_app_name)，再将其转换成app_开头的变量，从而使task正常运行。

当前采用这种方案。

examples

kibana

# group_vars
kibana_packet: '{{packet_base_dir}}/elasticsearch/kibana-7.15.2-linux-x86_64.tar.gz'
kibana_conf_files:
  - "kibana/node.options"
  - "kibana/kibana.yml"

kibana_run_user: kibana
kibana_boot_type: systemd
kibana_src_boot_file: 'kibana/kibana.{{app_boot_type}}'
# 想让app在配置文件发生更改时，就定义如下变量，此类变量一共有4个
kibana_conf_file_handler: app_systemd_restarted

# playbook
- hosts: sw_es_kibana
  roles:
    - role: common_app_install
      app_type_name: kibana

jmx_exporter

# group_vars
jmx_exporter_packet: '{{packet_base_dir}}/jmx_exporter/jmx_prometheus_javaagent-0.16.1.jar'
jmx_exporter_conf_files:
  - jmx_exporter/tomcat_jmx.yml
jmx_exporter_run_user: biyao


# playbook
- hosts: tomcat
  roles:
    - role: common_app_install
      app_type_name: jmx_exporter

example 2

- hosts: kafka
  roles:
  - role: common_app_install
    app_type_name: jmx_exporter
    jmx_exporter_packet: '{{packet_base_dir}}/jmx_exporter/jmx_prometheus_javaagent-0.17.2.jar'
    jmx_exporter_base_dir: '/opt/server/jmx_exporter'
    jmx_exporter_install_dir: '/opt/server/jmx_exporter'
    jmx_exporter_conf_dir: '/opt/conf/jmx_exporter'
    jmx_exporter_log_dir: '/opt/log/jmx_exporter'
    jmx_exporter_var_dir: ''
    jmx_exporter_data_dir: ''
    jmx_exporter_conf_files:
      - kafka_javaagent_jmx.yml

sw_agent skywalking-java-agent

# group_vars
sw_agent_packet: '{{packet_base_dir}}/skywalking/skywalking-agent-8.8.0.tgz'
sw_agent_run_user: biyao
sw_agent_conf_files:
  - sw_agent/agent.config
sw_agent_base_name: sw-agent


# playbook
- hosts: tomcat
  roles:
    - role: common_app_install
      app_type_name: sw_agent

metricbeat

# group_vars
metricbeat_packet: '{{packet_base_dir}}/elasticsearch/metricbeat-7.15.2-linux-x86_64.tar.gz'
metricbeat_conf_files:
  - metricbeat/metricbeat.yml
metricbeat_child_confs:
  - metricbeat/elasticsearch-xpack.yml
metricbeat_conf_file_handler:
  - app_systemd_restarted


# playbook
- hosts: sw_es
  roles:
    - role: common_app_install
      app_type_name: metricbeat

node_exporter

使用这个时，遇到了group_vars中的变量，覆盖了默认app_base_dir导致的错误。

role中的app_base_dir,指的是应用的基本目录, 在role中，此变量为all_app_base_dir。

- hosts: 192.168.1.2
  #remote_user: root
  roles:
    - role: common_app_install
      vars:
        app_type_name: node_exporter
        node_exporter_packet: /data/apps/soft/ansible/prometheus/node_exporter-1.3.1.linux-amd64.tar.gz

注意

多个role时的变量写法

错误的示例，这种情况下，变量app_type_name的值总是sw_agent。

- hosts: 10.9.98.201
  roles:
    - role: common_app_install
      vars:
        app_type_name: jmx_exporter
      tags:
        - install_jmx_exporter
    - role: common_app_install
      vars:
        app_type_name: sw_agent
      tags:
        - install_sw_agent

正确的写法:

- hosts: 10.9.98.201
  roles:
    - role: common_app_install
      app_type_name: jmx_exporter
      tags:
        - install_jmx_exporter
    - role: common_app_install
      app_type_name: sw_agent
      tags:
        - install_sw_agent

special_tasks 的执行时机问题

在部署metricbeat的时候，需要在复制配置文件之前，把安装目录下的modules.d复制到conf目录下。

但是这个任务在配置文件复制之后才引入，所以就出问题了。