Ansible

Ansible version : 2.6.2

常用模塊（三）

系統(tǒng)模塊

系統(tǒng)模塊詳細地址：https://docs.ansible.com/ansible/latest/modules/list_of_system_modules.html

• cron
• hostname
• ping
• user
• service
• systemd

模塊：cron

概述

• 【cron】模塊管理crontab和環(huán)境變量條目。允許創(chuàng)建環(huán)境變量和命名的crontab條目，更新或刪除它們。
• 管理環(huán)境變量時：不添加注釋行，但當(dāng)模塊需要查找/檢查狀態(tài)時，使用name參數(shù)來查找環(huán)境變量定義行。
• 管理crontab作業(yè)時，該模塊包含一行，其中包含crontab條目的描述為"#Ansible: <name>"或者對應(yīng)于傳遞給模塊的name將來Ansible /模塊調(diào)用都使用這個條目來查找/檢查狀態(tài)。name參數(shù)應(yīng)該是唯一的，更改name值將導(dǎo)致創(chuàng)建一個新的cron任務(wù)(或刪除另一個任務(wù))。
• 使用％等符號時，必須正確轉(zhuǎn)義它們。

參數(shù)

例子

playbook

指定時間執(zhí)行

- name: Ensure a job that runs at 2 and 5 exists. Creates an entry like "0 5,2 * * ls -alh > /dev/null"
  cron:
    name: "check dirs"
    minute: "0"
    hour: "5,2"
    job: "ls -alh > /dev/null"

刪除一個舊條目

- name: 'Ensure an old job is no longer present. Removes any job that is prefixed by "#Ansible: an old job" from the crontab'
  cron:
    name: "an old job"
    state: absent

重啟之后，執(zhí)行

- name: Creates an entry like "@reboot /some/job.sh"
  cron:
    name: "a job for reboot"
    special_time: reboot
    job: "/some/job.sh"

創(chuàng)建環(huán)境變量

- name: Creates an entry like "PATH=/opt/bin" on top of crontab
  cron:
    name: PATH
    env: yes
    value: /opt/bin

在聲明的指定變量之后

- name: Creates an entry like "APP_HOME=/srv/app" and insert it after PATH declaration
  cron:
    name: APP_HOME
    env: yes
    value: /srv/app
    insertafter: PATH

環(huán)境變量變量

- name: Removes "APP_HOME" environment variable from crontab
  cron:
    name: APP_HOME
    env: yes
    state: absent

模塊：hostname

概要

• 設(shè)置系統(tǒng)的主機名，支持大多數(shù)操作系統(tǒng)/分發(fā)，包括使用systemd的操作系統(tǒng)。
• 這個模塊不會修改/etc/hosts,可以使用【template】或者【replace】模塊修改。
• Windows, HP-UX ,AIX不支持。

參數(shù)

例子

playbook

- hostname:
    name: web01

模塊：ping

概要

• 這個模塊總是在成功之后返回pong。在playbook中毫無意義。但是在使用/usr/bin/ansible來確認登錄可用和配置了可用的python
• 這個不是IMCP的ping，只是遠端的python簡單的測試模塊
• 對于windows目標(biāo)，使用win_ping
• 對于網(wǎng)絡(luò)目標(biāo)，使用net_ping

參數(shù)

例子

playbook

設(shè)置data值為crash

# Induce an exception to see what happens
- ping:
    data: crash

返回值

模塊：user

概述

• 管理用戶賬戶和用戶屬性
• 對于windows主機，使用win_user模塊

參數(shù)

例子

創(chuàng)建指定uid以及主要的admin組的用戶

- name: Add the user 'johnd' with a specific uid and a primary group of 'admin'
  user:
    name: johnd
    comment: John Doe
    uid: 1040
    group: admin

追加組

- name: Add the user 'james' with a bash shell, appending the group 'admins' and 'developers' to the user's groups
  user:
    name: james
    shell: /bin/bash
    groups: admins,developers
    append: yes

刪除用戶

- name: Remove the user 'johnd'
  user:
    name: johnd
    state: absent
    remove: yes

創(chuàng)建2048位的ssh key

- name: Create a 2048-bit SSH key for user jsmith in ~jsmith/.ssh/id_rsa
  user:
    name: jsmith
    generate_ssh_key: yes
    ssh_key_bits: 2048
    ssh_key_file: .ssh/id_rsa

設(shè)置過期時間

- name: Added a consultant whose account you want to expire
  user:
    name: james18
    shell: /bin/zsh
    groups: developers
    expires: 1422403387

刪除過期時間

- name: starting at version 2.6, modify user, remove expiry time
  user:
    name: james18
    expires: -1

模塊：service

概述

• 控制遠程主機上的服務(wù)。支持的init系統(tǒng)包括BSD init，OpenRC，SysV，Solaris SMF，systemd，upstart。
• 對于Windows目標(biāo)，請改用【win_service】模塊。

參數(shù)

例子

如果沒啟動，則啟動服務(wù)

- name: Start service httpd, if not running
  service:
    name: httpd
    state: started

重啟服務(wù)

- name: Restart service httpd, in all cases
  service:
    name: httpd
    state: restarted

啟用服務(wù)

- name: Enable service httpd, and not touch the running state
  service:
    name: httpd
    enabled: yes

基于進程啟動

- name: Start service foo, based on running process /usr/bin/foo
  service:
    name: foo
    pattern: /usr/bin/foo
    state: started

帶參數(shù)重啟

- name: Restart network service for interface eth0
  service:
    name: network
    state: restarted
    args: eth0

模塊：systemd

概述

• 控制遠程主機上的systemd服務(wù)。

參數(shù)

注意

• 自從2.4開始，以下選項之一state，enabled，masked，daemon_reload，除daemon_reloa'之外的所有內(nèi)容都需要name。
• 在2.4之前，你總是需要name。

例子

起服務(wù)

- name: Make sure a service is running
  systemd:
    state: started
    name: httpd

重啟服務(wù)前先reload

- name: restart service cron on centos, in all cases, also issue daemon-reload to pick up config changes
  systemd:
    state: restarted
    daemon_reload: yes
    name: crond

強制重載配置

- name: just force systemd to reread configs (2.4 and above)
  systemd:
    daemon_reload: yes