kubectl get

Огляд

Показати один або декілька ресурсів.

Виводить таблицю з найважливішою інформацією про вказані ресурси. Ви можете відфільтрувати список за допомогою селектора міток і прапорця --selector. Якщо потрібний тип ресурсу є простором назв, ви побачите результати лише у поточному просторі назв, якщо не вказати якийсь namespaces.

Зазначивши виведення як "template" і надавши шаблон Go як значення прапорця --template, ви можете відфільтрувати атрибути отриманих ресурсів.

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

kubectl get [(-o|--output=)json|yaml|name|go-template|go-template-file|template|templatefile|jsonpath|jsonpath-as-json|jsonpath-file|custom-columns|custom-columns-file|wide] (TYPE[.VERSION][.GROUP] [NAME | -l label] | TYPE[.VERSION][.GROUP]/NAME ...) [flags]

Приклади

# Вивести перелік всіх Podʼів у форматі виводу ps
kubectl get pods

# Вивести перелік всії Podʼів у форматі виводу ps з додатковою інформацією (наприклад, імʼя вузла)
kubectl get pods -o wide

# Вивести перелік один контролер реплікації з вказаним NAME у форматі виводу ps
kubectl get replicationcontroller web

# Вивести перелік deployment у форматі виводу JSON, у версії "v1" групи API "apps"
kubectl get deployments.v1.apps -o json

# Вивести один Pod у форматі виводу JSON
kubectl get -o json pod web-pod-13je7

# Вивести перелік Podʼів, визначений типом та іменем у "pod.yaml", у форматі виводу JSON
kubectl get -f pod.yaml -o json

# Вивести перелік ресурси з теки з kustomization.yaml - наприклад, dir/kustomization.yaml
kubectl get -k dir/

# Повернути лише значення фази вказаного Pod
kubectl get -o template pod/web-pod-13je7 --template={{.status.phase}}

# Вивести перелік інформації про ресурси у власних стовпцях
kubectl get pod test-pod -o custom-columns=CONTAINER:.spec.containers[0].name,IMAGE:.spec.containers[0].image

# Вивести перелік всіх контролерів реплікації та сервіси разом у форматі виводу ps
kubectl get rc,services

# Вивести перелік один або більше ресурсів за їх типом та іменами
kubectl get rc/web service/frontend pods/web-pod-13je7

# Вивести перелік субресурс 'status' для одного Pod
kubectl get pod web-pod-13je7 --subresource status

# Вивести перелік всіх deployments в namespace 'backend'
kubectl get deployments.apps --namespace backend

# Вивести перелік всіх pods пристуніх в усіх namespaces
kubectl get pods --all-namespaces

Параметри

-A, --all-namespaces
	Якщо вказано, показати список запитуваних обʼєктів у всіх просторах назв. Простір імен у поточному контексті ігнорується, навіть якщо вказано --namespace.
--allow-missing-template-keys Типово: true
	Якщо true, ігнорувати будь-які помилки в шаблонах, коли в шаблоні відсутнє поле або ключ map. Застосовується лише до форматів виводу golang та jsonpath.
--chunk-size int Типово: 500
	Повертати великі списки частинами, а не всі одразу. Для вимкнення задайте 0. Цей прапорець є бета-версією і може змінюватися в майбутньому.
--field-selector string
	Селектор (запит поля) для фільтрації підтримує '=', '==' і '!=' (наприклад, --field-selector key1=value1,key2=value2). Сервер підтримує лише обмежену кількість запитів до полів кожного типу.
-f, --filename strings
	Імʼя файлу, теки або URL до файлів, яки визначають ресурс, для отримання з сервера.
-h, --help
	Довідка get
--ignore-not-found
	Якщо запитуваний обʼєкт не існує, команда поверне код виходу 0.
-k, --kustomize string
	Обробити теку kustomization. Цей прапорець не можна використовувати разом з -f або -R.
-L, --label-columns strings
	Приймає список міток, розділених комами, які буде представлено у вигляді стовпчиків. Назви чутливі до регістру. Ви також можете використовувати декілька прапорців, наприклад, -L label1 -L label2...
--no-headers
	При використанні стандартного або власного формату виводу стовпців не друкувати заголовки (заголовки стандартно друкуються).
-o, --output string
	Формат виводу. Один з: (json, yaml, name, go-template, go-template-file, template, templatefile, jsonpath, jsonpath-as-json, jsonpath-file, custom-columns, custom-columns-file, wide).Дивіться нестандартні стовпці [https://kubernetes.io/docs/reference/kubectl/#custom-columns](/uk/docs/reference/kubectl/#custom-columns), шаблон golang [http://golang.org/pkg/text/template/#pkg-overview] та шаблон jsonpath [https://kubernetes.io/docs/reference/kubectl/jsonpath/](/uk/docs/reference/kubectl/jsonpath/).
--output-watch-events
	Виводити обʼєкти подій спостереження, якщо використовується --watch або --watch-only. Існуючі обʼєкти виводяться як початкові події ADDED.
--raw string
	Необроблений URI для запиту з сервер. Використовує транспорт, вказаний у файлі kubeconfig.
-R, --recursive
	Рекурсивно обробити теку, вказану у -f, --filename. Корисно, якщо ви хочете керувати повʼязаними маніфестами, організованими в одній теці.
-l, --selector string
	Селектор (запит на мітки) для фільтрації, що підтримує '=', '==' і '!=' (наприклад, -l key1=value1,key2=value2). Обʼєкти, щоб мати збіг, повинні задовольняти усім зазначеним обмеженням міток.
--server-print Типово: true
	Якщо це значення true, сервер має повернути відповідний вивід таблиці. Підтримує API розширення та CRD.
--show-kind
	Якщо є, вкажіть тип ресурсу для запитуваного обʼєкта (обʼєктів).
--show-labels
	Під час друку показувати всі мітки в останньому стовпчику (стандартно приховувати стовпчик міток)
--show-managed-fields
	Якщо true, зберігати managedFields при виводі обʼєктів у форматі JSON або YAML.
--sort-by string
	Якщо поле не порожнє, відсортувати список ресурсів за вказаним полем. Специфікація поля виражається у вигляді виразу JSONPath (наприклад, '{.metadata.name}'). Поле в ресурсі API, визначене цим виразом JSONPath, має бути цілим чи рядком.
--subresource string
	Якщо вказано, редагування працюватиме з субресурсом запитуваного обʼєкта. Цей прапорець є бета-версією і може змінюватися у майбутньому.
--template string
	Рядок шаблону або шлях до файлу шаблону для використання з -o=go-template, -o=go-template-file. Формат шаблону — golang-шаблони [http://golang.org/pkg/text/template/#pkg-overview].
-w, --watch
	Після отримання списку бажаних подій слідкувати за новими подіями.
--watch-only
	Спостерігати за змінами запитуваного обʼєкта (обʼєктів), не переглядаючи/отримуючи їх спочатку.

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

--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