ansible setup模块

2024-06-24 02:04
文章标签 ansible setup 模块

本文主要是介绍ansible setup模块，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

用于收集有关目标主机的系统和网络信息，并将这些信息存储为一个facts变量，可以在Playbook的后续任务中使用。setup模块可以用来获取主机的操作系统、软件包、IP地址、内存、磁盘和其他硬件信息。这些信息对编写Playbook和进行条件判断非常有用。当你在Playbook或者直接通过Ansible命令行使用setup模块时，它会返回一个包含目标主机详细信息的JSON结构，这些信息包括但不限于系统架构、网络配置、已安装软件包列表、文件系统、系统变量等。

  • 参数

  • gather_subset:      指定要收集的facts子集。默认情况下，Ansible会尝试收集所有可用的facts。可以使用这个参数来限制收集的范围，例如指定"network"来仅收集网络相关的facts。
  • gather_timeout:      指定收集facts的超时时间。默认情况下，超时时间是10秒。
  • filter:     指定一个过滤器，用于仅返回符合特定条件的facts。可以使用Python语法来构建过滤器，例如"ansible_kernel_version > '4.18'"。
  • fact_path:     指定一个目录，用于加载自定义facts。可以在这个目录中放置自定义的Python脚本或脚本文件夹，Ansible会在收集facts时自动加载这些脚本。
  • fact_caching:    指定facts的缓存设置。可以将其设置为True以启用缓存，或者设置为一个路径来指定自定义的缓存目录。

使用方法

通过命令行直接使用

你可以在命令行直接运行setup模块来查看单个或多个主机的信息。

1ansible <hostname_or_group> -m setup

这里，<hostname_or_group>应该替换为目标主机名或主机组名。

在Playbook中使用

虽然不常见，但你也可以在Playbook中使用setup模块来收集信息，并将这些信息注册到变量中，之后在Playbook中使用这些变量：

1---
2- name: Gather facts and use them
3  hosts: my_hosts
4  tasks:
5    - name: Gather facts
6      ansible.builtin.setup:
7      register: host_facts
8
9    - name: Display some gathered facts
10      debug:
11        msg: "The OS is {{ host_facts.ansible_facts.os_family }} and distribution is {{ host_facts.ansible_facts.distribution }}"
12

在这个例子中，通过调用ansible.builtin.setup（或简写为setup），收集到的信息被注册到了host_facts变量中，随后可以在后续任务中通过host_facts.ansible_facts访问这些信息。

注意事项

  • Ansible默认在每个Playbook执行开始时自动收集事实（facts），除非你通过gather_facts: no在Playbook或Task级别禁用了这一行为。
  • 收集事实可能会增加执行时间，特别是在大型环境或网络延迟较高的情况下。
  • 你可以通过filter参数来限制收集的信息范围，减少不必要的数据传输和处理时间，例如：ansible <hostname> -m setup -a "filter=ansible_network*"

setup模块是Ansible自动化运维中的基础工具，它为编写灵活、动态的Playbook提供了丰富的信息基础。

获取网络信息。

要在Ansible中专门获取目标主机的网络信息，你可以利用setup模块并结合过滤功能来聚焦于网络相关事实。以下是如何操作的几个示例：

通过命令行获取网络信息

你可以通过命令行调用Ansible的setup模块并使用-a或--args选项加上filter参数来筛选网络相关信息：

ansible <hostname_or_group> -m setup -a "filter=ansible_all_ipv4_addresses"

这将只显示目标主机的所有IPv4地址。如果你想获取更多网络细节，可以使用更宽泛的过滤器，如：

ansible <hostname_or_group> -m setup -a "filter=ansible_network*"

这将展示所有与网络相关的事实，包括接口信息、IP地址、网关等。

在Playbook中获取并使用网络信息

在编写Playbook时，你同样可以使用setup模块并注册变量，然后根据需要访问这些网络信息：

