Просмотр кода страницы Kubectl

[[Категория:k8s]]
[[Категория:kubectl]]
=Шпаргалка по <code>kubectl</code>=
==Частные случаи==
===<code>--show-managed-fields </code> - посмотреть какие были операции с объектом===
иногда помогает найти когда были работы с объектом, например меняли ли его недавно (может не работать с CRD)
<BR>
<code>
kubectl -n kaas get secret iam-api-secrets --show-managed-fields -o yaml
</code>

===Вывод переносов строк с <code>-o jsonpath=</code> <code>{"\n"}</code>===
<code>
kubectl get pods -A -o jsonpath='{range .items[*]}{.status.podIP}{"\n"}{end}'
</code>

==Сортировка==

<code>
kubectl get events --sort-by=.metadata.creationTimestamp
</code>

==Поиск по полю==
Скорее всего это все можно делать используя <code>-o jsonpath</code>  но я встречал неоднократные упоминания о багах, по-тому использую <code>jq</code>
===простое условие===
Получить только имя репликасетов у которых число реплик = 1 <BR>
<code>kubectl get rs  -o json | jq -r '.items[] |select(.status.replicas==1) | .metadata.name'</code>

===Поиск специфичного объекта===
Получить секрет(ы) у которых в аннотации в поле <code>.metadata.annotations."lcm.mirantis.com/cluster-secret-type"</code> значение <code>"kubeconfig"</code> <BR>
(Пример специфичен для окружений определенного вида, но работает для любых объектов)
<code>
kubectl get secret -A  -o json | jq ' .items[] |  select(.metadata.annotations."lcm.mirantis.com/cluster-secret-type"=="kubeconfig") | .metadata.name'
</code>

