{"id":13522450,"url":"https://github.com/makocchi-git/kubectl-free","last_synced_at":"2025-07-03T20:34:47.601Z","repository":{"id":57509221,"uuid":"193948808","full_name":"makocchi-git/kubectl-free","owner":"makocchi-git","description":"Show various requested resources on Kubernetes nodes","archived":false,"fork":false,"pushed_at":"2019-08-07T10:13:05.000Z","size":106,"stargazers_count":21,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-08T10:08:14.405Z","etag":null,"topics":["k8s","kubectl","kubectl-plugin","kubectl-plugins","kubernetes"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makocchi-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-26T17:22:38.000Z","updated_at":"2025-02-19T08:29:49.000Z","dependencies_parsed_at":"2022-08-30T07:10:37.244Z","dependency_job_id":null,"html_url":"https://github.com/makocchi-git/kubectl-free","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/makocchi-git/kubectl-free","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makocchi-git%2Fkubectl-free","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makocchi-git%2Fkubectl-free/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makocchi-git%2Fkubectl-free/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makocchi-git%2Fkubectl-free/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makocchi-git","download_url":"https://codeload.github.com/makocchi-git/kubectl-free/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makocchi-git%2Fkubectl-free/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263400894,"owners_count":23460995,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["k8s","kubectl","kubectl-plugin","kubectl-plugins","kubernetes"],"created_at":"2024-08-01T06:00:47.436Z","updated_at":"2025-07-03T20:34:47.552Z","avatar_url":"https://github.com/makocchi-git.png","language":"Go","funding_links":[],"categories":["kubectl Plugins"],"sub_categories":["Installing plugins via awesome-kubectl-plugins"],"readme":"# kubectl free\n\n[![Build Status](https://travis-ci.org/makocchi-git/kubectl-free.svg?branch=master)](https://travis-ci.org/makocchi-git/kubectl-free)\n[![Maintainability](https://api.codeclimate.com/v1/badges/b92591d00becc95b11ca/maintainability)](https://codeclimate.com/github/makocchi-git/kubectl-free/maintainability)\n[![Go Report Card](https://goreportcard.com/badge/github.com/makocchi-git/kubectl-free)](https://goreportcard.com/report/github.com/makocchi-git/kubectl-free)\n[![codecov](https://codecov.io/gh/makocchi-git/kubectl-free/branch/master/graph/badge.svg)](https://codecov.io/gh/makocchi-git/kubectl-free)\n[![kubectl plugin](https://img.shields.io/badge/kubectl-plugin-blue.svg)](https://github.com/topics/kubectl-plugin)\n[![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)\n\nPrint pod resources/limits usage on Kubernetes node(s) like a linux \"free\" command.  \n\n```shell\n$ kubectl free\nNAME    STATUS   CPU/use   CPU/req   CPU/lim   CPU/alloc   CPU/use%   CPU/req%   CPU/lim%   MEM/use    MEM/req    MEM/lim    MEM/alloc   MEM/use%   MEM/req%   MEM/lim%\nnode1   Ready    58m       704m      304m      3600m       1%         19%        8%         2144333K   807403K    375390K    5943857K    36%        13%        6%\nnode2   Ready    235m      350m      2100m     3600m       6%         9%         58%        2061467K   260046K    1304428K   5943857K    34%        4%         21%\nnode3   Ready    222m      2030m     12900m    3600m       6%         56%        358%       2935312K   3736783K   8347396K   5943865K    49%        62%        140%\n```\n\nAnd list containers of pod on Kubernetes node(s).\n\n```shell\n$ kubectl free --list node1 --all-namespaces\nNODE NAME  NAMESPACE     POD NAME                               POD AGE   POD IP       POD STATUS   CONTAINER            CPU/use   CPU/req   CPU/lim   MEM/use   MEM/req   MEM/lim\nnode1      default       nginx-7cdbd8cdc9-q2bbg                 3d22h     10.112.2.43  Running      nginx                2m        100m      2         27455K    134217K   1073741K\nnode1      kube-system   coredns-69dc677c56-chfcm               9d        10.112.3.2   Running      coredns              3m        100m      -         17420K    73400K    178257K\nnode1      kube-system   kube-flannel-ds-amd64-4b4s2            9d        10.1.2.3     Running      kube-flannel         4m        100m      100m      13877K    52428K    52428K\nnode1      kube-system   kube-state-metrics-69bcc79474-wvmmk    9d        10.112.3.3   Running      kube-state-metrics   11m       104m      104m      33382K    113246K   113246K\nnode1      kube-system   kube-state-metrics-69bcc79474-wvmmk    9d        10.112.3.3   Running      addon-resizer        1m        100m      100m      8511K     31457K    31457K\n...\n```\n\n## Install\n\n`kubectl-free` binary is available at [release page](https://github.com/makocchi-git/kubectl-free/releases) or you can make binary.\n\n```shell\n$ make\n$ mv _output/kubectl-free /usr/local/bin/.\n```\n\n```\n# Happy free time!\n$ kubectl free\n```\n\n## Usage\n\n```shell\n# Show pod resource usage of Kubernetes nodes (default namespace is \"default\").\nkubectl free\n\n# Show pod resource usage of Kubernetes nodes (all namespaces).\nkubectl free --all-namespaces\n\n# Show pod resource usage of Kubernetes nodes with number of pods and containers.\nkubectl free --pod\n\n# Using label selector.\nkubectl free -l key=value\n\n# Print raw(bytes) usage.\nkubectl free --bytes --without-unit\n\n# Using binary prefix unit (GiB, MiB, etc)\nkubectl free -g -B\n\n# List resources of containers in pods on nodes.\nkubectl free --list\n\n# List resources of containers in pods on nodes with image information.\nkubectl free --list --list-image\n\n# Print container even if that has no resources/limits.\nkubectl free --list --list-all\n\n# Do you like emoji? 😃\nkubectl free --emoji\nkubectl free --list --emoji\n```\n\n## Notice\n\n~~This plugin shows just sum of requested(limited) resources, **not a real usage**.  \nI recommend to use `kubectl free` with `kubectl top`.~~\n\nkubectl free v0.2.0 supports printing real usages from metrics server in a target cluster.  \nYou can disable printing usage with `--no-metrics` option.\n\n## License\n\nThis software is released under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakocchi-git%2Fkubectl-free","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakocchi-git%2Fkubectl-free","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakocchi-git%2Fkubectl-free/lists"}