From 8ef5df72f0b88bb061d15632daeb69c634dcee40 Mon Sep 17 00:00:00 2001 From: jaywcjlove <398188662@qq.com> Date: Thu, 29 Feb 2024 11:29:15 +0800 Subject: [PATCH] doc: update docs/ansible.md #535 --- docs/ansible.md | 31 +++++++++++++++++-------------- 1 file changed, 17 insertions(+), 14 deletions(-) diff --git a/docs/ansible.md b/docs/ansible.md index bcbf4497fba..13140973423 100644 --- a/docs/ansible.md +++ b/docs/ansible.md @@ -140,7 +140,7 @@ $ ansible target -m copy -a "src=/tmp/seq dest=/tmp/seq" ### Ansible 命令帮助 -```bash +```shell $ ansible $ ansible [options] ``` @@ -171,6 +171,7 @@ $ ansible [options] `--vault-password-file=VAULT_PASSWORD_FILE` | 保险库密码文件 `-v`, `--verbose` | 详细模式(-vvv 更多，-vvvv 启用连接调试) `--version` | 显示程序的版本号并退出 + 控制谁以及如何连接到主机，连接选项： @@ -182,24 +183,26 @@ $ ansible [options] `-c CONNECTION`, `--connection=CONNECTION` | 要使用的连接类型 (default=smart) `-T TIMEOUT`, `--timeout=TIMEOUT` | 以秒为单位覆盖连接超时 (default=10) `--ssh-common-args=SSH_COMMON_ARGS` | 指定要传递给 sftp/scp/ssh 的常用参数 (e.g. ProxyCommand) -`--sftp-extra-args=SFTP_EXTRA_ARGS` | 指定仅传递给 sftp 的额外参数 (e.g. -f, -l) +`--sftp-extra-args=SFTP_EXTRA_ARGS` | 指定仅传递给 `sftp` 的额外参数 (e.g. -f, -l) `--scp-extra-args=SCP_EXTRA_ARGS` | 指定仅传递给 `scp` 的额外参数 (e.g. -l) `--ssh-extra-args=SSH_EXTRA_ARGS` | 指定仅传递给 `ssh` 的额外参数 (e.g. -R) + 控制您成为目标主机上的用户的方式和用户，特权升级选项： :- | - :- | - -`-s`, `--sudo` | 使用 sudo (nopasswd) 运行操作(已弃用，使用 become) -`-U SUDO_USER`, `--sudo-user=SUDO_USER` | 所需的 sudo 用户(默认=root)(已弃用，使用 become) -`-S`, `--su` | 使用 su 运行操作(已弃用，使用 become) -`-R SU_USER`, `--su-user=SU_USER` | 以该用户身份使用 su 运行操作(默认 = root)(已弃用，使用 become) +~~`-s`~~, ~~`--sudo`~~ | 使用 sudo (nopasswd) 运行操作(已弃用，使用 become) +~~`-U SUDO_USER`~~, ~~`--sudo-user=SUDO_USER`~~ | 所需的 sudo 用户(默认=root)(已弃用，使用 become) +~~`-S`~~, ~~`--su`~~ | 使用 su 运行操作(已弃用，使用 become) +~~`-R SU_USER`~~, ~~`--su-user=SU_USER`~~ | 以该用户身份使用 su 运行操作(默认 = root)(已弃用，使用 become) `-b`, `--become` | 使用 become 运行操作(不暗示密码提示) -`--become-method=BECOME_METHOD` | 要使用的权限提升方法(默认=sudo)，有效选择：[ sudo | su | pbrun | pfexec | runas | doas | dzdo ] +`--become-method=BECOME_METHOD` | 要使用的权限提升方法(默认=sudo)，有效选择：\[ `sudo` \| `su` \| `pbrun` \| `pfexec` \| `runas` \| `doas` \| `dzdo` \] `--become-user=BECOME_USER` | 以该用户身份运行操作(默认=root) -`--ask-sudo-pass` | 询问 sudo 密码(已弃用，使用 become) -`--ask-su-pass` | 询问 su 密码(已弃用，使用 become) +~~`--ask-sudo-pass`~~ | 询问 sudo 密码(已弃用，使用 become) +~~`--ask-su-pass`~~ | 询问 su 密码(已弃用，使用 become) `-K`, `--ask-become-pass` | 要求提权密码 + ### Ansible Galaxy 工具 @@ -233,8 +236,6 @@ $ ansible-galaxy init --offline ``` - - ### ansible-doc 在本地访问文档 @@ -412,8 +413,9 @@ $ ansible-pull -U [options] ### ansible常用模块 + - ansible的模块已经高达3000+之多。但是个人在日常工作中，比较常见的大约20多个 +`Ansible` 的模块已经高达 `3000+` 之多。但是个人在日常工作中，比较常见的大约 `20` 多个 ```bash $ ansible-doc --list #查询所有模块 @@ -432,14 +434,15 @@ $ ansible [options] # 标准使用方式 | script | 管理端一个脚本，然后在远程服务器上执行 | `ansible all -m script -a '/root/time.sh'` | | file | 主要用于远程主机上的文件和目录操作 | `ansible all -m file -a "path=/root/rsync.password mode=600 state=touch"` | | cron | 管理执行任务计划模块（增删改查） | `ansible all -m cron -a "name='test a job' user=root job='/bin/sh /server/scripts/test.sh' minute=* hour=* day=* month=* weekday=*"` | -| yum | RedHat和CentOS的软件包安装和管理 | `安装
ansible all -m yum -a "name=httpd state=present"
ansible all -m yum -a "name=httpd state=installed"
卸载
ansible all -m yum -a "name=httpd state=absent"
ansible all -m yum -a "name=httpd state=removed"` | -| service和systemd | 用于管理远程主机的服务 | `ansible all -m systemd -a "name=httpd state=started enabled=yes"
ansible all -m systemd -a "name=httpd state=restarted"` | +| yum | RedHat和CentOS的软件包安装和管理 | 安装
`ansible all -m yum -a "name=httpd state=present"`
`ansible all -m yum -a "name=httpd state=installed"`
卸载
`ansible all -m yum -a "name=httpd state=absent"`
`ansible all -m yum -a "name=httpd state=removed"` | +| `service`和`systemd` | 用于管理远程主机的服务 | `ansible all -m systemd -a "name=httpd state=started enabled=yes"`
`ansible all -m systemd -a "name=httpd state=restarted"` | | user | useradd, userdel, usermod | `ansible all -m user -a 'name=haha remove=no state=absent'` | | group | groupadd, groupdel, groupmod | `ansible all -m group -a 'name=mygroup state=absent'` | | setup | 可收集远程主机的facts变量的信息 | `ansible all -m setup -a 'filter=ansible_default_ipv4'` | | authorized_key | 为特定的用户账号添加或删除 SSH authorized keys | `ansible all -m authorized_key -a "user=root key='{{lookup('file','/root/.ssh/id_rsa.pub')}}' path=/root/.ssh/authorized_keys manage_dir=no"` | | replace | 和 sed 命令比较类似，用于正则匹配和替换 | `ansible all -m replace -a "path=/etc/fstab regexp=^(UUID.*) replace='#\1'"` | | lineinfile | 正则匹配，更改某个关键参数值 | `ansible all -m lineinfile -a "path=/etc/selinux/config regexp='^SELINUX=' line='SELINUX=disabled'"` | + 另见 ---