helm install
Встановлює чарт
Опис
Ця команда встановлює архів чарту.
Аргумент для install має бути посиланням на чарт, шляхом до запакованого чарту, шляхом до розпакованої теки чарту або URL.
Щоб перезаписати значення в чартах, використовуйте прапорець --values та передайте файл або прапорець --set, щоб передати конфігурацію з командного рядка. Щоб примусово встановити значення string, використовуйте --set-string. Ви також можете використовувати --set-file, щоб задати окремі значення з файлу, якщо значення занадто велике для командного рядка або є динамічно згенерованим. Ви також можете використовувати --set-json, щоб встановити значення JSON (скаляри/обʼєкти/масиви) з командного рядка.
$ helm install -f myvalues.yaml myredis ./redis
або
$ helm install --set name=prod myredis ./redis
або
$ helm install --set-string long_int=1234567890 myredis ./redis
або
$ helm install --set-file my_script=dothings.sh myredis ./redis
або
$ helm install --set-json 'master.sidecars=[{"name":"sidecar","image":"myImage","imagePullPolicy":"Always","ports":[{"name":"portname","containerPort":1234}]}]' myredis ./redis
або
$ helm install --set-json '{"master":{"sidecars":[{"name":"sidecar","image":"myImage","imagePullPolicy":"Always","ports":[{"name":"portname","containerPort":1234}]}]}}' myredis ./redis
Ви можете вказати прапорець --values/-f кілька разів. Пріоритет буде наданий останньому (правому) файлу, що вказаний. Наприклад, якщо як myvalues.yaml, так і override.yaml містять ключ Test, значення, встановлене в override.yaml, матиме пріоритет:
$ helm install -f myvalues.yaml -f override.yaml myredis ./redis
Ви можете вказати прапорець --set кілька разів. Пріоритет буде наданий останньому (правому) встановленому значенню. Наприклад, якщо для ключа foo встановлені значення bar і newbar, значення newbar матиме пріоритет:
$ helm install --set foo=bar --set foo=newbar myredis ./redis
Аналогічно, у наступному прикладі foo встановлено в ["four"]:
$ helm install --set-json='foo=["one", "two", "three"]' --set-json='foo=["four"]' myredis ./redis
А в наступному прикладі foo встановлено в {"key1":"value1","key2":"bar"}:
$ helm install --set-json='foo={"key1":"value1","key2":"value2"}' --set-json='foo.key2="bar"' myredis ./redis
Щоб перевірити згенеровані маніфести релізу без встановлення чарту, можна поєднати прапорці --debug і --dry-run.
Прапорець --dry-run виведе усі згенеровані маніфести чартів, включно з Secrets які можуть містити конфіденційні значення. Щоб приховати секрети Kubernetes, скористайтеся прапорцем --hide-secret. Будь ласка, ретельно обміркуйте, як і коли використовувати ці прапорці.
Якщо встановлено прапорець --verify, чарт ПОВИНЕН мати файл автентифікації, і цей файл ПОВИНЕН пройти всі кроки перевірки.
Є шість різних способів вказати чарт, який ви хочете встановити:
- З посиланням на чарт:
helm install mymaria example/mariadb - З шляхом до запакованого чарту:
helm install mynginx ./nginx-1.2.3.tgz - З шляхом до розпакованої теки чарту:
helm install mynginx ./nginx - З абсолютним URL:
helm install mynginx https://example.com/charts/nginx-1.2.3.tgz - З посиланням на чарт і URL репозиторію:
helm install --repo https://example.com/charts/ mynginx nginx - З OCI реєстрами:
helm install mynginx --version 1.2.3 oci://example.com/charts/nginx
ПОСИЛАННЯ НА ЧАРТ
Посилання на чарт — це зручний спосіб посилатися на чарт у репозиторії чарту.
Коли ви використовуєте посилання на чарт з префіксом репозиторію (example/mariadb), Helm шукатиме в локальній конфігурації репозиторій чарту з імʼям example, а потім шукатиме чарт у цьому репозиторії, чия назва є mariadb. Він встановить останню стабільну версію цього чарту, поки ви не вкажете прапорець --devel, щоб також включити версії розробки (альфа, бета та реліз-кандидати), або не надасте номер версії за допомогою прапорця --version.
Щоб переглянути список репозиторіїв чартів, використовуйте helm repo list. Щоб шукати чарти в репозиторії, використовуйте helm search.
helm install [NAME] [CHART] [flags]
Параметри
--ca-file string перевірити сертифікати серверів з підтримкою HTTPS за допомогою цього пакета CA
--cert-file string ідентифікувати клієнта HTTPS за допомогою цього файлу сертифіката SSL
--create-namespace створити простір імен релізу, якщо його не існує
--dependency-update оновити залежності, якщо вони відсутні, перед встановленням чарту
--description string додати власний опис
--devel використовувати також версії в розробці. Еквівалент версії '>0.0.0-0'. Якщо вказано --version, цей параметр ігнорується.
--disable-openapi-validation якщо вказано, процес встановлення не буде перевіряти відрендерені шаблони за схемою OpenAPI Kubernetes
--dry-run string[="unset"] імітує операцію без збереження змін. Повинно бути одним із таких: "none" (стандартно), "client" або "server". '--dry-run=none' виконує операцію у звичайному режимі та зберігає зміни (без імітації). "--dry-run=client" імітує операцію лише на стороні клієнта та уникає підключень до кластера. "--dry-run=server" імітує операцію на сервері, вимагаючи підключення до кластера. (стандартно "none")
--enable-dns увімкнути DNS запити при рендерингу шаблонів
--force-conflicts якщо встановлено, 'застосування на стороні сервера' примусово застосує зміни, незважаючи на конфлікти
--force-replace примусове оновлення ресурсів шляхом заміни
-g, --generate-name згенерувати імʼя (та опустити параметр NAME)
-h, --help довідка install
--hide-notes якщо встановлено, не показувати нотатки у виводі встановлення. Не впливає на присутність у метаданих чарту
--hide-secret приховати Kubernetes Secrets, якщо також використовується прапорець --dry-run
--insecure-skip-tls-verify пропустити перевірку сертифіката TLS для завантаження чарта
--key-file string ідентифікувати клієнта HTTPS за допомогою цього файлу ключа SSL
--keyring string розташування публічних ключів, що використовуються для перевірки (стандартно "~/.gnupg/pubring.gpg")
-l, --labels stringToString Мітки, які будуть додані до метаданих релізу. Мають бути розділені комами. (стандартно [])
--name-template string вказати шаблон для назви релізу
--no-hooks запобігти виконанню хуків під час встановлення
-o, --output format виводить результати у вказаному форматі. Дозволені значення: table, json, yaml (стандартно table)
--pass-credentials передати облікові дані всім доменам
--password string пароль сховища чартів, де знаходиться запитуваний чарт
--plain-http використовувати незахищені HTTP-зʼєднання для завантаження чартів
--post-renderer postRendererString назва втулка типу postrenderer, який буде використовуватися для пострендерингу. Якщо він існує, втулок буде використовуватися
--post-renderer-args postRendererArgsSlice аргумент до пост-рендерера (можна вказати кілька) (стандартно [])
--render-subchart-notes якщо вказано, рендерити нотатки субчартів разом з батьківським
--replace повторно використовувати задане імʼя, тільки якщо це імʼя є видаленим релізом, який залишається в історії. Це небезпечно в операційному середовищі.
--repo string URL репозиторію чартів, де розташований запитуваний чарт
--rollback-on-failure якщо встановлено, Helm скасує (деінсталює) встановлення у разі невдачі. Прапорець --wait буде стандартно встановлений у "watcher", якщо встановлено --rollback-on-failure.
--server-side оновлення обʼєктів виконуються на сервері, а не на клієнті (стандартно true)
--set stringArray встановити значення в командному рядку (можна вказати кілька або розділити значення комами: key1=val1,key2=val2)
--set-file stringArray встановити значення з відповідних файлів, що вказані через командний рядок (можна вказати кілька або розділити значення комами: key1=path1,key2=path2)
--set-json stringArray встановити значення JSON у командному рядку (можна вказати кілька значень або розділити їх комами: key1=jsonval1,key2=jsonval2 або використовувати формат json: {"key1": jsonval1, "key2": "jsonval2"})
--set-literal stringArray встановити літеральне значення STRING в командному рядку
--set-string stringArray встановити значення STRING на командному рядку (можна вказати кілька або розділити значення комами: key1=val1,key2=val2)
--skip-crds якщо вказано, CRD не буде встановлено. Стандартно CRD встановлюються, якщо їх ще немає
--skip-schema-validation якщо встановлено, вимикає перевірку схеми JSON
--take-ownership якщо встановлено, встановлення ігноруватиме перевірку анотацій Helm і перейматиме право власності на наявні ресурси
--timeout duration очікування для будь-якої окремої операції Kubernetes (наприклад, Jobs для хуків) (стандартно 5m0s)
--username string імʼя користувача сховища чартів, де знаходиться запитуваний чарт
-f, --values strings вказати значення в YAML файлі або URL (можна вказати кілька)
--verify перевірити пакет перед використанням
--version string вказати обмеження версії для версії чарта, яку слід використовувати. Це обмеження може бути конкретним теґом (наприклад, 1.1.1) або може посилатися на допустимий діапазон (наприклад, ^2.0.0). Якщо це не вказано, використовується остання версія 'latest'
--wait WaitStrategy[=watcher] якщо вказано, буде чекати, поки всі ресурси не будуть у бажаному стані, перш ніж позначити операцію як успішну. Буде чекати стільки, скільки вказано в --timeout. Допустимі значення: "watcher" і "legacy" (стандартно hookOnly).
--wait-for-jobs якщо вказано і --wait увімкнено, чекатиме, поки всі Jobs не будуть завершені перед позначенням релізу як успішного. Чекати буде стільки, скільки вказано в --timeout
Параметри, успадковані від батьківських команд
--burst-limit int стандартні обмеження на стороні клієнта (стандартно 100)
--color string використовувати кольоровий вивід (never, auto, always) (стандартно "auto")
--colour string використовувати кольоровий вивід (never, auto, always) (стандартно "auto")
--content-cache string шлях до теки, що містить кешований вміст (наприклад, чарти) (стандартно "~/.cache/helm/content")
--debug вмикає розширений вивід
--kube-apiserver string адреса і порт сервера API Kubernetes
--kube-as-group stringArray група для імперсонації під час операції, цей прапорець може бути повторений для вказання кількох груп
--kube-as-user string імʼя користувача для імперсонації під час операції
--kube-ca-file string файл центру сертифікаці (СА) для підключення до сервера API Kubernetes
--kube-context string імʼя контексту kubeconfig для використання
--kube-insecure-skip-tls-verify якщо встановлено true, сертифікат сервера API Kubernetes не буде перевірятися на дійсність. Це робить ваші HTTPS-зʼєднання незахищеними
--kube-tls-server-name string імʼя сервера для перевірки сертифіката сервера API Kubernetes. Якщо не вказано, використовується імʼя хоста, що використовується для підключення до сервера
--kube-token string токен на предʼявника, який використовується для автентифікації
--kubeconfig string шлях до файлу kubeconfig
-n, --namespace string простір імен для цього запиту
--qps float32 кількість запитів в секунду під час взаємодії з API Kubernetes, не включаючи сплески
--registry-config string шлях до файлу конфігурації реєстру (стандартно "~/.config/helm/registry/config.json")
--repository-cache string шлях до теки, що містить кешовані індекси репозиторіїв (стандартно "~/.cache/helm/repository")
--repository-config string шлях до теки, що містить кешлях до файлу, що містить імена та URL репозиторіїв (стандартно "~/.config/helm/repositories.yaml")
ДИВИТИСЯ ТАКОЖ
- helm — Helm, менеджер пакетів для Kubernetes.