[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_143":144},"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},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)",{"_22":23,"_24":25,"_70":71,"_82":-7,"_83":-7,"_84":-7,"_85":-7,"_86":-5,"_87":-5,"_88":11,"_89":11,"_64":90,"_135":17,"_106":107,"_136":105,"_137":63,"_39":40,"_138":11,"_139":17,"_140":42,"_141":-5,"_142":11},"scanningType","none","tagData",{"_26":27,"_28":29,"_30":31,"_32":33,"_34":35,"_55":56,"_57":29,"_58":59,"_60":61,"_62":63,"_64":65,"_66":44,"_67":56,"_68":53,"_69":17},"content_type","image","creator",7391327,"full_size",11801437,"id",145417556,"images",[36],{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":42,"_50":-5,"_51":31,"_52":53,"_54":-5},"architecture","amd64","digest","sha256:4e2ce50467a8b606027f232b375d47cb16dcb661d38571c757b88301a7fc041f","features","","last_pulled","2026-09-17T06:22:46.111277943Z","last_pushed","2021-04-13T18:07:45Z","os","linux","os_features","os_version","size","status","active","variant","last_updated","2021-04-13T18:07:44.547568Z","last_updater","last_updater_username","ligatobot","media_type","application/vnd.docker.container.image.v1+json","name","v0.1.0-beta.7","repository",12114096,"tag_last_pulled","tag_last_pushed","tag_status","v2","tagImages",[72],{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_73":74,"_47":48,"_49":42,"_50":-5,"_51":31,"_52":53,"_54":-5},"layers",[75,79],{"_39":76,"_51":31,"_77":78},"sha256:4e3f094356d19bb733d488ba653680712cca43a68564adc748dff53848713498","instruction","COPY vpp-probe / # buildkit",{"_51":80,"_77":81,"_39":42},0,"ENTRYPOINT [\"/vpp-probe\"]","layerOrdinals","packageName","cveId","sbom","scoutSummary","staticSummary","isScoutPaymentRequired","canSeeVulnerabilities",{"_91":92,"_93":94,"_95":96,"_97":98,"_99":11,"_55":100,"_101":102,"_103":104,"_62":105,"_106":107,"_108":109,"_110":27,"_111":112,"_52":112,"_113":53,"_114":-5,"_115":80,"_116":117,"_118":11,"_119":59,"_120":121,"_126":11,"_127":128,"_132":107,"_133":134},"categories",[],"content_types",[27],"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",[61],"vpp-probe","namespace","ligato","pull_count",708,"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",{"_122":11,"_123":124},"enabled","rules",[125],".*","is_automated","permissions",{"_129":17,"_130":11,"_131":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",{"_22":23,"_84":-7,"_82":-7,"_83":-7,"_24":145,"_39":40,"_148":149,"_153":11},{"_26":27,"_28":29,"_30":31,"_32":33,"_34":146,"_55":56,"_57":29,"_58":59,"_60":61,"_62":63,"_64":65,"_66":44,"_67":56,"_68":53,"_69":17},[147],{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":42,"_50":-5,"_51":31,"_52":53,"_54":-5},"imageWithLayers",{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_73":150,"_47":48,"_49":42,"_50":-5,"_51":31,"_52":53,"_54":-5},[151,152],{"_39":76,"_51":31,"_77":78},{"_51":80,"_77":81,"_39":42},"hasPermissionToViewRepoSettings","actionData","errors"]

ligato/vpp-probe:v0.1.0-beta.7