ansbile-playbook ist eine Sammlung von System-Ansible-Befehlen, die in der Yaml-Sprache geschrieben sind und den Prozess ausführen. Die ansbile-playbook-Befehle werden in einer Top-Down-Reihenfolge ausgeführt. Gleichzeitig bietet Playbook viele Funktionen, mit denen Sie den Status eines bestimmten Befehls auf einen nachfolgenden Befehl übertragen können. Sie können beispielsweise Inhalte aus einer Datei auf einem Computer abrufen und als Variable anhängen und dann verwenden Es ermöglicht Ihnen, einige komplexe Bereitstellungsmechanismen zu implementieren, die mit Ansible-Befehlen nicht möglich sind.
Playbook wird über den Befehl ansible-playbook verwendet, z. B. die Parameter -k (–ask-pass) und -K (–ask-sudo), um nach dem SSH-Passwort zu fragen sudo-Passwort und -u zur Angabe des Benutzers. Diese Anweisungen können auch über vorgeschriebene Einheiten in das Playbook geschrieben werden. Einfache Verwendung von ansible-playbook: ansible-playbook example-play.yml.
Im Folgenden finden Sie ein einfaches Beispiel für ein Ansible-Playbook, um dessen Zusammensetzung zu verstehen.
# cat user.yml - name: create user hosts: all user: root gather_facts: false vars: - user: "test" tasks: - name: create user user: name="{{ user }}"
Die durch das obige Playbook implementierte Funktion besteht darin, einen neuen Benutzer hinzuzufügen:
Der Namensparameter bietet einen Überblick über die vom Playbook implementierten Funktionen. Bei der anschließenden Ausführung wird der Wert der Namensvariablen ausgegeben
Der Parameter „hosts“ gibt an, an welchen Hosts teilgenommen werden sollDer Benutzerparameter gibt den Benutzer an, der für die Anmeldung beim Remote-Host verwendet werden soll
Der Parameter „gather_facts“ gibt an, ob das Setup-Modul ausgeführt werden soll, um hostbezogene Informationen zu erhalten, bevor die folgenden Aufgaben ausgeführt werden. Dies wird verwendet, wenn nachfolgende Aufgaben die durch das Setup erhaltenen Informationen verwendenDer Parameter vars gibt eine Variable an, deren Wert test ist. Es ist zu beachten, dass der Variablenwert in Anführungszeichen gesetzt werden muss
task gibt eine Aufgabe an, und der Name-Parameter darunter ist auch eine Beschreibung der Aufgabe, die während der Ausführung gedruckt wird. Der Benutzer gibt den Aufruf des Benutzermoduls an, der Name ist ein Parameter im Benutzermodul und der hinzugefügte Benutzername ruft den Wert der obigen Benutzervariablen auf. Die spezifischen Ausführungsergebnisse lauten wie folgt:
[root@361way playbooks]# ansible-playbook user.yml PLAY [create user] ************************************************************ TASK: [create user ] ********************************************** changed: [10.212.52.252] changed: [10.212.52.14] changed: [10.212.52.16] PLAY RECAP ******************************************************************** 10.212.52.14 : ok=1 changed=1 unreachable=0 failed=0 10.212.52.16 : ok=1 changed=1 unreachable=0 failed=0 10.212.52.252 : ok=1 changed=1 unreachable=0 failed=0
user: name="{{ user }}" state=absent remove=yes
2. Ein-Klick-Patching-Bash-Shellcode-Beispiel
Geben Sie uns ein etwas komplizierteres Beispiel: Verwenden Sie ansible-playbook, um gleichzeitig Bash-Shellcode-Schwachstellen auf N-Hosts zu schließen. Es ist zu beachten, dass es im bestehenden Netzwerk zu unterschiedlichen Systemversionen kommen kann, die auf die Hosts verteilt sind. Es wird hier davon ausgegangen, dass die Versionen Centos5 und 6 gleichzeitig im bestehenden Netzwerk vorhanden sind. Der spezifische Playbook-Inhalt lautet wie folgt:
# cat update_bash.yml - hosts: all remote_user: root gather_facts: True tasks: - name: update bash in redhat 6 version yum: name=http://mirrors.aliyun.com/centos/6.6/os/x86_64/Packages/bash-4.1.2-29.el6.x86_64.rpm.rpm state=present when: ansible_os_family == "RedHat" and ansible_distribution_version|int >=6 - name: update bash in redhat 5 version yum: name=http://mirrors.hustunique.com/centos/5/updates/x86_64/RPMS/bash-3.2-33.el5.1.x86_64.rpm state=present when: ansible_os_family == "RedHat" and ansible_distribution_version|int <strong>Die when-Anweisung wird oben verwendet und das Gather_Facts-Setup-Modul ist ebenfalls aktiviert. Die Variablen ansible_os_family und ansible_distribution_version sind hier die Informationen, die direkt vom Setup-Modul abgerufen werden. </strong>
3. Die Zusammensetzung des Spielbuchs
playbook是由一个或多个“play”组成的列表。play的主要功能在于将事先归并为一组的主机装扮成事先通过ansible中的task定义好的角色。从根本上来讲所谓task无非是调用ansible的一个module。将多个play组织在一个playbook中即可以让它们联同起来按事先编排的机制同唱一台大戏。其主要有以下四部分构成
而其对应的目录层为五个,如下:
下面介绍下构成playbook 的四层结构。
playbook中的每一个play的目的都是为了让某个或某些主机以某个指定的用户身份执行任务。
hosts 用于指定要执行指定任务的主机其可以是一个或多个由冒号分隔主机组。
remote_user 则用于指定远程主机上的执行任务的用户。
不过remote_user也可用于各task中。也可以通过指定其通过sudo的方式在远程主机上执行任务其可用于play全局或某任务。
此外甚至可以在sudo时使用sudo_user指定sudo时切换的用户。
示例:
- hosts: webnodes tasks: - name: test ping connection: remote_user: test sudo: yes
play的主体部分是task list。
task list中的各任务按次序逐个在hosts中指定的所有主机上执行即在所有主机上完成第一个任务后再开始第二个。在运行自下而下某playbook时如果中途发生错误所有已执行任务都将回滚因此在更正playbook后重新执行一次即可。
task的目的是使用指定的参数执行模块而在模块参数中可以使用变量。模块执行是幂等的这意味着多次执行是安全的因为其结果均一致。每个task都应该有其name用于playbook的执行结果输出建议其内容尽可能清晰地描述任务执行步骤。如果未提供name则action的结果将用于输出。
定义task的可以使用“action: module options”或“module: options”的格式推荐使用后者以实现向后兼容。如果action一行的内容过多也中使用在行首使用几个空白字符进行换行。
tasks: - name: make sure apache is running service: name=httpd state=running 在众多模块中只有command和shell模块仅需要给定一个列表而无需使用“key=value”格式例如 tasks: - name: disable selinux command: /sbin/setenforce 0 如果命令或脚本的退出码不为零可以使用如下方式替代 tasks: - name: run this command and ignore the result shell: /usr/bin/somecommand || /bin/true 或者使用ignore_errors来忽略错误信息 tasks: - name: run this command and ignore the result shell: /usr/bin/somecommand ignore_errors: True
用于当关注的资源发生变化时采取一定的操作。
“notify”这个action可用于在每个play的最后被触发这样可以避免多次有改变发生时每次都执行指定的操作取而代之仅在所有的变化发生完成后一次性地执行指定操作。
在notify中列出的操作称为handler也即notify中调用 handler中定义的操作。
注意:在 notify 中定义内容一定要和tasks中定义的 - name 内容一样,这样才能达到触发的效果,否则会不生效。
- name: template configuration file template: src=template.j2 dest=/etc/foo.conf notify: - restart memcached - restart apache handler是task列表这些task与前述的task并没有本质上的不同。 handlers: - name: restart memcached service: name=memcached state=restarted - name: restart apache service: name=apache state=restarted
tags用于让用户选择运行或略过playbook中的部分代码。ansible具有幂等性因此会自动跳过没有变化的部分即便如此有些代码为测试其确实没有发生变化的时间依然会非常地长。
此时如果确信其没有变化就可以通过tags跳过此些代码片断。
下面再给出一个安装httpd web服务的示例:
# cat /etc/ansible/playbook/install_web.yml - hosts: webservers remote_user: root gather_fasks: False vars: packages: httpd tasks: - name: Install httpd yum: name={{ packages }} state=present - name: Cofiguration httpd copy: src=/root/httpd.conf dest=/etc/httpd/conf/httpd.conf tags: httpd_conf notify: - restart httpd - name: Start httpd service: name=httpd state=started enabled=no tags: start - name:Add centos user user: name={{ item }} state=absent tags: adduser with_items: - centos - admin handlers: - name: restart httpd service: name=httpd state=restart
注:上面的代码没有考虑ubuntu平台,仅仅考虑centos/redhat平台。
Das obige ist der detaillierte Inhalt vonAnsible-Nutzung: Einfache Verwendung von Ansible-Playbook. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!