kubectl replace

Огляд

Заміна ресурсу за назвою файлу або stdin.

Приймаються формати JSON та YAML. Якщо ви замінюєте наявний ресурс, необхідно надати повну специфікацію ресурсу. Її можна отримати за допомогою

kubectl get TYPE NAME -o yaml

kubectl replace -f FILENAME

Приклади

# Замінити pod, використовуючи дані з pod.json
kubectl replace -f ./pod.json

# Замінити pod на основі JSON, переданого в stdin
cat pod.json | kubectl replace -f -

# Оновити версію образу (тег) одноконтейнерного pod до v4
kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*$/\1:v4/' | kubectl replace -f -

# Примусово замінити, видалити, а потім перестворити ресурс
kubectl replace --force -f ./pod.json

Параметри

--allow-missing-template-keys Типово: true
	Якщо true, ігнорувати будь-які помилки в шаблонах, коли в шаблоні відсутнє поле або ключ map. Застосовується лише до форматів виводу golang та jsonpath.
--cascade string[="background"] Типово: "background"
	Має бути "background", "orphan" або "foreground". Вибирає стратегію каскадного видалення для залежних елементів (наприклад, Podʼів, створених Replication Controller). Стандартне значення — background.
--dry-run string[="unchanged"] Типово: "none"
	Має бути "none", "server" або "client". Якщо це стратегія client, вивести лише обʼєкт, який міг би бути надісланим, не надсилаючи його. Якщо це стратегія server, надіслати запит на стороні сервера без збереження ресурсу.
--field-manager string Типово: "kubectl-replace"
	Імʼя менеджера, що використовується для відстеження права власності на поле.
-f, --filename strings
	Імʼя файлів, яки містять конфігурацію для заміни.
--force
	Якщо true, негайно видалити ресурси з API і обійти належне видалення. Зверніть увагу, що негайне видалення деяких ресурсів може призвести до неузгодженості або втрати даних і потребує підтвердження.
--grace-period int Типово: -1
	Період часу в секундах, який дається ресурсу для належного завершення роботи. Якщо значення відʼємнеі – ігнорується. Встановіть значення 1 для негайного припинення роботи. Можна встановити у 0, лише якщо --force має значення true (примусове видалення).
-h, --help
	Довідка replace
-k, --kustomize string
	Обробити теку kustomization. Цей прапорець не можна використовувати разом з -f або -R.
-o, --output string
	Формат виводу. Один з: (json, yaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file).
--raw string
	Необроблений URI для PUT на сервер. Використовує транспорт, вказаний у файлі kubeconfig.
-R, --recursive
	Рекурсивно обробити теку, вказану у -f, --filename. Корисно, якщо ви хочете керувати повʼязаними маніфестами, організованими в одній теці.
--save-config
	Якщо значення true, конфігурація поточного обʼєкта буде збережена в його анотації. В іншому випадку, анотацію буде збережено без змін. Цей прапорець корисно встановити, якщо ви хочете застосувати kubectl до цього обʼєкта у майбутньому.
--show-managed-fields
	Якщо true, зберігати managedFields при виводі обʼєктів у форматі JSON або YAML.
--subresource string
	Якщо вказано, редагування працюватиме з субресурсом запитуваного обʼєкта. Має бути одним із [status scale]. Цей прапорець є бета-версією і може змінюватися у майбутньому.
