Merge pull request #21183 from wxy/20200124-Ansible-Ad-hoc-Command-Quick-Start-Guide-with-Examples

PRF&PUB:20200124 ansible ad hoc command quick start guide with examples
This commit is contained in:
Xingyu.Wang 2021-02-28 22:38:52 +08:00 committed by GitHub
commit f4459a055d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,8 +1,8 @@
[#]: collector: "lujun9972"
[#]: translator: "MjSeven"
[#]: reviewer: " "
[#]: publisher: " "
[#]: url: " "
[#]: reviewer: "wxy"
[#]: publisher: "wxy"
[#]: url: "https://linux.cn/article-13163-1.html"
[#]: subject: "Ansible Ad-hoc Command Quick Start Guide with Examples"
[#]: via: "https://www.2daygeek.com/ansible-ad-hoc-command-quick-start-guide-with-examples/"
[#]: author: "Magesh Maruthamuthu https://www.2daygeek.com/author/magesh/"
@ -10,23 +10,19 @@
Ansible 点对点命令快速入门指南示例
======
之前,我们写了一篇有关 **[Ansible 安装和配置][1]**的文章。
![](https://img.linux.net.cn/data/attachment/album/202102/28/221449b8ldh7v4ll8dw774.jpg)
在那个教程中只包含了一些使用方法的示例。
之前,我们写了一篇有关 [Ansible 安装和配置][1] 的文章。在那个教程中只包含了一些使用方法的示例。如果你是 Ansible 新手,建议你阅读上篇文章。一旦你熟悉了,就可以继续阅读本文了。
如果你是 Ansible 新手,建议你阅读上篇文章
默认情况下Ansible 仅使用 5 个并行进程。如果要在多个主机上执行任务,需要通过添加 `-f [进程数]` 选项来手动设置进程数
一旦你熟悉了,就可以继续阅读本文了。
### 什么是<ruby>点对点<rt>ad-hoc</rt></ruby>命令?
默认情况下Ansible 仅使用 5 个并行进程。如果要在多个主机上执行任务,需要通过添加 **"-f [进程数]"** 选项来手动设置进程数。
### 什么是点对点 (ad-hoc) 命令?
点对点命令用于在一个或多个受控节点上自动执行任务。它非常简单,但是不可重用。它使用 **"/usr/bin/ansible"** 二进制文件执行所有操作。
点对点命令用于在一个或多个受控节点上自动执行任务。它非常简单,但是不可重用。它使用 `/usr/bin/ansible` 二进制文件执行所有操作。
点对点命令最适合运行一次的任务。例如,如果要检查指定用户是否可用,你可以使用一行命令而无需编写剧本。
### 为什么你要了解点对点命令?
#### 为什么你要了解点对点命令?
点对点命令证明了 Ansible 的简单性和强大功能。从 2.9 版本开始,它支持 3389 个模块,因此你需要了解和学习要定期使用的 Ansible 模块列表。
@ -37,82 +33,67 @@ Ansible 点对点命令快速入门指南示例
**点对点命令的一般语法:**
```
ansible | [pattern] | -m [module] | -a "[module options]"
A | B | C | D
ansible [模式] -m [模块] -a "[模块选项]"
```
点对点命令包含四个部分,详细信息如下:
```markdown
+-----------------+--------------------------------------------------+
| Details | Description |
+-----------------+--------------------------------------------------+
|ansible | 命令 |
|pattern | I输入清单或指定组 |
|module | 运行指定的模块名称 |
|module options | 指定模块参数 |
+-----------------+--------------------------------------------------+
```
| 部分 | 描述 |
|----------|-----------------------------------|
| `ansible`| 命令 |
| 模式 | 输入清单或指定组 |
| 模块 | 运行指定的模块名称 |
| 模块选项 | 指定模块参数 |
### 如何使用 Ansible 清单文件
#### 如何使用 Ansible 清单文件
如果使用 Ansible 的默认清单文件 **"/etc/ansible/hosts"**,你可以直接调用它
如果使用 Ansible 的默认清单文件 `/etc/ansible/hosts`,你可以直接调用它。否则你可以使用 `-i` 选项指定 Ansible 清单文件的路径。
如果没有默认文件,你可以使用 **"-i"** 选项调用 Ansible 清单文件的路径。
#### 什么是模式以及如何使用它?
### 什么是模式以及如何使用它?
Ansible 模式可以代指某个主机、IP 地址、清单组、一组主机或者清单中的所有主机。
它允许你对它们运行命令和剧本。模式非常灵活,你可以根据需要使用它们。
Ansible 模式可以代指某个主机、IP 地址、清单组、一组主机或者清单中的所有主机。它允许你对它们运行命令和剧本。模式非常灵活,你可以根据需要使用它们。
例如,你可以排除主机、使用通配符或正则表达式等等。
下表描述了常见的模式以及用法。但是,如果它不能满足你的需求,你可以在 ansible-playbook 中使用带有 **"-e"** 参数的模式中的变量。
下表描述了常见的模式以及用法。但是,如果它不能满足你的需求,你可以在 `ansible-playbook` 中使用带有 `-e` 参数的模式中的变量。
```
+-----------------------+------------------------------+-----------------------------------------------------+
| Description | Pattern(s) | Targets |
+-----------------------+------------------------------+-----------------------------------------------------+
|All hosts | all (or *) | Run an Ansible against all servers in your inventory|
|One host | host1 | Run an Ansible against only the given host. |
|Multiple hosts | host1:host2 (or host1,host2) | Run an Ansible against the mentioned multiple hosts |
|One group | webservers | Run an Ansible against the webservers group |
|Multiple groups | webservers:dbservers | all hosts in webservers plus all hosts in dbservers |
|Excluding groups | webservers:!atlanta | all hosts in webservers except those in atlanta |
|Intersection of groups | webservers:&staging | any hosts in webservers that are also in staging |
+-----------------------+------------------------------+-----------------------------------------------------+
```
| 描述 | 模式 | 目标 |
|-----|------|-----|
| 所有主机 | `all`(或 `*` | 对清单中的所有服务器运行 Ansible |
| 一台主机 | `host1` | 只针对给定主机运行 Ansible |
| 多台主机 | `host1:host2`(或 `host1,host2`| 对上述多台主机运行 Ansible |
| 一组 | `webservers` | 在 `webservers` 群组中运行 Ansible |
| 多组 | `webservers:dbservers` | `webservers` 中的所有主机加上 `dbservers` 中的所有主机 |
| 排除组 | `webservers:!atlanta` | `webservers` 中除 `atlanta` 以外的所有主机 |
| 组之间的交集 | `webservers:&staging` | `webservers` 中也在 `staging` 的任何主机 |
### 什么是 Ansible 模块,它干了什么?
#### 什么是 Ansible 模块,它干了什么?
模块,也称为“任务插件”或“库插件,它是一组代码单元,可以直接或通过剧本在远程主机上执行指定任务。
模块,也称为“任务插件”或“库插件”,它是一组代码单元,可以直接或通过剧本在远程主机上执行指定任务。
Ansible 在远程目标节点上执行指定模块并收集其返回值。
每个模块都支持多个参数,可以满足用户的需求。除少数模块外,几乎所有模块都采用 **"key=value"** 参数
每个模块都支持多个参数,可以满足用户的需求。除少数模块外,几乎所有模块都采用 `key=value` 参数。你可以一次添加带有空格的多个参数,而 `command``shell` 模块会直接运行你输入的字符串
你可以一次添加带有空格的多个参数command 或 shell 模块会直接运行你输入的字符串。
我们将添加一个包含最常用的”模块选项“参数的表。
我们将添加一个包含最常用的“模块选项”参数的表。
列出所有可用的模块,运行以下命令:
```bash
```
$ ansible-doc -l
```
运行以下命令来阅读指定模块的文档
运行以下命令来阅读指定模块的文档
```bash
$ ansible-doc [Module]
```
$ ansible-doc [模块]
```
### 1如何在 Linux 上使用 Ansible 列出目录的内容
可以使用 Ansible command 模块来完成这项操作,如下所示。我们列出了 **"node1.2g.lab"** 和 **"nod2.2g.lab"** 远程服务器上 **"daygeek"** 用户主目录的内容。
可以使用 Ansible `command` 模块来完成这项操作,如下所示。我们列出了 `node1.2g.lab``nod2.2g.lab`* 远程服务器上 `daygeek` 用户主目录的内容。
```bash
```
$ ansible web -m command -a "ls -lh /home/daygeek"
node1.2g.lab | CHANGED | rc=0 >>
@ -143,9 +124,9 @@ drwxr-xr-x. 2 daygeek daygeek 6 Nov 9 09:55 Videos
### 2如何在 Linux 使用 Ansible 管理文件
Ansible 的 "copy 模块" 将文件从本地系统复制到远程系统。使用 Ansible command 模块将文件移动或复制到远程计算机。
Ansible 的 `copy` 模块将文件从本地系统复制到远程系统。使用 Ansible `command` 模块将文件移动或复制到远程计算机。
```bash
```
$ ansible web -m copy -a "src=/home/daygeek/backup/CentOS7.2daygeek.com-20191025.tar dest=/home/u1" --become
node1.2g.lab | CHANGED => {
@ -189,7 +170,7 @@ node2.2g.lab | CHANGED => {
我们可以运行以下命令进行验证:
```bash
```
$ ansible web -m command -a "ls -lh /home/u1" --become
node1.2g.lab | CHANGED | rc=0 >>
@ -203,97 +184,97 @@ total 36K
-rw-rw-r--. 1 u1 u1 18 Jan 23 02:21 magi.txt
```
要将文件从一个位置复制到远程计算机上的另一个位置,使用以下命令
要将文件从一个位置复制到远程计算机上的另一个位置,使用以下命令
```bash
```
$ ansible web -m command -a "cp /home/u2/magi/ansible-1.txt /home/u2/magi/2g" --become
```
移动文件,使用以下命令:
```bash
```
$ ansible web -m command -a "mv /home/u2/magi/ansible.txt /home/u2/magi/2g" --become
```
**"u1"** 用户目录下创建一个名为 **"ansible.txt"** 的新文件,运行以下命令:
`u1` 用户目录下创建一个名为 `ansible.txt` 的新文件,运行以下命令:
```bash
```
$ ansible web -m file -a "dest=/home/u1/ansible.txt owner=u1 group=u1 state=touch" --become
```
**"u1"** 用户目录下创建一个名为 **"magi"** 的新目录,运行以下命令。**”file 模块还可以创建目录“**。
`u1` 用户目录下创建一个名为 `magi` 的新目录,运行以下命令:
```bash
```
$ ansible web -m file -a "dest=/home/u1/magi mode=755 owner=u2 group=u2 state=directory" --become
```
**"u1"** 用户目录下的 **"ansible.txt"** 文件权限更改为 **"777"**,运行以下命令:
`u1` 用户目录下的 `ansible.txt`* 文件权限更改为 `777`,运行以下命令:
```bash
```
$ ansible web -m file -a "dest=/home/u1/ansible.txt mode=777" --become
```
删除 **"u1"** 用户目录下的 **"ansible.txt"** 文件,运行以下命令:
删除 `u1` 用户目录下的 `ansible.txt` 文件,运行以下命令:
```bash
```
$ ansible web -m file -a "dest=/home/u2/magi/ansible-1.txt state=absent" --become
```
使用以下命令删除目录,它将递归删除指定目录
使用以下命令删除目录,它将递归删除指定目录
```bash
```
$ ansible web -m file -a "dest=/home/u2/magi/2g state=absent" --become
```
### 3) 用户管理
### 3用户管理
你可以使用 Ansible 轻松执行用户管理活动。例如创建、删除用户以及向一个组添加用户。
```bash
```
$ ansible all -m user -a "name=foo password=[crypted password here]"
```
运行以下命令删除用户:
```bash
```
$ ansible all -m user -a "name=foo state=absent"
```
### 4) 管理包
### 4管理包
使用合适的 Ansible 包管理器模块可以轻松地管理安装包。例如,我们将使用 yum 模块来管理 CentOS 系统上的软件包。
使用合适的 Ansible 包管理器模块可以轻松地管理安装包。例如,我们将使用 `yum` 模块来管理 CentOS 系统上的软件包。
安装最新的 Apache(httpd)
安装最新的 Apachehttpd
```bash
```
$ ansible web -m yum -a "name=httpd state=latest"
```
卸载 Apache(httpd) 包:
卸载 Apachehttpd 包:
```bash
```
$ ansible web -m yum -a "name=httpd state=absent"
```
### 5) 管理服务
### 5管理服务
使用以下 Ansible 模块命令可以在 Linux 上管理任何服务。
停止 httpd 服务:
```bash
```
$ ansible web -m service -a "name=httpd state=stopped"
```
启动 httpd 服务:
```bash
```
$ ansible web -m service -a "name=httpd state=started"
```
重启 httpd 服务:
```bash
```
$ ansible web -m service -a "name=httpd state=restarted"
```
@ -304,10 +285,10 @@ via: https://www.2daygeek.com/ansible-ad-hoc-command-quick-start-guide-with-exam
作者:[Magesh Maruthamuthu][a]
选题:[lujun9972][b]
译者:[MjSeven](https://github.com/MjSeven)
校对:[校对者ID](https://github.com/校对者ID)
校对:[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://www.2daygeek.com/author/magesh/
[b]: https://github.com/lujun9972
[1]: https://www.2daygeek.com/install-configure-ansible-automation-tool-linux-quick-start-guide/
[1]: https://linux.cn/article-13142-1.html