[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_144":145},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)",{"_23":24,"_25":26,"_71":72,"_83":-7,"_84":-7,"_85":-7,"_86":-7,"_87":-5,"_88":-5,"_89":11,"_90":11,"_65":91,"_136":17,"_107":108,"_137":106,"_138":64,"_31":32,"_139":11,"_140":17,"_141":43,"_142":-5,"_143":11},"scanningType","none","tagData",{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_56":57,"_58":30,"_59":60,"_61":62,"_63":64,"_65":66,"_67":45,"_68":57,"_69":54,"_70":17},"content_type","image","creator",7391327,"digest","sha256:35428a648fe064f25cc9be5c39e11bb67be0eeacfa5b44f6d2fa11b825e39c24","full_size",14347501,"id",268478409,"images",[39],{"_40":41,"_31":32,"_42":43,"_44":45,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":34,"_53":54,"_55":-5},"architecture","arm64","features","","last_pulled","2026-09-19T00:42:01.573595559Z","last_pushed","2023-03-01T20:02:33Z","os","linux","os_features","os_version","size","status","active","variant","last_updated","2023-03-01T20:02:33.490863Z","last_updater","last_updater_username","ligatobot","media_type","application/vnd.docker.container.image.v1+json","name","v0.2","repository",12114096,"tag_last_pulled","tag_last_pushed","tag_status","v2","tagImages",[73],{"_40":41,"_31":32,"_42":43,"_44":45,"_46":47,"_74":75,"_48":49,"_50":43,"_51":-5,"_52":34,"_53":54,"_55":-5},"layers",[76,80],{"_31":77,"_52":34,"_78":79},"sha256:2192382f44c17733fa1d523e46f7fb08d08f06243ff0ae3e7ae676f2e7bd0663","instruction","COPY vpp-probe / # buildkit",{"_52":81,"_78":82,"_31":43},0,"ENTRYPOINT [\"/vpp-probe\"]","layerOrdinals","packageName","cveId","sbom","scoutSummary","staticSummary","isScoutPaymentRequired","canSeeVulnerabilities",{"_92":93,"_94":95,"_96":97,"_98":99,"_100":11,"_56":101,"_102":103,"_104":105,"_63":106,"_107":108,"_109":110,"_111":28,"_112":113,"_53":113,"_114":54,"_115":-5,"_116":81,"_117":118,"_119":11,"_120":60,"_121":122,"_127":11,"_128":129,"_133":108,"_134":135},"categories",[],"content_types",[28],"date_registered","2021-04-07T10:25:16.058345Z","description","A CLI tool for inspecting VPP instances running anywhere ","is_private","2023-03-01T20:02:34.532421Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[62],"vpp-probe","namespace","ligato","pull_count",713,"repository_type","star_count",1,"status_description","source","collaborator_count","full_description","

vpp-probe

\n $\"GitHub$ $\"Docker$ \n

\n\n---\n\n## Intro\n\nVPP-probe is a command-line tool for inspecting and monitoring of VPP instances running in any kind of environment (_Kubernetes_, _Docker_, _Local_). It aims to help during debugging of issues that occur in the distributed systems containing several VPP instances.\n\n### Features\n\n- **Instance Discovery** - discover VPP instances in the target system environment\n- **Packet Tracing** - trace packets from multiple VPP instances while executing arbitrary command \n- **Command Execution** - execute commands on multiple VPP instances at once \n- **Topology Auto-Correlation** - automatic correlation of connections across VPP instances\n\n## Install\n\nYou can get vpp-probe by downloading a pre-compiled binary, using the official Docker image or building it from source.\n\n### Download a pre-compiled binary\n\nGo to [GitHub Releases](https://github.com/ligato/vpp-probe/releases) and download a binary pre-compiled for your system.\n\n### Get Docker image\n\nGo to [DockerHub Tags](https://hub.docker.com/r/ligato/vpp-probe/tags) for list of available tags.\n\n##### Prerequisites\n\n- [Docker](https://docs.docker.com/get-docker/) is required\n\n```sh\n# Pull the latest image\ndocker pull ligato/vpp-probe\n\n# Print version\ndocker run --rm -it ligato/vpp-probe version\n```\n\n### Build from source\n\n##### Prerequisites\n\n- [Go 1.15+](https://golang.org/doc/install) is required\n\nTo install vpp-probe from source simply run:\n\n```sh\n# Install the latest version\ngo install go.ligato.io/vpp-probe@latest\n# if you have Go older than 1.16 run: GO111MODULE=on go get go.ligato.io/vpp-probe\n\n# Print version\nvpp-probe version\n```\n\n## Quick Start\n\nWhere is your VPP running?\n\n

\n\n

Kubernetes

\n\nBasic commands for VPP running in a Kubernetes pod\n\n```sh\n# Discover VPP instances in a cluster\nvpp-probe --env=kube discover\n\n# Execute a command on all VPP instances\nvpp-probe --env=kube exec -- \"vppctl show counters\"\n\n# Trace packets on all VPP instances for the duration of ping command\nvpp-probe --env=kube trace \"kubectl exec -it mypod -- ping -c 1 10.10.1.1\"\n```\n\nSpecify target cluster(s) (kubeconfig/context)\n\n```sh\n# Run on different cluster by providing custom kubeconfig and/or context\nvpp-probe --kubeconfig=\"my.kubeconfig\" \nvpp-probe --kubecontext=\"kind-2\" \n\n# Run on multiple clusters by adding another kubeconfig/context separated by comma\nvpp-probe --kubeconfig=\"kubeconfig1,kubeconfig2\" \nvpp-probe --kubecontext=\"kind-2,kind-3\" \n```\n\nWhen running vpp-probe from Docker image\n\n```sh\n# Run from Docker image\ndocker run -it --net=host --volume \"$HOME/.kube/config:/.kube/config\" ligato/vpp-probe --env=kube \n```\n\n

\n\n

Docker

\n\nBasic commands for VPP running in a Docker container\n\n```sh\n# Discover VPP instances in Docker\nvpp-probe --env=docker discover\n\n# Execute a command on all VPP instances\nvpp-probe --env=docker exec -- \"vppctl show counters\"\n\n# Trace packets on all VPP instances for the duration of ping command\nvpp-probe --env=docker trace \"docker exec -it mycontainer ping -c 1 172.17.0.3\"\n```\n\nSpecify a different Docker daemon\n\n```sh\n# Run on different docker host\nvpp-probe --dockerhost=\"/var/run/docker2.sock\" \n```\n\nWhen running vpp-probe from Docker image\n\n```sh\n# Run from Docker image\ndocker run -it --net=host --volume \"/var/run/docker.sock:/var/run/docker.sock\" ligato/vpp-probe --env=docker \n```\n\n

\n\n

Local

\n\nBasic commands for VPP running locally\n\n```sh\n# Discover VPP instances running as local process\nvpp-probe --env=local discover\n\n# Execute a command on all VPP instances\nvpp-probe --env=local exec -- \"vppctl show counters\"\n\n# Trace packets on all VPP instances for the duration of ping command\nvpp-probe --env=local trace \"ping -c 1 192.168.1.1\"\n```\n\nWhen running vpp-probe from Docker image\n\n```sh\n# Run from Docker image\ndocker run -it --net=host --pid=host --volume \"/run/vpp:/run/vpp\" ligato/vpp-probe --env=local \n```\n\n

\n\n---\n\nFor more detailed usage information, read [docs/USAGE.md](docs/USAGE.md)\n\n## Testing\n\n```sh\n# Run integration tests\ngo test ./test/integration\n\n# Run e2e tests\ngo test ./test/e2e\n```\n\nFor more information about testing, read [docs/TESTING.m](docs/TESTING.md)\n\n## Development\n\nRead [docs/DEVELOP.md](docs/DEVELOP.md) for information about vpp-probe development.\n","has_starred","hub_user","immutable_tags_settings",{"_123":11,"_124":125},"enabled","rules",[126],".*","is_automated","permissions",{"_130":17,"_131":11,"_132":11},"read","write","admin","user","storage_size",90623932,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_23":24,"_85":-7,"_83":-7,"_84":-7,"_25":146,"_31":32,"_149":150,"_154":11},{"_27":28,"_29":30,"_31":32,"_33":34,"_35":36,"_37":147,"_56":57,"_58":30,"_59":60,"_61":62,"_63":64,"_65":66,"_67":45,"_68":57,"_69":54,"_70":17},[148],{"_40":41,"_31":32,"_42":43,"_44":45,"_46":47,"_48":49,"_50":43,"_51":-5,"_52":34,"_53":54,"_55":-5},"imageWithLayers",{"_40":41,"_31":32,"_42":43,"_44":45,"_46":47,"_74":151,"_48":49,"_50":43,"_51":-5,"_52":34,"_53":54,"_55":-5},[152,153],{"_31":77,"_52":34,"_78":79},{"_52":81,"_78":82,"_31":43},"hasPermissionToViewRepoSettings","actionData","errors"]

ligato/vpp-probe:v0.2