Как писать такие запросы:
* Получить список,  тут видно что все объекты помешены в List <code>.items[]</code>
<PRE>
{
  "apiVersion": "v1",
  "items": [
    {
      "apiVersion": "v1",
      "kind": "Secret",
      "metadata": {
        "annotations": {
          "kubernetes.io/service-account.name": "default",
          "kubernetes.io/service-account.uid": "1ccf69fb-2f37-4684-bb16-19a8f20fd2fe"
        },
</PRE>
* Конструкция <code> jq '.items[] | <команда>'</code> проверяет каждый элемент списка, возвращая только соответствующие условию (в примере это условие <code>select(.metadata.annotations."lcm.mirantis.com/cluster-secret-type"=="kubeconfig")</code>)
* <code>.metadata.name</code> - вывести имя (но тут можно и содержимое или другое поле по желанию)


==Nodes==
===Метки===
<code>kubectl get nodes --show-labels</code>

===Top usage===
<code>kubectl top nodes</code>

===Фильтрация вывода - все кроме===
<code>kubectl get node --selector='!node-role.kubernetes.io/master'</code>

===Без хедеров ===
<code>
kubectl get node --no-headers -o custom-columns=NAME:.metadata.name
</code>

===Сортировка===
<code>
kubectl get node --sort-by .metadata.creationTimestamp
</code>

===Получение определенных полей с переименованием по аналогии с <code>SELECT AS ..</code>===
<code>
kubectl get no -o json | jq -r '[.items[] | {name:.metadata.name, id:.spec.externalID, unschedulable:.spec.unschedulable}]'
</code>
<PRE>
[
...
  {
    "name": "storage-3",
    "id": null,
    "unschedulable": null
  }
]
</PRE>

===Простой  просмотр утилизации===
Это конечно хорошо бы улучшить
<code>kubectl describe node | grep -A5 "Allocated"</code>
<PRE>
Allocated resources:
  (Total limits may be over 100 percent, i.e., overcommitted.)
  Resource           Requests     Limits
  --------           --------     ------
  cpu                1020m (8%)   4100m (34%)
  memory             1178Mi (0%)  3444Mi (2%)
</PRE>


==Pods==
===Список контейнеров в поде===
Для каждого контейнера  pod-name, container-image  container-name<BR>
Довольно коряво, конечно, но можно использовать как основу для своих скриптов
<PRE>

kubectl \
    get pods \
    -n osh-system \
    --selector=app.kubernetes.io/instance=openstack-operator \
    -o=jsonpath='{range .items[*]}{"\nStart output for POD: "}{.metadata.name}{"\nContaines:\n"}{range .spec.containers[*]}{.image}{"\t"}{.name}{"\n"}{end}{"End output for POD: "}{.metadata.name}{"\n"}{end}'

</PRE>
Пример вывода:
<PRE>
Start output for POD: openstack-controller-7896bc6d4d-l5mrz
Containes:
127.0.0.1:44301/openstack/openstack-controller:0.14.18	osdpl
127.0.0.1:44301/openstack/openstack-controller:0.14.18	secrets
127.0.0.1:44301/openstack/openstack-controller:0.14.18	health
127.0.0.1:44301/openstack/openstack-controller:0.14.18	node
127.0.0.1:44301/openstack/openstack-controller:0.14.18	nodemaintenancerequest
127.0.0.1:44301/openstack/openstack-controller:0.14.18	ceph-secrets
127.0.0.1:44301/openstack/openstack-controller:0.14.18	osdplstatus
127.0.0.1:44301/openstack/openstack-controller:0.14.18	osdplsecret
127.0.0.1:44301/openstack/openstack-controller:0.14.18	tf-secrets
End output for POD: openstack-controller-7896bc6d4d-l5mrz

Start output for POD: openstack-controller-admission-5d78bf4d84-jmghf
Containes:
127.0.0.1:44301/openstack/openstack-controller:0.14.18	openstack-operator
End output for POD: openstack-controller-admission-5d78bf4d84-jmghf

Start output for POD: openstack-controller-exporter-9f775b56f-gnntj
Containes:
127.0.0.1:44301/openstack/openstack-controller:0.14.18	exporter
End output for POD: openstack-controller-exporter-9f775b56f-gnntj
</PRE>
===Найти все поды по метке (<code>-l</code>) и вернуть список имеджей===
<code>kubectl get pods --all-namespaces -o=jsonpath='{..image}' -l app=prometheus</code>

===Число Pod на node===
<PRE>
kubectl get pod --all-namespaces -o json | jq '.items | group_by(.spec.nodeName) | map({"nodeName": .[0].spec.nodeName, "count": length}) | sort_by(.count)'
</PRE>
Пример результата
<PRE>
[
  ...
  {
    "nodeName": "os-control-1",
    "count": 55
  },
  {
    "nodeName": "os-control-3",
    "count": 70
  }
]
</PRE>

===Список запущенных и не запущенных POD===
Get Running pods only kubectl get pods --all-namespaces --field-selector=status.phase=Running

Get !Running pods kubectl get pods --all-namespaces --field-selector='status.phase!=Running

Get all pods in All-namespaces, return mem and cpu (FOR EACH POD!)

kubectl get po -n elasticsearch --selector=service=elasticsearch-data -o=jsonpath="{range .items[*]}{.metadata.namespace}:{.metadata.name}{'\n'}{range .spec.containers[*]} {.resources.requests.cpu}{'\t'}{end}{'\n'}{end}"
Describe a POD and list its IP kubectl describe pod 'kube-dns-2948363707' -n kube-system | grep IP | sed -E 's/IP:[[:space:]]+//'

Get the external IPs of PODs kubectl get nodes --all-namespaces -o jsonpath='{.items[*].status.addresses[?(@.type=="ExternalIP")].address}'

Show the images and their versions for each pod kubectl get pods --all-namespaces -o jsonpath="{..image}" | tr -s '[[:space:]]' '\n' | sort | uniq -c kubectl get pods --all-namespaces -o jsonpath="{.items[*].spec.containers[*].image}" kubectl get pods -n default --field-selector=status.phase=Running --selector=app=my-service -o jsonpath="{..image}" | tr -s '[[:space:]]' '\n' | sort | uniq -c

Delete terminated/evicted pods kubectl get po --selector=app=devops-logstash-service --field-selector=status.phase=Failed --no-headers -n elasticsearch | awk '{ print $1 }' | xargs -I {} kubectl delete po -n elasticsearch {}

Deployments

Get deployments, output as JSON, format output with JQ kubectl get deployment --namespace=kube-system -o=json | jq '.items[].metadata.labels'

Get K8S Deployments matching the selector (look for key k8s-app with value heapster) kubectl get deployment --all-namespaces --selector=k8s-app=heapster kubectl get svc --namespace=kube-system --selector=name=tiller

Scale a deployment kubectl scale -n kube-system --replicas=0 'deployments/kube-dns' kubectl scale -n kube-system --replicas=2 'deployments/kube-dns'

Export the YAML file of a deployment (for reuse, modification, etc,.) kubectl get deployments ghost --export -n ghost -o yaml > ghost.yaml

Replicasets

Get all replicasets sorted by the number of replicas kubectl get rs -n elasticsearch --sort-by='.spec.replicas'

Get all replicasets where replicas==0 in a specific namespace kubectl get rs -n elasticsearch -o json | jq -r '.items[] |select(.status.replicas==0) | .metadata.name'

Delete all replicasets that equal 0 in a specific namespace kubectl get rs -n elasticsearch -o json | jq -r '.items[] |select(.status.replicas==0) | .metadata.name' | xargs -I {} kubectl delete rs {}

Services

Get the self-link for a service using JSONPATH to format the output kubectl get svc heapster --namespace=kube-system -o=jsonpath={.metadata.selfLink}

Get 'service' external LB address kubectl get svc --namespace=kube-system -o=json | jq -r '.items[] | .status.loadBalancer.ingress[0]'

List all services in cluster and their nodePorts: kubectl get --all-namespaces svc -o json | jq -r '.items[] | [.metadata.name,([.spec.ports[].nodePort | tostring ] | join("|"))] | @csv'

Get Token for a service account & then get the secret

DEFAULT_TOKEN=$(kubectl --namespace=kube-system get serviceaccount default -o jsonpath="{.secrets[0].name}")
TOKEN_VALUE=$(kubectl --namespace=kube-system get secret "$DEFAULT_TOKEN" -o go-template="{{.data.token}}" | base64 -d)

# Use it in a curl request to the api-server

curl -k -H "Authorization: Bearer $TOKEN_VALUE" https://10.0.1.212:6443/version
curl -k -H "Authorization: Bearer $TOKEN_VALUE" https://localhost:6443/version
Ingress

List all ingresses hosts and paths: kubectl get --all-namespaces ing -o='custom-columns=NAME:.metadata.name,HOSTS:.spec.rules[*].host,PATHS:.spec.rules[*].http.paths[*].path'
Persistent Volumes

List persistent volume claims in the elasticsearch namespace and for each print name & capacity kubectl get persistentvolumeclaims -n elasticsearch -o=jsonpath="{range .items[*]}{..name}{'\t'}{..capacity}{'\n'}{end}"