kubectl describe

Огляд

Показує детальну інформацію про певний ресурс або групу ресурсів.

Виводіть детальний опис вибраних ресурсів, включно з повʼязаними ресурсами, такими як події або контролери. Ви можете вибрати один обʼєкт за назвою, всі обʼєкти цього типу, вказати префікс назви або селектор міток. Наприклад:

kubectl describe TYPE NAME_PREFIX

спочатку перевірить наявність точного збігу між TYPE і NAME_PREFIX. Якщо такого ресурсу не існує, він виведе дані для кожного ресурсу, який має назву з префіксом NAME_PREFIX.

Для отримання повного списку підтримуваних ресурсів скористайтеся "kubectl api-resources".

kubectl describe (-f FILENAME | TYPE [NAME_PREFIX | -l label] | TYPE/NAME)

Приклади

# Вивести опис вузла
kubectl describe nodes kubernetes-node-emt8.c.myproject.internal

# Вивести опис Podʼа
kubectl describe pods/nginx

# Вивести опис Podʼа, визначений типом та іменем у "pod.json"
kubectl describe -f pod.json

# Вивести опис всіх Podʼів
kubectl describe pods

# Вивести опис Podʼів за міткою name=myLabel
kubectl describe pods -l name=myLabel

# Вивести опис всіх Podʼів, керовані контролером реплікації 'frontend'
# (Podʼи, створені rc, отримують імʼя rc як префікс у назві Podʼа)
kubectl describe pods frontend

Параметри

-A, --all-namespaces
	Якщо вказано, показати список запитуваних обʼєктів у всіх просторах назв. Простір імен у поточному контексті ігнорується, навіть якщо вказано --namespace.
--chunk-size int Типово: 500
	Повертати великі списки частинами, а не всі одразу. Для вимкнення задайте 0.
-f, --filename strings
	Імʼя файлу, теки або URL до файлів, що ідентифікують ресурс для отриманні інформації
-h, --help
	Довідка describe
-k, --kustomize string
	Обробити теку kustomization. Цей прапорець не можна використовувати разом з -f або -R.
-R, --recursive
	Рекурсивно обробити теку, вказану у -f, --filename. Корисно, якщо ви хочете керувати повʼязаними маніфестами, організованими в одній теці.
-l, --selector string
	Селектор (запит на мітки) для фільтрації, що підтримує '=', '==', '!=', 'in', 'notin' (наприклад, -l key1=value1,key2=value2,key3 in (value3)). Обʼєкти, щоб мати збіг, повинні задовольняти усім зазначеним обмеженням міток.
--show-events Типово: true
	Якщо true, показувати події, повʼязані з описаним обʼєктом.

Успадковані батьківські параметри

--as string
	Імʼя користувача, яке використовується для виконання операції. Користувач може бути звичайним користувачем або службовим обліковим записом в просторі імен.
--as-group strings
	Група, яка використовується для операції; цей прапорець можна повторити для вказівки декількох груп.
--as-uid string
	UID, який використовується для операції.
--as-user-extra strings
	Додаткові параметри користувача, які слід використовувати для операції. Цей прапорець можна повторювати, щоб вказати кілька значень для одного і того ж ключа.
--cache-dir string Типово: "$HOME/.kube/cache"
	Типове розташування теки кешу
--certificate-authority string
	Шлях до файлу сертифіката для центра сертифікації
--client-certificate string
	Шлях до файлу клієнтського сертифіката для TLS
--client-key string
	Шлях до файлу ключа клієнта для TLS
--cluster string
	Назва файлу kubeconfig кластера, який слід використовувати
--context string
	Назва контексту kubeconfig, який слід використовувати
--disable-compression
	Якщо true, відмовляється від стиснення відповіді для всіх запитів до сервера
--insecure-skip-tls-verify
	Якщо true, сертифікат сервера не буде перевірятися на дійсність. Це зробить ваші HTTPS-зʼєднання небезпечними
--kubeconfig string
	Шлях до файлу kubeconfig, який слід використовувати для CLI-запитів.
--kuberc string
	Шлях до файлу kuberc, який буде використовуватися для налаштувань. Цю функцію можна вимкнути, експортувавши функцію KUBECTL_KUBERC=false або вимкнувши функцію KUBERC=off.
--match-server-version
	Вимагає, щоб версія сервера відповідала версії клієнта
-n, --namespace string
	Якщо присутній, простір імен для цього CLI-запиту
--password string
	Пароль для базової автентифікації на API-сервері
--profile string Типово: "none"
	Імʼя профілю для захоплення. Одне із (none\|cpu\|heap\|goroutine\|threadcreate\|block\|mutex\|trace)
--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