码迷,mamicode.com
首页 > 其他好文 > 详细

【Ansible 文档】【译文】Ad-Hoc 命令介绍

时间:2017-10-19 15:06:28      阅读:218      评论:0      收藏:0      [点我收藏+]

标签:存在   ups   声明式   server   运行   ice   例子   python   rest   

Introduction To Ad-Hoc Commands Ad-Hoc命令介绍

下面的例子展示了如何使用 /usr/bin/ansible 来运行ad hoc任务。

什么是ad hoc命令?

一个ad hoc命令是一些我们可以非常快的打出,而不用为了后续的使用而保存。

在学习playbook语言之前,这是一个很好的位置来学习理解Ansible能做什么的基础 - ad-hoc命令也可以被用来快速做事情,这些事情没有必要写一个完整的playbook。

通常来说,Ansible真正的力量在于playbooks。为什么你使用ad-hoc任务而不是playbooks呢?

例如,在圣诞节的时候,你想要关闭实验室所有的电脑,你可以执行一行快速的命令,而无需写一个playbook。

对于配置管理和部署来说,你会使用 ‘/usr/bin/ansible-playbook’ 你在这里学习的概念也会适用playbook语言。

(关于 playbook 的更多信息,请参考 Playbooks )

如果你还没有阅读 Inventory文件 ,最好先看一看,然后我们继续往下。

Parallelism and Shell Commands 并行和shell命令

任意的例子。

让我们使用Ansible的命令行工具来重启所有的Atlanta的所有web服务器,每次启动十个。首先,让我们设置SSH-agent,以便记住我们的证书:

$ ssh-agent bash
$ ssh-add ~/.ssh/id_rsa

如果你不想使用ssh-agent,并且想要使用密码SSH代替keys,你可以使用--ask-pass(-k),但是最好是使用ssh-agent。

现在,在某个组中的服务器上运行命令,在这个例子中,组是atlanta,以10个并发进程执行:

$ ansible atlanta -a "/sbin/reboot" -f 10

/usr/bin/ansible将会默认使用你的帐号运行。如果你不想这个行为,传入-u <username。如果你想使用其他用户运行命令,如下所示:

$ ansible atlanta -a "/usr/bin/foo" -u username

你通常不会仅仅使用你的用户账户执行操作。如果你想要使用特权上升运行命令时:

$ ansible atlanta -a "/usr/bin/foo" -u username --become [--ask-become-pass]

如果你不是使用无密码特权上升方法(sudo/su/pfexec/doas等),使用 --ask-become-pass(-K)。这回交互式的提示你密码的使用。使用一个无密码设置会使得事情更加容易自动化,但这不是必要的。

become 不是root的用户使用 --become-user:

$ ansible atlanta -a "/usr/bin/foo" -u username --become-user otheruser [--ask-become-pass]

注意:
  很少的情况下,一些用户有安全规则,他们限制了他们的 sudo/pbrun/doas 环境中仅运行特定的命令。这和ansible的no-bootstrapping哲学不匹配,
  同时几百个模块不会预期工作。如果这样做,使用Ansible作为一个特殊账户,该账户应该没有这个限制。
  无需分享未授权用户的一种做法是使用Ansible Tower为Ansible把关,
  其可以持有一个SSH证书并且让某一个组织的成员按照自己的办法使用它,而不需要直接访问。

好了,这就是基础。如果你还没有阅读模式和组,先回去阅读模式吧。

 

上面的例子中指定的 -f 10 ,是使用10个进程同时操作。你可以在配置文件 Configuration file 中设置,而无需在这里。默认是5,是指非常小和保守的。你可能想要同时操作更多主机,适当调整这个是合适的。如果你有比fork值更多的主机数量,Ansible会自行协调, 只是花得时间会更长一点。尽管将这个值设置的高一点,只要Ansible机器能处理。

 

你也可以选择你要使用的Ansible模块。通常命令会包含一个 -m 指定模块名,默认的模块名是 ‘command‘ ,因此我们没有必要指定。后续我们会使用-m来运行其他模块About Modules

注意

  command 在远程主机指定一个命令模块不支持扩展shell语法,例如管道和重定向(shell变量仍然可用)。如果你的命令要求shell特有的语法,使用shell模块。阅读更多不同在 About Modules 

使用节点中shell命令执行模块,类似如下:

$ ansible raleigh -m shell -a echo $TERM

 

当使用Ansible ad-hoc 命令行(与playbooks相对) 运行任意命令,特别注意shell的引号规则,因此上述例子中,在传递给Ansible之前,本地shell没有将变量转化为本机变量值。例如,使用双引号代替单引号,$TERM变量将被本地shell计算,而不是远端主机的变量。

 

到目前为止,我们简单的举例command执行,但是大多数Ansible模块不是简单的命令脚本。相反,他们使用声明式的模型,计算和执行达到最终状态的的动作。更进一步,通过在模块开始之前检查当前的状态,如果当前状态是最终状态,不做任何事情,这样的话模块就是一个幂等的形式。但是我们也认识到,能运行任意命令也是重要的,所以Ansible对俩者都支持。

