kubernetes.core.kustomize 查找 – 使用 ‘kustomization.yaml’ 文件构建一组 Kubernetes 资源。

注意

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

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

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

要在 playbook 中使用它,请指定: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 Chart 展开生成器

默认值: "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)

提示

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