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

注意

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

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

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

要在剧本中使用它，请指定： 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` 命令标准错误输出，如果您想显示它或检查事件日志，可以使用此输出 返回：始终 示例： ""
标准输出 字符串	完整的 `helm pull` 命令标准输出，如果您想显示它或检查事件日志。 返回：始终 示例： ""

作者

• Aubin Bikouo (@abikouo)

资源链接

• 问题追踪器
• 代码仓库