File Transfer 文件传输

这是 /usr/bin/ansible 的另外一种用法。Ansible能够以并行的方式同时SCP大量的文件到多台机器。命令如下:

$ ansible atlanta -m copy -a "src=/etc/hosts dest=/tmp/hosts"

若你使用playbooks,则可以利用template模块来做到更进一步的事情, (See module and playbook documentation)。

file模块允许更改文件的属主和权限。相同的选项也可以传入copy模块:

$ ansible webservers -m file -a "dest=/srv/foo/a.txt mode=600"
$ ansible webservers -m file -a "dest=/srv/foo/b.txt mode=600 owner=mdehaan group=mdehaan"

file模块也可以创建目录,类似于“mkdir -p”:

$ ansible webservers -m file -a "dest=/path/to/c mode=755 owner=mdehaan group=mdehaan state=directory"

递归的删除目录和文件

$ ansible webservers -m file -a "dest=/path/to/c state=absent"

Managing Packages 管理包

Ansible 提供对 yum 和 apt 的支持。这里是关于 yum 的示例。

确保一个包已经被安装,但是不更新:

$ ansible webservers -m yum -a "name=acme state=present"

确保一个包安装了并且是指定版本:

$ ansible webservers -m yum -a "name=acme-1.5 state=present"

确保一个包是最新的版本:

$ ansible webservers -m yum -a "name=acme state=latest"

确保一个包没有被安装:

$ ansible webservers -m yum -a "name=acme state=absent"

对于不同平台的软件包管理工具,Ansible都有对应的模块。如果没有,你也可以使用 command 模块去安装软件。或者最好是来为那个软件包管理工具贡献一个相应的模块。请在 mailing list 中查看相关的信息和详情。

Users and Groups 用户和组

“user” 模块可以很容易的操作已存在的用户帐号,和移除已存在的用户帐号

$ ansible all -m user -a "name=foo password=<crypted password here>"

$ ansible all -m user -a "name=foo state=absent"

查看 About Modules部分获取所有变量的详细细节,包含如何操作组和组关系。

Deploying From Source Control 从源码控制系统部署

直接从git中部署你的webapp

$ ansible webservers -m git -a "repo=https://foo.example.org/repo.git dest=/srv/myapp version=HEAD"

因为Ansible模块可以通知change handlers,所以告知Ansible,当代码更新的时候执行指定任务,例如直接从git中部署Perl/Python/PHP/Ruby,并且重启apache。

Managing Services 管理服务

确保服务在所有的web服务器是启动的:

$ ansible webservers -m service -a "name=httpd state=started"

可选地,在所有的web服务器上重启一个服务:

$ ansible webservers -m service -a "name=httpd state=restarted"

确保一个服务是停止的:

$ ansible webservers -m service -a "name=httpd state=stopped"

Time Limited Background Operations 限制后台操作的时间

长时间运行的操作可以在后台运行,并且可以在后续检查它们的状态。例如为了在后台异步的执行long_running_operation,设置超时时间为3600秒(-B),且不需要轮询状态(-P):

$ ansible all -B 3600 -P 0 -a "/usr/bin/long_running_operation --do-stuff"

如果你决定要检查job状态,你可以使用 async_status模块,传递jobid给它,这个job id当你后台运行job时会返回给你:

$ ansible web1.example.com -m async_status -a "jid=488359678239.2844"

轮询是内建的,看起来像这样:

$ ansible all -B 1800 -P 60 -a "/usr/bin/long_running_operation --do-stuff"

其中 -B 1800 表示最多运行30分钟, -P 60 表示每隔60秒获取一次状态信息。

轮询模式是智能的,因此在任何机器上所有的job会在轮询之前启动。确保使用一个足够大的 --forks 值,如果你想要使所有的job快速的启动。在-B指定的时间用尽时,这个过程在远程节点上将会停止。

通常,你只会把后台长时间运行的shell命令或者软件升级。copy 模块后台化并不会做一个后台的文件拷贝(不像你想要的那样)。 Playbooks 同样支持轮询,并且有一个简化的语法。

 

Gathering Facts 收集Facts

facts在playbooks部分描述,其代表了某一个主机系统上发现的变量集。这些可以被用做任务的条件执行,也可以获取关于你系统的ad-hoc信息。你可以查看所有的facts通过如下方式:

$ ansible all -m setup

我们也可以对这个命令的输出做过滤,只输出特定的一些 facts,详情请参考 “setup” 模块的文档。

Read more about facts at Variables once you’re ready to read up on Playbooks.

 

【Ansible 文档】【译文】Ad-Hoc 命令介绍

标签:存在   ups   声明式   server   运行   ice   例子   python   rest   

原文地址:http://www.cnblogs.com/pengyusong/p/7691504.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!