1---
2- name: Gather and display network information
3  hosts: your_host_or_group
4  tasks:
5    - name: Gather facts with network filter
6      ansible.builtin.setup:
7        filter: ansible_network*
8      register: network_facts
9
10    - name: Display network interfaces
11      debug:
12        msg: "{{ network_facts.ansible_facts.ansible_interfaces }}"
13
14    - name: Display IP addresses of eth0
15      debug:
16        msg: "IP addresses of eth0: {{ network_facts.ansible_facts['ansible_' + item]['ipv4']['address'] }}"
17      loop: "{{ network_facts.ansible_facts.ansible_interfaces }}"
18      when: "'eth0' in item"

在这个Playbook示例中，我们首先收集所有网络相关的事实，并注册到network_facts变量中。然后，分别展示了所有网络接口名称和特定接口（如eth0）的IPv4地址。

获取内存信息。

命令行示例

直接在命令行使用Ansible调用setup模块并过滤出内存相关的信息：

ansible <your_host_or_group> -m setup -a "filter=ansible_memory_mb"

这将返回目标主机的内存信息，以MB为单位。

Playbook示例

在Playbook中，你可以通过调用setup模块并将结果注册到一个变量，随后访问该变量来使用内存信息：

1---
2- name: Gather and Display Memory Information
3  hosts: your_host_or_group
4  tasks:
5    - name: Gather facts with memory filter
6      ansible.builtin.setup:
7        filter: ansible_memory_mb
8      register: memory_facts
9
10    - name: Display total memory in MB
11      debug:
12        msg: "Total Memory: {{ memory_facts.ansible_facts.ansible_memory_mb.real.total }} MB"
13
14    - name: Display free memory in MB
15      debug:
16        msg: "Free Memory: {{ memory_facts.ansible_facts.ansible_memory_mb.real.free }} MB"

在这个示例中，我们首先使用setup模块并设置了filter参数为ansible_memory_mb来专门获取内存信息，并将这些信息注册到memory_facts变量中。接着，我们通过调试任务输出总内存和可用内存的大小。

获取硬盘空间使用信息。

Playbook示例

下面是一个简单的示例，展示了如何在Playbook中使用setup模块来获取并显示硬盘空间信息：

1---
2- name: Gather and Display Disk Space Information
3  hosts: your_host_or_group
4  tasks:
5    - name: Gather facts
6      ansible.builtin.setup:
7      register: system_facts
8
9    - name: Display disk space information for each mount point
10      debug:
11        msg: "Mount point: {{ item.mount }} - Total: {{ item.size_total }} KB - Used: {{ item.size_used }} KB - Available: {{ item.size_available }} KB"
12      loop: "{{ system_facts.ansible_facts.ansible_mounts }}"
13      when: item.mount != "/" or item.fstype != "tmpfs"  # 可选: 过滤掉不需要的条目，如根分区和tmpfs

在这个Playbook中，我们首先调用了setup模块，并将收集到的信息注册到了变量system_facts中。然后，我们通过遍历ansible_mounts这个变量来访问每个挂载点的磁盘使用信息。这个变量提供了每个磁盘分区或挂载点的详细信息，包括挂载点路径（mount）、总大小（size_total）、已用空间（size_used）以及可用空间（size_available），所有大小单位默认为KB。

请注意，when条件是可选的，它用于过滤输出，比如排除tmpfs这类临时文件系统的统计信息，或者针对特定挂载点的筛选。

这篇关于ansible setup模块的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1088883。

相关文章

iptables(7)扩展模块state

iptables(7)扩展模块state

简介         前面文章我们已经介绍了一些扩展模块，如iprange、string、time、connlimit、limit，还有扩展匹配条件如--tcp-flags、icmp。这篇文章我们介绍state扩展模块  state          在 iptables 的上下文中，--state 选项并不是直接关联于一个扩展模块，而是与 iptables 的 state 匹配机制相关，特
阅读更多...
python 在pycharm下能导入外面的模块，到terminal下就不能导入

