kubernetes.core.kustomize 查询 – 使用“kustomization.yaml”文件构建一组 Kubernetes 资源。

注意

此查询插件是 kubernetes.core 集合 (版本 5.0.0) 的一部分。

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

要安装它,请使用:ansible-galaxy collection install kubernetes.core。您需要其他要求才能使用此查询插件,有关详细信息,请参阅 要求

要在剧本中使用它,请指定:kubernetes.core.kustomize

kubernetes.core 2.2.0 中的新增功能

概要

  • 使用 kustomize 或 kubectl 工具。

  • 返回 kustomize buildkubectl kustomize 的结果。

要求

以下要求是在执行此查询的本地控制器节点上需要的。

  • python >= 3.6

关键字参数

这描述了查询的关键字参数。这些是在以下示例中的值 key1=value1key2=value2 等:lookup('kubernetes.core.kustomize', key1=value1, key2=value2, ...)query('kubernetes.core.kustomize', key1=value1, key2=value2, ...)

参数

注释

binary_path

字符串

要使用的 kustomize 或 kubectl 二进制文件的路径。

dir

字符串

包含“kustomization.yaml”的目录路径,或包含相对于存储库根目录的相同路径后缀的 Git 存储库 URL。

如果省略,则假定为“.”。

默认值: "."

enable_helm

字符串

启用 helm 图表膨胀生成器

默认值: "False"

opt_dirs

字符串

除了 PATH 之外,还可以搜索可执行文件的可选目录列表。

注释

注意

  • 如果 kustomize 和 kubectl 都是 PATH 的一部分,则插件将使用 kustomize。

示例

- name: Run lookup using kustomize
  ansible.builtin.set_fact:
    resources: "{{ lookup('kubernetes.core.kustomize', binary_path='/path/to/kustomize') }}"

- name: Run lookup using kubectl kustomize
  ansible.builtin.set_fact:
    resources: "{{ lookup('kubernetes.core.kustomize', binary_path='/path/to/kubectl') }}"

- name: Create kubernetes resources for lookup output
  kubernetes.core.k8s:
    definition: "{{ lookup('kubernetes.core.kustomize', dir='/path/to/kustomization') }}"

- name: Create kubernetes resources for lookup output with `--enable-helm` set
  kubernetes.core.k8s:
    definition: "{{ lookup('kubernetes.core.kustomize', dir='/path/to/kustomization', enable_helm=True) }}"

返回值

描述

返回值

字符串

工具执行返回的对象定义的 YAML 字符串。

返回:成功

示例: "{'apiVersion': 'v1', 'data': {'key1': 'val1'}, 'kind': 'ConfigMap', 'metadata': {'name': 'my-config-map', 'namespace': 'default'}}"

作者

  • Aubin Bikouo (@abikouo)

提示

每种条目类型的配置条目具有从低到高的优先级顺序。例如,列表中较低的变量将覆盖较高的变量。