{"id":13522883,"url":"https://github.com/bmcustodio/kubectl-cilium","last_synced_at":"2025-08-24T22:33:52.257Z","repository":{"id":62865259,"uuid":"250790257","full_name":"bmcustodio/kubectl-cilium","owner":"bmcustodio","description":"A 'kubectl' plugin for interacting with Cilium.","archived":false,"fork":false,"pushed_at":"2022-09-02T04:32:30.000Z","size":37,"stargazers_count":28,"open_issues_count":5,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-23T04:44:38.872Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bmcustodio.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":"2020-03-28T12:32:08.000Z","updated_at":"2025-03-10T19:43:26.000Z","dependencies_parsed_at":"2022-11-08T06:33:52.052Z","dependency_job_id":null,"html_url":"https://github.com/bmcustodio/kubectl-cilium","commit_stats":null,"previous_names":["bmcstdio/kubectl-cilium"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/bmcustodio/kubectl-cilium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcustodio%2Fkubectl-cilium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcustodio%2Fkubectl-cilium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcustodio%2Fkubectl-cilium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcustodio%2Fkubectl-cilium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bmcustodio","download_url":"https://codeload.github.com/bmcustodio/kubectl-cilium/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bmcustodio%2Fkubectl-cilium/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265237713,"owners_count":23732516,"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":[],"created_at":"2024-08-01T06:00:53.283Z","updated_at":"2025-07-14T03:34:25.913Z","avatar_url":"https://github.com/bmcustodio.png","language":"Go","funding_links":[],"categories":["kubectl Plugins"],"sub_categories":["Installing plugins via awesome-kubectl-plugins"],"readme":"# kubectl-cilium\n\nA `kubectl` plugin for interacting with [Cilium](https://cilium.io).\n\n![Release](https://img.shields.io/github/v/release/bmcustodio/kubectl-cilium)\n![Downloads](https://img.shields.io/github/downloads/bmcustodio/kubectl-cilium/total?color=green)\n[![Build](https://img.shields.io/travis/com/bmcustodio/kubectl-cilium)](https://travis-ci.com/bmcustodio/kubectl-cilium)\n![License](https://img.shields.io/github/license/bmcustodio/kubectl-cilium)\n\n## Installation\n\n`kubectl-cilium` can be installed using [Krew](https://github.com/kubernetes-sigs/krew):\n\n```shell\n$ kubectl krew install cilium\n```\n\nAlternatively, `kubectl-cilium` can be installed by running\n\n```shell\n$ go get github.com/bmcustodio/kubectl-cilium/cmd/kubectl-cilium\n```\n\nor by cloning this repository, running\n\n```shell\n$ make build\n```\n\nand copying `./bin/kubectl-cilium` to a directory in your `$PATH`.\n\n## Examples\n\n### `kubectl-cilium exec`\n\nThe `exec` command allows you to execute a command on a Cilium agent targeted by either a node name or a `namespace/name` key targeting any pod in the cluster.\nFor example, assuming that your Kubernetes cluster has nodes\n\n```shell\n$ kubectl get node                                                                                                                                            \nNAME                               STATUS   ROLES    AGE   VERSION                                                                                      \nkind-cilium-mesh-2-control-plane   Ready    master   87m   v1.18.0                                                                           \nkind-cilium-mesh-2-worker          Ready    \u003cnone\u003e   86m   v1.18.0                                                    \nkind-cilium-mesh-2-worker2         Ready    \u003cnone\u003e   86m   v1.18.0\n```\n\nand pods\n\n```shell\n$ kubectl get pod --all-namespaces\nNAMESPACE            NAME                                                       READY   STATUS        RESTARTS   AGE   IP            NODE\nkube-system          cilium-8dzvt                                               1/1     Running       0          86m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          cilium-8lmlb                                               1/1     Running       0          86m   172.17.0.5    kind-cilium-mesh-2-worker       \nkube-system          cilium-etcd-2pphwr5jhg                                     1/1     Running       0          88m   10.20.2.12    kind-cilium-mesh-2-worker       \nkube-system          cilium-etcd-operator-59b4987745-n94pb                      1/1     Running       0          90m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          cilium-jcs44                                               1/1     Running       0          86m   172.17.0.6    kind-cilium-mesh-2-worker2      \nkube-system          cilium-operator-77dd4b8544-vb2kf                           1/1     Running       0          86m   172.17.0.5    kind-cilium-mesh-2-worker       \nkube-system          coredns-5644d7b6d9-fhmff                                   1/1     Running       0          81m   10.20.2.62    kind-cilium-mesh-2-worker       \nkube-system          coredns-5644d7b6d9-x9ksr                                   1/1     Running       0          81m   10.20.0.68    kind-cilium-mesh-2-control-plane\nkube-system          etcd-kind-cilium-mesh-2-control-plane                      1/1     Running       0          90m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          etcd-operator-59cf4cfb7c-4snqh                             1/1     Running       0          81m   10.20.2.109   kind-cilium-mesh-2-worker       \nkube-system          kube-apiserver-kind-cilium-mesh-2-control-plane            1/1     Running       0          90m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          kube-controller-manager-kind-cilium-mesh-2-control-plane   1/1     Running       0          90m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          kube-proxy-tk2xm                                           1/1     Running       0          90m   172.17.0.5    kind-cilium-mesh-2-worker       \nkube-system          kube-proxy-wwl2g                                           1/1     Running       0          90m   172.17.0.6    kind-cilium-mesh-2-worker2      \nkube-system          kube-proxy-zrz4z                                           1/1     Running       0          91m   172.17.0.7    kind-cilium-mesh-2-control-plane\nkube-system          kube-scheduler-kind-cilium-mesh-2-control-plane            1/1     Running       0          90m   172.17.0.7    kind-cilium-mesh-2-control-plane\nlocal-path-storage   local-path-provisioner-7745554f7f-9mmr8                    1/1     Running       1          91m   10.20.0.114   kind-cilium-mesh-2-control-plane\n```\n\nrunning\n\n```shell\n$ kubectl-cilium exec local-path-storage/local-path-provisioner-7745554f7f-9mmr8 cilium monitor\n```\n\nwill start monitoring all Cilium-managed traffic in node `kind-cilium-mesh-2-control-plane`:\n\n```shell\n$ kubectl-cilium exec local-path-storage/local-path-provisioner-7745554f7f-9mmr8 cilium monitor\nListening for events on 4 CPUs with 64x4096 of shared memory\nPress Ctrl-C to quit\nlevel=info msg=\"Initializing dissection cache...\" subsys=monitor\n-\u003e overlay flow 0x883a3a1b identity 4-\u003e0 state new ifindex cilium_vxlan orig-ip 0.0.0.0: 10.20.0.234:4240 -\u003e 10.20.2.90:59456 tcp ACK\n-\u003e endpoint 1534 flow 0xef026664 identity 6-\u003e4 state established ifindex lxc_health orig-ip 10.20.2.90: 10.20.2.90:59456 -\u003e 10.20.0.234:4240 tcp ACK\n-\u003e endpoint 1980 flow 0xb0e8433f identity 1-\u003e104 state new ifindex lxcb42c26c3bbf8 orig-ip 10.20.0.122: 10.20.0.122:47168 -\u003e 10.20.0.68:8181 tcp SYN\n-\u003e host from flow 0x4a33a3f3 identity 104-\u003e1 state reply ifindex cilium_net orig-ip 0.0.0.0: 10.20.0.68:8181 -\u003e 10.20.0.122:47168 tcp SYN, ACK\n(...)\n```\n\nIf no command is specified, `/bin/bash` is used by default:\n\n```shell\n$ kubectl-cilium exec local-path-storage/local-path-provisioner-7745554f7f-9mmr8\nroot@kind-cilium-mesh-2-control-plane:~#\n```\n\n## License\n\nCopyright 2020 bmcustodio\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmcustodio%2Fkubectl-cilium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbmcustodio%2Fkubectl-cilium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbmcustodio%2Fkubectl-cilium/lists"}