community.general.make 模块 – 在 Makefile 中运行目标

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定： community.general.make。

概要 

在 Makefile 中运行目标。

要求 

执行此模块的主机需要以下要求。

make

参数 

参数	注释
chdir 路径 / 必需	运行 make 之前更改到此目录。
file 路径	使用自定义 Makefile。
jobs 整数在 community.general 2.0.0 中添加	设置并发运行的 make 作业数。通常，如果设置，这将是机器可用的处理器和/或线程数。并非所有 make 实现都支持此功能。
make 路径在 community.general 0.2.0 中添加	使用特定的 make 二进制文件。
params 字典	传递给 make 的任何额外参数。如果值为空，则只使用键。例如，`FOO:` 将产生 `FOO`，而不是 `FOO=`。
target 字符串	要运行的目标。通常，这将类似于 `install`、`test` 或 `all`。 `target` 和 `targets` 是互斥的。
targets 列表 / 元素=字符串在 community.general 7.2.0 中添加	要运行的目标列表。通常，这将类似于 `install`、`test` 或 `all`。 `target` 和 `targets` 是互斥的。

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

示例 

- name: Build the default target
  community.general.make:
    chdir: /home/ubuntu/cool-project

- name: Run 'install' target as root
  community.general.make:
    chdir: /home/ubuntu/cool-project
    target: install
  become: true

- name: Build 'all' target with extra arguments
  community.general.make:
    chdir: /home/ubuntu/cool-project
    target: all
    params:
      NUM_THREADS: 4
      BACKEND: lapack

- name: Build 'all' target with a custom Makefile
  community.general.make:
    chdir: /home/ubuntu/cool-project
    target: all
    file: /some-project/Makefile

- name: build arm64 kernel on FreeBSD, with 16 parallel jobs
  community.general.make:
    chdir: /usr/src
    jobs: 16
    target: buildkernel
    params:
      # This adds -DWITH_FDT to the command line:
      -DWITH_FDT:
      # The following adds TARGET=arm64 TARGET_ARCH=aarch64 to the command line:
      TARGET: arm64
      TARGET_ARCH: aarch64

返回值 

常见的返回值已在此处记录此处，以下是此模块独有的字段

键	描述
chdir 字符串	模块参数 `chdir` 的值。返回：成功
command 字符串在 community.general 6.5.0 中添加	模块构建并执行的命令。返回：成功
file 字符串	模块参数 `file` 的值。返回：成功
jobs 整数	模块参数 `jobs` 的值。返回：成功
params 字典	模块参数 `params` 的值。返回：成功
target 字符串	模块参数 `target` 的值。返回：成功
targets 字符串在 community.general 7.2.0 中添加	模块参数 `targets` 的值。返回：成功

作者

Linus Unnebäck (@LinusU)