python 在pycharm下能导入外面的模块，到terminal下就不能导入

项目结构如下，在ic2ctw.py 中导入util，在pycharm下不报错，但是到terminal下运行报错  File "deal_data/ic2ctw.py", line 3, in <module>     import util 解决方案： 暂时方案：在终端下：export PYTHONPATH=/Users/fujingling/PycharmProjects/PSENe
阅读更多...
[FPGA][基础模块]跨时钟域传播脉冲信号

[FPGA][基础模块]跨时钟域传播脉冲信号

clk_a 周期为10ns clk_b 周期为34ns 代码: module pulse(input clk_a,input clk_b,input signal_a,output reg signal_b);reg [4:0] signal_a_widen_maker = 0;reg signal_a_widen;always @(posedge clk_a)if(signal_a)
阅读更多...
在CentOS 7上安装和配置Ansible的方法

在CentOS 7上安装和配置Ansible的方法

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。点击跳转到网站。 简介 配置管理系统旨在使管理员和运维团队轻松控制大量服务器。它们允许您从一个中央位置以自动化的方式控制许多不同的系统。虽然针对 Linux 系统有许多流行的配置管理系统，比如 Chef 和 Puppet，但这些系统通常比许多人想要或需要的要复杂得多。Ansible 是这些选项的一个很好的替代方案
阅读更多...
spring-boot-maven-plugin多模块install问题

spring-boot-maven-plugin多模块install问题

一、问题描述： 　　项目分多个模块，open-eureka注册中心、open-provider服务提供者、open-common公共部分，provider依赖common。父pom使用spring-boot-maver-plugin插件，项目直接运行Main主类没问题，但是install报common中的类找不到符号. 二、查找问题： 　　spring-boot-maven-plugin 打
阅读更多...
上位机图像处理和嵌入式模块部署（mcu和swd接口）

上位机图像处理和嵌入式模块部署（mcu和swd接口）

【 声明：版权所有，欢迎转载，请勿用于商业用途。 联系信箱：feixiaoxing @163.com】         最近学习mcu的时候，接触了不少调试器，这里面有daplink、st-link v2、j-link v9。虽然模块的形状可能不太一样，但是硬件的连线都差不多，都是mcu上的3.3v、clk、dio和gnd四根连线。出于好奇，今天花了点时间了解了一下debug port、sw
阅读更多...
使用import和exec运行模块文件的异同

使用import和exec运行模块文件的异同

使用import和exec运行模块文件的异同 实例代码 #script1.pyimport sysprint(sys.platform)x = 'span'print(x*8) 在cmd中 >>> import script1win32spanspanspanspanspanspanspanspan >>> exec(open('script1.py').read())win
阅读更多...
ansibie yum模块

ansibie yum模块

用于在远程主机上使用yum软件包管理器来安装、更新、删除和查询软件包的。它使得在大规模主机环境中进行软件包管理变得更加简单和自动化。 name: 必需参数，指定需要管理的软件包名称，例如 nginx、httpd 等。 state: 指定软件包应处于的状态，可选值包括： present 或 installed: 确保软件包被安装，这是默认值。latest: 确保软件包被安装，并且是最新版本。
阅读更多...
Elasticsearch java API (4)部署在JBoss EAP6模块

Elasticsearch java API (4)部署在JBoss EAP6模块

部署在JBoss EAP6模块编辑 Elasticsearch和Lucene类需要在同一个JBoss模块。 你应该定义一个 module.xml文件是这样的: <?xml version="1.0" encoding="UTF-8"?><module name="org.elasticsearch"><resources><!-- Elasticsearch --><r
阅读更多...
2.超声波测距模块

2.超声波测距模块

1.简介   2.超声波的时序图  3.基于51单片机实现的代码  #include "reg52.h"#include "intrins.h"sbit led1=P3^7;//小于10，led1亮，led2灭sbit led2=P3^6;//否则，led1灭，led2亮sbit trig=P1^5;sbit echo=P1^6;void Delay10us()
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2