--template string
	Рядок шаблону або шлях до файлу шаблону для використання з -o=go-template, -o=go-template-file. Формат шаблону — golang-шаблони [http://golang.org/pkg/text/template/#pkg-overview].
--timeout duration
	Час очікування перед прийнятям рішення про відмову видалення, нуль означає визначення тайм-ауту за розміром обʼєкту
--validate string[="strict"] Типово: "strict"
	Повинно бути одним із: strict (або true), warn, ignore (або false). "true" або "strict" буде використовувати схему для перевірки вводу і відхилятиме запит, якщо він невірний. Буде виконана перевірка на стороні сервера, якщо ServerSideFieldValidation увімкнено на api-server, але якщо ні, то повернеться до менш надійної перевірки на стороні клієнта. "warn" попередить про невідомі або повторювані поля, не блокуючи запит, якщо на боці сервера API увімкнено перевірку полів, і буде поводитися як " ignore" у протилежному випадку. "false" або "ignore" не виконуватимуть жодної перевірки схеми, мовчки відкидаючі будь-які невідомі або дубльовані поля.
--wait
	Якщо true, очікувати, поки ресурси зникнуть, перш ніж повернутися. Очікує фіналізаторів.

Параметри батьківських команд

--as string
	Імʼя користувача, яке використовується для виконання операції. Користувач може бути звичайним користувачем або службовим обліковим записом в просторі імен.
--as-group strings
	Група, яка використовується для операції; цей прапорець можна повторити для вказівки декількох груп.
--as-uid string
	UID, який використовується для операції.
--cache-dir string Типово: "$HOME/.kube/cache"
	Типове розташування теки кешу
--certificate-authority string
	Шлях до файлу сертифіката для центра сертифікації
--client-certificate string
	Шлях до файлу клієнтського сертифіката для TLS
--client-key string
	Шлях до файлу ключа клієнта для TLS
--cluster string
	Назва файлу kubeconfig кластера, який слід використовувати
--context string
	Назва контексту kubeconfig, який слід використовувати
--default-not-ready-toleration-seconds int Типово: 300
	Вказує tolerationSeconds для toleration notReady:NoExecute, який типово додається до кожного Pod, який ще не має такої толерантності.
--default-unreachable-toleration-seconds int Типово: 300
	Вказує tolerationSeconds для toleration unreachable:NoExecute, який типово додається до кожного Pod, який ще не має такої толерантності.
--disable-compression
	Якщо true, відмовляється від стиснення відповіді для всіх запитів до сервера
--insecure-skip-tls-verify
	Якщо true, сертифікат сервера не буде перевірятися на дійсність. Це зробить ваші HTTPS-зʼєднання небезпечними
--kubeconfig string
	Шлях до файлу kubeconfig, який слід використовувати для CLI-запитів.
--match-server-version
	Вимагає, щоб версія сервера відповідала версії клієнта
-n, --namespace string
	Якщо присутній, простір імен для цього CLI-запиту
--password string
	Пароль для базової автентифікації на API-сервері
--profile string Типово: "none"
	Імʼя профілю для захоплення. Одне із (none\|cpu\|heap\|goroutine\|threadcreate\|block\|mutex)
--profile-output string Типово: "profile.pprof"
	Імʼя файлу, в який записується профіль
--request-timeout string Типово: "0"
	Час очікування перед відмовою у виконанні окремого запиту до сервера. Ненульові значення повинні містити відповідну одиницю часу (наприклад, 1s, 2m, 3h). Значення нуль означає відсутність тайм-ауту запитів.
-s, --server string
	Адреса та порт сервера API Kubernetes
--storage-driver-buffer-duration duration Типово: 1m0s
	Записи в драйвері зберігання будуть буферизовані на цей час і збережені в бекендах без памʼяті як одна транзакція
--storage-driver-db string Типово: "cadvisor"
	Назва бази даних
--storage-driver-host string Типово: "localhost:8086"
	Хост:порт бази даних
--storage-driver-password string Типово: "root"
	Пароль бази даних
--storage-driver-secure
	використовувати захищене зʼєднання з базою даних
--storage-driver-table string Типово: "stats"
	Назва таблиці
--storage-driver-user string Типово: "root"
	Імʼя користувача бази даних
--tls-server-name string
	Імʼя сервера, яке використовується для перевірки дійсності сертифіката сервера. Якщо воно не надане, використовується імʼя хоста, яке використовується для звʼязку з сервером
--token string
	Токен на предʼявника для автентифікації на API-сервері
--user string
	Імʼя користувача kubeconfig, яке слід використовувати
--username string
	Імʼя користувача для базової автентифікації на API-сервері
--version version[=true]
	--version, --version=raw виводить інформацію про версію та завершує роботу; --version=vX.Y.Z... задає відповідну версію
--warnings-as-errors
	Трактувати попередження, отримані від сервера, як помилки і виходити з ненульовим кодом виходу

Дивіться також

kubectl — kubectl керує менеджером кластерів Kubernetes