Skip to main content

Ansible FAQ

判断 file 存在​

block & when​

  • when 会在每个步骤都检测 - 满足则退出

block 不支持 loop​

  • 可以 loop + include_task

常用依赖组件​

modulepip
postgrespsycopg2
vaulthvac
dockerdocker
docker-composedocker-compose
libvirtlibvirt-python
k8sopenshift
# libvirt / CentOS / awx-task
yum install libvirt-devel gcc
pip3 install libvirt-python

# k8s / AlpineLinux
apk add py3-pip
pip3 install openshift

The lxml module is not importable. Check the requirements.​

apk add py3-lxml

include vs import​

建议
  • 需要 when 、循环、名字是变量时 使用 include
  • 除此之外都使用 import
# https://docs.ansible.com/ansible/latest/collections/ansible/builtin/include_tasks_module.html
- include_tasks: tests.yml
- include_tasks:
    file: tests.yml
  • import
    • 在解析时处理 - 静态
    • 建议用于逻辑单元 - 例如拆分长 playbook
    • 不能循环
    • 能够 --list-tags 和 --list-tasks
    • 可以导入 playbook
    • 使用 when 条件会被应用到所有导入的 tasks，大多数时候都是不期望的，使用 include
  • include
    • 在执行时处理 - 动态
    • 用于带条件的情况
    • 只有 include 才可以 include_tasks: prerequisites_{{ ansible_os_family | lower }}.yml
  • 参考

raw vs command vs shell​

  • shell - 由 /bin/sh 执行 - 因此能使用变量和一些语法
  • command - 直接执行 - 因此不能使用 <,>,|,; 等
  • raw - 由 ssh 直接执行，不依赖 python

psycopg2 ld: library not found for -lssl​

  • 路径来自于 pg_config --ldflags
env LDFLAGS='-L/usr/local/lib -L/usr/local/opt/openssl/lib -L/usr/local/opt/readline/lib' $(brew --prefix ansible)/libexec/bin/pip install psycopg2

winrm​

$(brew --prefix ansible)/libexec/bin/pip install "pywinrm>=0.3.0"

synchronize 不支持 ProxyCommand​

  • rsync 使用 jumphost 会有问题，可尝试 sshuttle 或者使用 copy
  • copy 比 rsync 慢 - 不会做差分
rsync -azv -e 'ssh -o "ProxyCommand ssh -A PROXYHOST -W %h:%p"' foo/ dest:./foo/
# ssh 7.4+
rsync -azv -e 'ssh -A -J USER@PROXYHOST:PORT' foo/ dest:./foo/
rsync_opts: '-e XXXXX'

使用 dotenv​

  • 更推荐使用变量或 vault
cat <<CONF > .env
export TENANT_NAME=test
CONF
# 注意使用 dotenv
# https://github.com/bkeepers/dotenv
dotenv ansible -m debug -a 'msg={{lookup("env","TENANT_NAME")}}' localhost

获取当前工作目录​

  • 角色等相关的目录都是相对于 playbook 的
- set_fact:
    # 如果是 git
    awd: "{{ lookup('pipe', 'git rev-parse --show-toplevel') }}"

json 文件作为变量​

- hosts: your_host
  vars:
    jsonVar: "{{ lookup('file', 'var.json') | from_json }}"
  tasks:
    - name: test loop
      with_dict: "{{ jsonVar['queue'] }}"
      shell: |
        if echo "blue" | grep -q "{{ item.value.color }}" ; then
            echo "success"
        fi

gitlab - got an unexpected keyword argument 'email'​

$(brew --prefix ansible)/libexec/bin/pip uninstall python-gitlab
# 需要低版本
$(brew --prefix ansible)/libexec/bin/pip install -U 'python-gitlab<1.13'

测试 docker 模块​

ansible -m docker_container -a 'name=test image=busybox' localhost

# 常规操作
pip uninstall docker-py
pip3 uninstall docker

pip3 install docker

macOS 使用 hasi_vault 安装 hvac 问题​

  • 安装其他包也是一样 - 例如 docker
# 当前使用的 python
ansible -m debug -a 'var=ansible_playbook_python' localhost
# 使用 ansible 下的 pip 安装
$(brew --prefix ansible)/libexec/bin/pip install hvac

# localhost | SUCCESS => {
#     "ansible_playbook_python": "/usr/local/Cellar/ansible/2.6.0/libexec/bin/python2.7"
# }
# source $(brew --prefix ansible)/libexec/bin/activate
# pip install hvac

2.9.0 使用 hashi_vault 返回结果结构不对​

# 因为返回了 metadata 和 data 还需要取需要的字段
ansible -m debug -a "msg={{lookup('hashi_vault', 'secret=secret/data/app:data').db_password}}" localhost
# consul 的 token
ansible -m debug -a "msg={{lookup('hashi_vault', 'secret=consul/creds/reader:token')}}" localhost

objc: +[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called.​

export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES

生成 UUID​

ansible localhost -m shell -a 'uuidgen'
ansible localhost -m debug -a 'msg="{{ansible_date_time.iso8601_micro | to_uuid}}"'

快速获取地址​

ansible -i hosts all -m setup
ansible -i k8s all -m debug -a 'msg={{ansible_default_ipv4.address}}'

has no attribute 'ansible_default_ipv4', 'address'​

此时需要从新收集主机信息,然后再继续之前操作

ansible -i hosts -m setup all

确保该操作成功,如果仍然还是出现没有address 的错误,那可能是由于 ansible 无法收集到默认地址,也需要确保 ifconfig 有地址.

Ansible 是使用 ip -4 route get 8.8.8.8 (参考这里)

  • 解决办法 参考 这里
    • 通过手动添加路由来尝试修改这个问题
    • 通过 set_facts 来覆盖配置
    • 通过定制 facts 来实现该配置

Java 环境不正确或没有​

因为安装部署是通过 SSH 进行操作,是非交互式的 SHELL, 可通过以下命令验证环境是否正确,

ssh user@host 'java -version'

可将所需的 JAVA 环境变量添加到 ~/.bashrc 的 最上面. 因为非交互式的启动脚本执行路径可能有所不同.

Aborting, target uses selinux but python bindings aren't installed!​

在执行时可能遇到以下错误

TASK [es : My Task] *****************************************
fatal: [host-1]: FAILED! => {"changed": false, "checksum": "4bd3ef681e70faefe3a66c6eb3419b5d4a0e2714", "failed": true, "msg": "Aborting, target uses selinux but python bindings (libselinux-python) aren't installed!"}

是由于开启了 SELinux, 但没有安装 Python 绑定库导致的, 只需要安装该库即可.

yum install libselinux-python

env 'python' no such file​

# 是因为找不到 python - 可能是因为使用的 python3
env python
# 确保 python3 存在
env python3
# 创建软链接
ln -s `which python3` /usr/bin/python

拆分主机到多个文件​

目录结构可以为

inventories/
  a.yaml
  b.yaml
  c.yaml
# 指向 inventories/ 作为仓库即可
ansible -i inventories/ all --list-hosts
# 需要的时候也可以单个指定
ansible -i inventories/a.yaml -i inventories/b.yaml all --list-hosts

目录结构也可以为 - 适用于不同环境区别较大的时候

inventories/
  a/
    hosts
  b/
    hosts

zfsprop was not present after being successfully set​

zfs 操作 temporary 的属性有问题