蚂蚁框架客户端
ants-client的Python项目详细描述
==
ants框架
==
==
…图片：：https://img.shields.io/pypi/v/ants嫒client.svg
：目标：https://pypi.python.org/pypi/ants嫒client/
：alt:最新版本
图片：：https://img.shields.io/pypi/l/ants嫒client.svg
：目标：https://pypi.python.org/pypi/ants嫒client/
：alt:license
……图片：：https://pyup.io/repos/github/ants framework/ants/shield.svg
：目标：https://pyup.io/repos/github/ants framework/ants/
：alt:updates
图片：：https://pyup.io/repos/github/ants framework/ants/python-3-shield.svg
：目标：https://pyup.io/repos/github/ants framework/ants/
：alt:python 3
ants是一个使用ansible pull管理和应用macos和linux主机配置的框架。
由"巴塞尔大学"的客户服务团队开发，https://www.unibas.ch/>；``uuuu`it services<；https://its.unibas.ch>；``uuu
，并在"GNU通用公共许可证版本3<；https://www.gnu.org/licenses/gpl-3.0.en.html>；``uu.
`ansible<；https：//docs.ansible.com/ansible/latest/index.html>；``是'red hat，inc.<；https://www.redhat.com>；``红帽
----
简介
-
-
蚂蚁框架由以下组件组成：
-ansible pull的包装器
-ansible动态清单脚本（ms-active directory connector）
-一个可以使用的模块化角色集合
-强大的日志集成
----
要求
-
此项目假定您熟悉"ansible"<；https://www.ansible.com/>；`\uu
，`git&以及外壳。
开始
开始
开始的开始
开始的开始
开始的开始
开始的开始
开始
**************************************
>使用pip安装Antant
************************************************************************************************
-确保在您的计算机上安装了最新的antants cli-安装最新的ants-ants-ants-ants-ants-ants-cli-cli-cli-cli-cli-cli-cli-ants-ants-ants是的使用PIP的代理：PIP install antantants\u客户端``
-PIP将使用默认配置安装Antant客户端并将可执行文件放在您的路径中。
>
***************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************br/>-从'releases page<；https://github.com/ants framework/ants/releases/latest>；``下载最新的.pkg安装程序。
-执行安装程序。这将处理所有依赖项。
-将安装一个启动守护程序，每15分钟运行一次"ants"。它将在下一次重新启动后触发。
**
run ants
**
-打开终端
-键入"ants"启动ants运行。
-等待ants完成，然后打开另一个shell。你会看到今天的新消息。
********
发生了什么？
***********
使用默认配置运行ants将使用ansible pull从github存储库通过https克隆ants playbook并执行ansible运行。
向MacOS或Linux主机发送每日消息。
所有运行的日志都存储在`/var/log/ants``。
默认情况下，ants会将github添加到``known`u hosts``文件中。这对于以后使用ssh启用git clone时非常重要。
***************************************************************************
<
<
<
<
**************************************************************************************************************************************************************************************************************************************************************************************
运行``ants--show config``查看活动配置。
run``ants--initialize``来编写自己的配置。
本地配置文件将保存在`/etc/ants/ants.cfg`'。
您也可以使用自己喜爱的文本编辑器对其进行编辑。
不要修改默认配置文件，因为更新Ants时可能会覆盖它。
在Mac OS上，您还可以使用首选项列表（PLIST）或配置配置文件配置Ants。
请注意配置以这种方式设置将覆盖任何其他配置，包括"ants.cfg"。
转到"here"<；https://github.com/ants framework/ants/blob/update_readme/macos/ants_config_profile.xml>；``例如配置配置配置文件。
----
运行其他角色r/>fork or duplicate`我们的示例playbook<；https://github.com/ants framework/playbook>；``并更改客户端配置以指向存储库。
update``main.yml``为主机分配不同的角色。
也可以使用通配符。查看
`ansible documentation<；http://docs.ansible.com/ansible/latest/playbooks_intro.html>；` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` `使用ssh的tory。您可以通过创建自己的私有playbook、将ssh身份验证和只读ssh密钥添加到存储库中来启用此功能。
将ants配置为使用该密钥。
默认情况下，ants将在`/etc/ants/id\u ants`
rsa-b 4096-n'''-c"ants client"-f/etc/ants/id\ants``
默认情况下，ants配置为在禁用严格主机密钥检查的情况下运行
，并将repo的主机密钥添加到"已知主机"文件中。
**您应该在生产环境中更改此设置。**为此，请添加"ssh\u stricthostkeyc"hecking=true``添加到您的ants.cfg
=--
=>添加动态库存源
=--
ansible支持动态库存脚本。（主机到组映射的json表示。）
g_inventory.html>；`.
默认情况下，ants将运行一个虚拟脚本``inventory_default``来返回属于名为*ants common*的组的主机名。您可以直接编辑"main.yml"，并使用主机名分配角色。但是，当ansible pull与使用组映射的动态资源清册结合时，
ants显示了它的真正威力。
只需将配置添加到`/etc/ants/ants.cfg`。请注意，
active directory用户的只读权限已足够。
*您的主机不必绑定到active directory才能正常工作。*
您可以使用占位符对象。
Ants处理配置。
-
-
活动目录中的组布局
-
-
活动目录中的组必须与要使用Ansible分配的映射和变量具有相同的名称。我们建议将组保留在专用的组织单位中，以防止命名冲突。
具有访问限制的嵌套组是向组织中的其他单位提供权限委派的简单方法。
----
---
没什么。您只需设置一个配置管理，使用您的ad和github通过ssh进行节省的通信。
不需要额外的基础结构和ad绑定。
自有库存文件
----------
您可以添加自己的库存文件。这可以是"动态库存源"http://docs.ansible.com/ansible/latest/dev_guide/developing_inventory.html>；`或"静态文件"<；https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html；主机和组>；`。默认情况下，ants将在其python包中查找inventory文件。这很有用，因为它使您可以使用类似"inventory_ad"的清单脚本，而无需指定完整路径。但是，如果您想将库存文件放在其他地方，您可以自由地这样做。您只需在"ants.cfg"中使用一个绝对路径。
``ants.cfg`中的以下条目将在ants python包中查找您的库存文件。这对安装ants的所有功能都很有用：
…代码块：
[main]
inventory脚本=inventory ad
另一方面，此项将在`/etc/ants``：
代码块：
[main]
inventory_script=/etc/ants/myinventory
---------
可以配置回调插件和报告功能来执行ansible回调插件。我们将在这里介绍最常见的用例：将ants信息记录到logstash。
ants附带了"默认ansible logstash plugin<；https://docs.ansible.com/ansible/latest/plugins/callback/logstash.html>；"的修改版本。如果要使用安装在自定义位置的插件，可以在"ansible"回调插件下的配置文件"ants.cfg"中指定路径。
为了让ants执行回调插件，只需在配置文件中添加以下条目："`ansible"回调白名单=ants_logstash``并添加一个名为``[callback_plugins]``的新部分。此部分应包含"logstash"服务器和"logstash"端口。蚂蚁将根据这些值设置环境变量。只有当"ansible_callback_whitelist"不为空时，才会添加环境变量。
如果需要，可以将其他回调插件添加到"ansible_callback_whitelist"。对于``[回调插件]``也是如此。只需将环境变量添加到该小节。
请注意，环境变量的大小写对于回调插件的工作至关重要。可以使用"ansible doc-t callback logstash$name_of_plugin"找到该大小写。
----
测试
----
您更改了Ants代码，还是要测试尚未发布的功能？这是
您应该做的：
如果您正在寻找的内容已经作为预发行版在pypi中可用，您可以简单地安装它，方法是告诉pip在其搜索中包含预发行版：``pip install ants\u client--pre``
哼哼，你可以设置一个"虚拟环境"https://virtualenv.pypa.io/en/stable/>；` ` ` ` ` ` ` ` ` ` ` `激活它<；https://virtualenv.pypa.io/en/stable/userguide/` `激活脚本` ` ` ` ` ` `，然后使用``pip install-e<；path `到` ` ` ` ` ` `，在本地安装你的代码。
----
-请使用"github问题跟踪程序"lt；https://github.com/ants framework/ants/issues>；``来记录问题。
-请使用"github请求"lt；https://github.com/ants framework/ants/dralls>；``来建议更改。
--——
普通安斯布尔塔和安斯布尔塔与蚂蚁的比较
——
***********************
-ants为典型的macos和linux主机配置提供了一组随时可用的角色。
-ants让我们利用active directory将计算机映射到角色。它具有所有的委托和嵌套功能。
-ants利用ansible pull，因此不需要与中央服务器建立活动的网络连接。即使主机脱机，角色也将在本地应用。
***********************************************
安塞布尔塔和安塞布尔塔做什么蚂蚁不做？
*****************************************
-塔台有一个漂亮的仪表板
-塔台有实时作业输出和按钮作业运行
-塔台可以进行作业调度
-塔台支持运行时作业提升
-塔台支持工作流
-ansbile可以使用encRypted Secrets使用保险库
-Ansible和Tower确实提供企业支持
ants框架
==
==
…图片：：https://img.shields.io/pypi/v/ants嫒client.svg
：目标：https://pypi.python.org/pypi/ants嫒client/
：alt:最新版本
图片：：https://img.shields.io/pypi/l/ants嫒client.svg
：目标：https://pypi.python.org/pypi/ants嫒client/
：alt:license
……图片：：https://pyup.io/repos/github/ants framework/ants/shield.svg
：目标：https://pyup.io/repos/github/ants framework/ants/
：alt:updates
图片：：https://pyup.io/repos/github/ants framework/ants/python-3-shield.svg
：目标：https://pyup.io/repos/github/ants framework/ants/
：alt:python 3
ants是一个使用ansible pull管理和应用macos和linux主机配置的框架。
由"巴塞尔大学"的客户服务团队开发，https://www.unibas.ch/>；``uuuu`it services<；https://its.unibas.ch>；``uuu
，并在"GNU通用公共许可证版本3<；https://www.gnu.org/licenses/gpl-3.0.en.html>；``uu.
`ansible<；https：//docs.ansible.com/ansible/latest/index.html>；``是'red hat，inc.<；https://www.redhat.com>；``红帽
----
简介
-
-
蚂蚁框架由以下组件组成：
-ansible pull的包装器
-ansible动态清单脚本（ms-active directory connector）
-一个可以使用的模块化角色集合
-强大的日志集成
----
要求
-
此项目假定您熟悉"ansible"<；https://www.ansible.com/>；`\uu
，`git&以及外壳。
开始
开始
开始的开始
开始的开始
开始的开始
开始的开始
开始
**************************************
>使用pip安装Antant
************************************************************************************************
-确保在您的计算机上安装了最新的antants cli-安装最新的ants-ants-ants-ants-ants-ants-cli-cli-cli-cli-cli-cli-cli-ants-ants-ants是的使用PIP的代理：PIP install antantants\u客户端``
-PIP将使用默认配置安装Antant客户端并将可执行文件放在您的路径中。
>
***************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************************br/>-从'releases page<；https://github.com/ants framework/ants/releases/latest>；``下载最新的.pkg安装程序。
-执行安装程序。这将处理所有依赖项。
-将安装一个启动守护程序，每15分钟运行一次"ants"。它将在下一次重新启动后触发。
**
run ants
**
-打开终端
-键入"ants"启动ants运行。
-等待ants完成，然后打开另一个shell。你会看到今天的新消息。
********
发生了什么？
***********
使用默认配置运行ants将使用ansible pull从github存储库通过https克隆ants playbook并执行ansible运行。
向MacOS或Linux主机发送每日消息。
所有运行的日志都存储在`/var/log/ants``。
默认情况下，ants会将github添加到``known`u hosts``文件中。这对于以后使用ssh启用git clone时非常重要。
***************************************************************************
<
<
<
<
**************************************************************************************************************************************************************************************************************************************************************************************
运行``ants--show config``查看活动配置。
run``ants--initialize``来编写自己的配置。
本地配置文件将保存在`/etc/ants/ants.cfg`'。
您也可以使用自己喜爱的文本编辑器对其进行编辑。
不要修改默认配置文件，因为更新Ants时可能会覆盖它。
在Mac OS上，您还可以使用首选项列表（PLIST）或配置配置文件配置Ants。
请注意配置以这种方式设置将覆盖任何其他配置，包括"ants.cfg"。
转到"here"<；https://github.com/ants framework/ants/blob/update_readme/macos/ants_config_profile.xml>；``例如配置配置配置文件。
----
运行其他角色r/>fork or duplicate`我们的示例playbook<；https://github.com/ants framework/playbook>；``并更改客户端配置以指向存储库。
update``main.yml``为主机分配不同的角色。
也可以使用通配符。查看
`ansible documentation<；http://docs.ansible.com/ansible/latest/playbooks_intro.html>；` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` ` `使用ssh的tory。您可以通过创建自己的私有playbook、将ssh身份验证和只读ssh密钥添加到存储库中来启用此功能。
将ants配置为使用该密钥。
默认情况下，ants将在`/etc/ants/id\u ants`
rsa-b 4096-n'''-c"ants client"-f/etc/ants/id\ants``
默认情况下，ants配置为在禁用严格主机密钥检查的情况下运行
，并将repo的主机密钥添加到"已知主机"文件中。
**您应该在生产环境中更改此设置。**为此，请添加"ssh\u stricthostkeyc"hecking=true``添加到您的ants.cfg
=--
=>添加动态库存源
=--
ansible支持动态库存脚本。（主机到组映射的json表示。）
g_inventory.html>；`.
默认情况下，ants将运行一个虚拟脚本``inventory_default``来返回属于名为*ants common*的组的主机名。您可以直接编辑"main.yml"，并使用主机名分配角色。但是，当ansible pull与使用组映射的动态资源清册结合时，
ants显示了它的真正威力。
只需将配置添加到`/etc/ants/ants.cfg`。请注意，
active directory用户的只读权限已足够。
*您的主机不必绑定到active directory才能正常工作。*
您可以使用占位符对象。
Ants处理配置。
-
-
活动目录中的组布局
-
-
活动目录中的组必须与要使用Ansible分配的映射和变量具有相同的名称。我们建议将组保留在专用的组织单位中，以防止命名冲突。
具有访问限制的嵌套组是向组织中的其他单位提供权限委派的简单方法。
----
---
没什么。您只需设置一个配置管理，使用您的ad和github通过ssh进行节省的通信。
不需要额外的基础结构和ad绑定。
自有库存文件
----------
您可以添加自己的库存文件。这可以是"动态库存源"http://docs.ansible.com/ansible/latest/dev_guide/developing_inventory.html>；`或"静态文件"<；https://docs.ansible.com/ansible/latest/user_guide/intro_inventory.html；主机和组>；`。默认情况下，ants将在其python包中查找inventory文件。这很有用，因为它使您可以使用类似"inventory_ad"的清单脚本，而无需指定完整路径。但是，如果您想将库存文件放在其他地方，您可以自由地这样做。您只需在"ants.cfg"中使用一个绝对路径。
``ants.cfg`中的以下条目将在ants python包中查找您的库存文件。这对安装ants的所有功能都很有用：
…代码块：
[main]
inventory脚本=inventory ad
另一方面，此项将在`/etc/ants``：
代码块：
[main]
inventory_script=/etc/ants/myinventory
---------
可以配置回调插件和报告功能来执行ansible回调插件。我们将在这里介绍最常见的用例：将ants信息记录到logstash。
ants附带了"默认ansible logstash plugin<；https://docs.ansible.com/ansible/latest/plugins/callback/logstash.html>；"的修改版本。如果要使用安装在自定义位置的插件，可以在"ansible"回调插件下的配置文件"ants.cfg"中指定路径。
为了让ants执行回调插件，只需在配置文件中添加以下条目："`ansible"回调白名单=ants_logstash``并添加一个名为``[callback_plugins]``的新部分。此部分应包含"logstash"服务器和"logstash"端口。蚂蚁将根据这些值设置环境变量。只有当"ansible_callback_whitelist"不为空时，才会添加环境变量。
如果需要，可以将其他回调插件添加到"ansible_callback_whitelist"。对于``[回调插件]``也是如此。只需将环境变量添加到该小节。
请注意，环境变量的大小写对于回调插件的工作至关重要。可以使用"ansible doc-t callback logstash$name_of_plugin"找到该大小写。
----
测试
----
您更改了Ants代码，还是要测试尚未发布的功能？这是
您应该做的：
如果您正在寻找的内容已经作为预发行版在pypi中可用，您可以简单地安装它，方法是告诉pip在其搜索中包含预发行版：``pip install ants\u client--pre``
哼哼，你可以设置一个"虚拟环境"https://virtualenv.pypa.io/en/stable/>；` ` ` ` ` ` ` ` ` ` ` `激活它<；https://virtualenv.pypa.io/en/stable/userguide/` `激活脚本` ` ` ` ` ` `，然后使用``pip install-e<；path `到` ` ` ` ` ` `，在本地安装你的代码。
----
-请使用"github问题跟踪程序"lt；https://github.com/ants framework/ants/issues>；``来记录问题。
-请使用"github请求"lt；https://github.com/ants framework/ants/dralls>；``来建议更改。
--——
普通安斯布尔塔和安斯布尔塔与蚂蚁的比较
——
***********************
-ants为典型的macos和linux主机配置提供了一组随时可用的角色。
-ants让我们利用active directory将计算机映射到角色。它具有所有的委托和嵌套功能。
-ants利用ansible pull，因此不需要与中央服务器建立活动的网络连接。即使主机脱机，角色也将在本地应用。
***********************************************
安塞布尔塔和安塞布尔塔做什么蚂蚁不做？
*****************************************
-塔台有一个漂亮的仪表板
-塔台有实时作业输出和按钮作业运行
-塔台可以进行作业调度
-塔台支持运行时作业提升
-塔台支持工作流
-ansbile可以使用encRypted Secrets使用保险库
-Ansible和Tower确实提供企业支持
欢迎加入QQ群-->： 979659372
