{"id":31904142,"url":"https://github.com/cloudfoundry-community/toolbelt-boshrelease","last_synced_at":"2025-10-13T13:47:39.105Z","repository":{"id":3117636,"uuid":"48493055","full_name":"cloudfoundry-community/toolbelt-boshrelease","owner":"cloudfoundry-community","description":"A BOSH release to augment deployments with additional diagnostic tools","archived":false,"fork":false,"pushed_at":"2025-01-27T20:34:34.000Z","size":303,"stargazers_count":10,"open_issues_count":3,"forks_count":4,"subscribers_count":41,"default_branch":"master","last_synced_at":"2025-01-27T21:37:42.860Z","etag":null,"topics":["bosh-release"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/cloudfoundry-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-23T13:56:50.000Z","updated_at":"2025-01-27T20:34:39.000Z","dependencies_parsed_at":"2023-12-05T16:44:39.657Z","dependency_job_id":"3e5f2c22-0a66-4c5a-a7a3-831d2b6547d5","html_url":"https://github.com/cloudfoundry-community/toolbelt-boshrelease","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/cloudfoundry-community/toolbelt-boshrelease","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Ftoolbelt-boshrelease","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Ftoolbelt-boshrelease/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Ftoolbelt-boshrelease/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Ftoolbelt-boshrelease/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry-community","download_url":"https://codeload.github.com/cloudfoundry-community/toolbelt-boshrelease/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Ftoolbelt-boshrelease/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015339,"owners_count":26085685,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bosh-release"],"created_at":"2025-10-13T13:47:34.638Z","updated_at":"2025-10-13T13:47:39.100Z","avatar_url":"https://github.com/cloudfoundry-community.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"BOSH Toolbelt\n=============\n\n**Toolbelt** is an add-on BOSH release that provides a set of\npackages that are indispensible in troubleshooting and diagnosing\nissues on BOSH deployments.\n\nYes, yes, conventional wisdom holds that you ought not be SSHing\ninto your BOSH VMs to do things, but when systems break down,\non-box troubleshooting is often the fastest way to cut through to\nthe heart of the issue.\n\nBut first, you need a Toolbelt.\n\n\nUsing the Toolbelt\n------------------\n\nTo outfit your BOSH VMs with awesome tools, first upload Toolbelt\nto your BOSH director:\n\n    bosh target https://192.168.50.4:25555\n    bosh upload-release https://bosh.io/d/github.com/cloudfoundry-community/toolbelt-boshrelease\n\nThen, add the desired `toolbelt-*` templates to your releases:\n\n    instance_groups:\n      - name: my-job\n        jobs:\n        - { release: toolbelt, name: toolbelt }\n        - { release: toolbelt, name: toolbelt-quick }\n    releases:\n      - name: toolbelt\n        version: latest\n\nOr if you're looking to use `toolbelt` as a BOSH `add-on` via `runtime-config`:\n\n    addons:\n    - name: toolbelt\n      jobs:\n      - name: toolbelt\n        release: toolbelt\n      - name: toolbelt-quick\n        release: toolbelt\n    - name: toolbelt-veritas\n      include:\n        jobs:\n        - name: bbs\n          release: diego\n        - name: rep\n          release: diego\n        - name: auctioneer\n          release: diego\n      jobs:\n      - name: toolbelt-veritas\n        release: toolbelt\n    releases:\n    - name: toolbelt\n      sha1: 03b0e2136b02819ec59675f3e38edb24de2d92f9\n      url: https://bosh.io/d/github.com/cloudfoundry-community/toolbelt-boshrelease?v=3.3.2\n      version: 3.3.2\n\nThe `toolbelt` job sets up all users (present and future) on the\nbox to source in the appropriate `$PATH`, and `$LD_LIBRARY_PATH`\nenvironment variables, as well as a colorized prompt that shows\nyou which deployment you are on, what job type, and which\ninstance.o\n\nThe `toolbelt-quick` job pulls in a small subset of useful\npackages, tuned for a good utility-to-compile-time ratio (hence\nthe 'quick').\n\n\nTools On The Belt\n-----------------\n\nThe following `toolbelt-*` jobs exist:\n\n- `toolbelt-boss` - The Blacksmith CLI, [boss][boss]\n- `toolbelt-cf` - The Cloud Foundry CLI, [cf][cf]\n- `toolbelt-cfdot` - The Cloud Foundry Diego Operator Kit, [cfdot][cfdot]\n- `toolbelt-esuf` - The ElasticSearch Unassigned Fixer,\n  [esuf][esuf], for finding and fixigin UNASSIGNED shards on an\n  ElasticSearch cluster (i.e. Logsearch)\n- `toolbelt-gaol` - [A CLI for Garden][gaol]\n- `toolbelt-gotcha` - A small [MitM proxy][gotcha] for debugging\n  HTTP APIs that hide behind SSL/TLS.\n- `toolbelt-jq` - [jq][jq], it's sed for JSON.\n- `toolbelt-nload` - [nload][nload] Displays the current network usage\n- `toolbelt-nats` - A utiity for interacting with a NATS\n  messagebus.\n- `toolbelt-netsniff` - The excellent [netsniff-ng][netsniff-ng]\n  suite of networking diagnostics tools.  **LONG COMPILE TIMES**\n- `toolbelt-psql` - The [PostgreSQL CLI][psql].\n- `toolbelt-redis` - The [Redis CLI][redis].\n- `toolbelt-vault` - The [Vault CLI][vault], from Hashicorp.\n- `toolbelt-safe` - [safe][safe] is an alternate client for Vault.\n- `toolbelt-screen` - [screen][screen] Screen is a full-screen window manager that \n  multiplexes a physical terminal between several processes.\n- `toolbelt-tree` - Produce tree-based directory listings.\n- `toolbelt-tcptrace` - Colorized tcpdump packet captures.\n- `toolbelt-tshark` - Terminal-mode [Wireshark][tshark], for\n  analyzing network protocols at a higher level.  **LONG COMPILE\n  TIMES**\n- `toolbelt-veritas` - The [veritas][veritas] diagnostic tool for\n  the [Diego Runtime][diego].\n\nThere are some special _meta_-packages that provide subsets of the\nabove tools, as groups:\n\n- `toolbelt-everything` - Literally, everything.\n- `toolbelt-quick` - Just the stuff that compiles quickly (i.e.\n  not netsniff, tshark or veritas).\n\n\nPlaying on BOSH-lite\n--------------------\n\nYou can create a small, working manifest file from this git\nrepository:\n\n    git clone https://github.com/cloudfoundry-community/toolbelt-boshrelease\n    cd toolbelt-boshrelease\n    ./templates/make_manifest warden\n    bosh -n deploy\n\nThen, you can `bosh ssh` and see what it is like using Toolbelt!\n\n\n[boss]:        https://github.com/blacksmith-community/boss\n[cf]:          https://github.com/cloudfoundry/cli\n[cfdot]:       https://github.com/cloudfoundry/cfdot\n[esuf]:        https://github.com/starkandwayne/esuf\n[gaol]:        https://github.com/contraband/gaol\n[gotcha]:      https://github.com/jhunt/gotcha\n[jq]:          https://stedolan.github.io/jq/\n[netsniff-ng]: http://netsniff-ng.org/\n[nload]:       http://www.roland-riegel.de/nload/\n[psql]:        http://www.postgresql.org/\n[redis]:       http://redis.io/\n[vault]:       https://www.vaultproject.io/\n[safe]:        https://github.com/jhunt/safe\n[screen]:      https://www.gnu.org/software/screen/\n[tshark]:      https://www.wireshark.org/\n[veritas]:     https://github.com/pivotal-cf-experimental/veritas\n[diego]:       https://github.com/cloudfoundry-incubator/diego-release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Ftoolbelt-boshrelease","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry-community%2Ftoolbelt-boshrelease","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Ftoolbelt-boshrelease/lists"}