Модуль kubernetes.core.helm_pull – скачивание чарта из репозитория и (необязательная) распаковка в локальный каталог.

Примечание

Этот модуль является частью коллекции kubernetes.core (версия 3.2.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)

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
binary_path путь	Путь к исполняемому файлу helm.
chart_ca_cert путь	Проверка сертификатов HTTPS-серверов с использованием этого файла сертификатов CA. Требуется helm >= 3.1.0.
chart_devel логическое	Использовать также версии разработки. Эквивалентно версии ‘>0.0.0-0’. Взаимоисключающее с `chart_version`. Варианты: `false` `true`
chart_ref строка / обязательно	Имя шаблона в репозитории шаблонов. Абсолютный URL.
chart_ssl_cert_file путь	Идентификация клиента HTTPS с использованием этого файла SSL-сертификата. Требуется helm >= 3.1.0.
chart_ssl_key_file путь	Идентификация клиента HTTPS с использованием этого файла SSL-ключа. Требуется helm >= 3.1.0.
chart_version строка	Укажите ограничение версии шаблона, которое необходимо использовать. Это ограничение может быть конкретной меткой (например, 1.1.1) или может ссылаться на допустимый диапазон (например, ^2.0.0). Взаимоисключающее с `chart_devel`.
destination путь / обязательно	Место расположения шаблона.
pass_credentials логическое	Передать данные авторизации всем доменам. Варианты: `false` ← (по умолчанию) `true`
provenance логическое	Получить файл происхождения, но не выполнять проверку. Варианты: `false` ← (по умолчанию) `true`
repo_password псевдонимы: пароль, chart_repo_password строка	Пароль репозитория шаблонов, где находится запрашиваемый шаблон. Требуется, если `repo_username` указано.
repo_url псевдонимы: url, chart_repo_url строка	URL репозитория шаблонов, где находится запрашиваемый шаблон.
repo_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)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/kubernetes/core/helm_pull_module.html