GoAnsible

使用golang 编写，实现 ansible playbook 部分功能，安装起来更简单，目的不在于替换ansible，而是代替某些复杂shell脚本（特别多机部署）。

编译


cd cmd/playbook/

go build -v

使用

运行playbook


playbook --workdir <your playbook dir> --tag <your tag1>,<your tag2>

运行批量命令

playbook run <group name> "<shell command>" [--workdir <your inventory dir>]

Host

host1 ansible_ssh_host=192.168.2.130 ansible_ssh_user=root ansible_ssh_pass=********** ansible_ssh_key=/root/.ssh/id_rsa
host2 ansible_ssh_host=192.168.2.132 ansible_ssh_user=root ansible_ssh_pass=********** ansible_ssh_key=/root/.ssh/id_rsa

[test]
host1 k8s_master=yes
host2

Playbook

- name: import playbook
  import_playbook: common.yaml

- name: test
  hosts: test
  vars:
    cluster_join_script: ""
    tests:
      - a: adddd
        b: b
      - a: c
        b: e
  include_values:
    - Values.yaml
  tasks:
    - name: debug value file
      shell: echo nnnn
      debug: "{{.Values.value_file}},{{ $test := index .Values.tests 0 }} {{ $test.a }}"
    - name: Copy file
      file:
        src: file.yaml
        dest: /root/file.yaml
    - name: test shell
      shell: echo {{ .HostVars.ansible_ssh_host }} > b.yml
    - name: stdout shell
      shell: echo {{ .HostVars.ansible_ssh_host }}
      stdout: hostvars.ip
    - name: stdout res
      shell: echo {{ .HostVars.ip }} > a.yaml
    - name: test when
      shell: echo hello > a.yaml
      when: hostvars.k8s_master
    - name: test template
      template:
        src: tpl.yaml
        dest: /root/tpl.yaml
    - name: get script
      shell: kubeadm token create --print-join-command
      stdout: values.cluster_join_script
      when: hostvars.k8s_master
    - name: stdout res
      shell: echo {{ .Values.cluster_join_script }} > join.yaml
      when: hostvars.k8s_master
    - name: regexp
      regexp:
        src: abrrrc
        exp: a(b{1})r(r{2})c
        dst: values.reg.ddd
      debug: "{{.Values.reg.ddd }}"
      
    - name: loop
      shell: echo "hello"
      loop:
        - a
        - b
    - name: loop 2
      shell: echo {{ .Item.a }} >> loop.yaml
      loop: values.tests
    - name: test ignore error
      shell: testddd
      ignore_error: true
    - name: setface
      setface: values.face=success
    - name: until 
      until:
        port: 3000
        timeout: 10
    - name: include tasks
      include: include.yaml

使用教程

goansible playbook格式跟 ansible playbook非常相似，但 goansible 没有role 功能，模板由 jinja2 变为 go 的template；inventory 格式和ansible 格式是差不多。在运行方面，goansible 默认以 index.yaml 作为入口，hosts 作为inventory。

playbook

- name: import playbook
  import_playbook: import.yaml
  tag: tag1,tag2

- name: example playbook
  hosts: test
  vars:
    d: b
  include_values:
    - values.yaml
  tasks:
    - name: echo
      shell: echo helloworld

上面例子描述了一playbook 结构：

name: playbook 的名字，这是可以随便取
import_playbook：导入另一个playbook 内容
hosts：主机，目前仅支持 group name
vars: 自定义变量
include_values：使用包含自定义变量文件，这个跟vars 合并，并重复的话会覆盖vars
tasks：包含一组任务
tag：标签过滤，多个标签使用","分割，

task

- name: shell command
  shell: echo helloword > hello
- name: copy file
  file:
    src: test.file
    dest: /tmp/test.file
- name: parse template file
  template:
    src: test.tpl
    dest: /tmp/test.tpl

一、变量和函数

goansible 分为三种种变量，一种全局变量values; 一种是主机变量hostvars；还有当前组所有主机变量groupvars （hostvars 是 groupvars 一个成员）。

在模板中使用：{{ .Values.xxx }}、 {{ .HostVars.xxx }}、 {{ .GroupVars.hostname.xxx }}

在赋值中使用： values.xxx、 hostvars.xxx 、groupvars.hostname.xxx

goansible 内置部分函数：

join: 将数组合并成字符串，{{ join .Values.testArray "," }}
join_groupvars: 将某个组里hostvar合并成字符串，{{ join_groupvars .GroupVars ansible_ssh_host ","}}
plus: 加，{{ plus .Values.a .Values.b }}
minus: 减，{{ minus .Values.a .Values.b }}

二、循环


- name: loop
  shell: echo {{ .Item }}
  loop:
    - a
    - b
- name: loop values
  shell: echo {{ .Item.xxx }}
  loop: values.loops

三、条件

- name: when
  shell: echo "I am master"
  when: hostvars.k8s_master

四、获取执行结果


- name: stdout
  shell: echo "stdout result"
  stdout: hostvars.stdout

五、打印变量

- name: stdout
  shell: echo "stdout result"
  stdout: hostvars.stdout
  debug: {{ .hostvars.stdout }}

六、忽略错误


- name: stdout
  shell: errcmd
  ignore_error: true

七、包含其他task文件

- name: include task
  include: task.yaml

八、标签

- name: tag test
  shell: do something
  tag: tag1,tag2

运行时设置标签：

./playbook -tag tag1,tag2

九、操作

1、shell

- name: shell command
  shell: echo helloword > hello

- name: 使用变量模板
  shell: echo {{ .Values.test }}

shell: 执行的命令

2、file

- name: copy file
  file:
    src: test.file
    dest: /tmp/test.file
    mode: "0644"
    owner: root
    group: root

复制文件到目标机器

src: 源文件（本地文件）路径
dest: 目标文件路径
mode: 文件权限，默认0644
owner: 文件用户，默认ssh 用户
group: 文件用户组，默认ssh 用户组

3、template

- name: copy file
  template:
    src: test.file
    dest: /tmp/test.file
    mode: "0755"
    owner: root
    group: root

根据模板生成文件，并复制文件到目标机器

src: 源文件（本地文件）路径
dest: 目标文件路径
mode: 文件权限，默认0644
owner: 文件用户，默认ssh 用户
group: 文件用户组，默认ssh 用户组

4、directory


- name: directory
  directory:
    path: /tmp/456
    mode: "0755"
    owner: root
    group: root

新建文件夹

path: 文件夹路径
mode: 文件权限，默认0755
owner: 文件用户，默认ssh 用户
group: 文件用户组，默认ssh 用户组

5、regexp


- name: regexp
  regexp:
    src: abrrrc
    exp: a(b{1})r(r{2})c
    dst: values.reg.ddd


- name: regexp
  regexp:
    src: abrrrc
    exp: ","
    dst: values.reg.ddd
    split: true

根据正则表达式匹配分割，并保存结果到变量中

src: 源字符串
exp: 正则表达式
dst: 保存结果变量名
split: 分割

6、until

- name: demo until
  until:
    shell: "ss -lnp|awk '{print $5}'|grep  -n :3000$"
    match: ".+"
    timeout: 300
    interval: 10

循环执行命令，直到匹配到结果

shell: 执行shell命令
match: 对执行的命令输出结果匹配的正则表达式
timeout: 超时时间，默认300s
interval: 循环执行命令间隔，默认5s

# README