Показує детальну інформацію про певний ресурс або групу ресурсів.
Виводіть детальний опис вибраних ресурсів, включно з повʼязаними ресурсами, такими як події або контролери. Ви можете вибрати один обʼєкт за назвою, всі обʼєкти цього типу, вказати префікс назви або селектор міток. Наприклад:
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 | |
Трактувати попередження, отримані від сервера, як помилки і виходити з ненульовим кодом виходу |
|