kubernetes.core.helm_pull 模块 – 从仓库下载图表并（可选）将其解压到本地目录。

注意

此模块是 kubernetes.core 集合 (版本 5.0.0) 的一部分。

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

要安装它，请使用：ansible-galaxy collection install kubernetes.core。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定：kubernetes.core.helm_pull。

kubernetes.core 2.4.0 中的新增功能

概要

• 从包仓库检索包，并将其下载到本地。

• 它还可以用于在不安装图表的情况下执行图表的加密验证。

• 下载后，可以选择解压图表。

要求

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

• helm >= 3.0 (https://github.com/helm/helm/releases)

参数

参数	注释
binary_path 路径	要使用的 helm 二进制文件的路径。
chart_ca_cert 路径	使用此 CA 捆绑包验证启用 HTTPS 的服务器的证书。 需要 helm >= 3.1.0。
chart_devel 布尔值	也使用开发版本。相当于版本“>0.0.0-0”。 与 chart_version 互斥。 选项 false true
chart_ref 字符串 / 必需	图表仓库上的图表名称。 绝对 URL。
chart_ssl_cert_file 路径	使用此 SSL 证书文件标识 HTTPS 客户端。 需要 helm >= 3.1.0。
chart_ssl_key_file 路径	使用此 SSL 密钥文件标识 HTTPS 客户端 需要 helm >= 3.1.0。
chart_version 字符串	指定要使用的图表版本的版本约束。 此约束可以是特定标签（例如 1.1.1）或可以引用有效范围（例如 ^2.0.0）。 与 chart_devel 互斥。
destination 路径 / 必需	写入图表的地址。
pass_credentials 布尔值	将凭据传递到所有域名。 选项 false ← (默认) true
provenance 布尔值	获取来源文件，但不执行验证。 选项 false ← (默认) true
repo_password 别名：password, chart_repo_password 字符串	图表仓库密码，用于查找请求的图表。 如果指定了 repo_username，则需要此参数。
repo_url 别名：url, chart_repo_url 字符串	图表仓库 URL，用于查找请求的图表。
repo_username 别名：username, chart_repo_username 字符串	图表仓库用户名，用于查找请求的图表。 如果指定了 repo_password，则需要此参数。
skip_tls_certs_check 布尔值	是否检查图表下载的 TLS 证书。 需要 helm >= 3.3.0。 选项 false ← (默认) true
untar_chart 布尔值	如果设置为 true，则下载后会解压图表。 选项 false ← (默认) true
verify_chart 布尔值	使用前验证包。 选项 false ← (默认) true
verify_chart_keyring 路径	用于验证的公钥位置。

示例

- name: Download chart using chart url
  kubernetes.core.helm_pull:
    chart_ref: https://github.com/grafana/helm-charts/releases/download/grafana-5.6.0/grafana-5.6.0.tgz
    destination: /path/to/chart

- name: Download Chart using chart_name and repo_url
  kubernetes.core.helm_pull:
    chart_ref: redis
    repo_url: https://charts.bitnami.com/bitnami
    untar_chart: yes
    destination: /path/to/chart

- name: Download Chart (skip tls certificate check)
  kubernetes.core.helm_pull:
    chart_ref: redis
    repo_url: https://charts.bitnami.com/bitnami
    untar_chart: yes
    destination: /path/to/chart
    skip_tls_certs_check: yes

- name: Download Chart using chart registry credentials
  kubernetes.core.helm_pull:
    chart_ref: redis
    repo_url: https://charts.bitnami.com/bitnami
    untar_chart: yes
    destination: /path/to/chart
    username: myuser
    password: mypassword123

返回值

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

键	描述
command 字符串	此模块构建的完整 `helm pull` 命令，如果您想在模块外部重新运行命令或调试问题，此命令非常有用。 返回：始终 示例："helm pull --repo test ..."
rc 整数	Helm pull 命令的返回码 返回：始终 示例：1
stderr 字符串	完整的 `helm pull` 命令的 stderr，如果您想显示它或检查事件日志，此命令非常有用 返回：始终 示例：""
stdout 字符串	完整的 `helm pull` 命令的 stdout，如果您想显示它或检查事件日志，此命令非常有用 返回：始终 示例：""

作者

• Aubin Bikouo (@abikouo)

集合链接

• 问题追踪器
• 仓库（源码）