cf-cli plugin to perform reverse lookups against service instance GUIDs
Pairs nicely with problematic BOSH service instances 👌👩🍳
This plugin aims to map between how BOSH references service deployments, e.g. service-instance_GUID, and how they're referenced in Cloud Foundry. It can be frustrating when tools like the bosh-cli and Prometheus/Alertmanager start yelling about a service instance barfing, but you have to spend time going through this whole riggamarole of looking up the service to see which org/space it belongs to, etc.
With this plugin, as long as you're logged into the same Cloud Foundry installation as the service-instance_GUID you're trying to find, this will go through the whole riggamarole of looking up the org/space of the service instance for you.
# get details on a service instance by it's GUID alone
cf rsl -s 8891ec47-4041-496b-af36-10d89c9513a6
# passing BOSH's default 'service-instance_' prefix is acceptable, too
cf rsl -s service-instance_8891ec47-4041-496b-af36-10d89c9513a6
# you can pass '-s service-instance_GUID' multiple times
cf rsl -s service-instance_8891ec47-4041-496b-af36-10d89c9513a6 -s bbaa77df-52e7-4d6a-8c86-d07a7c93ab82
# optionally, multiple different presentation formats can be specified
cf rsl -s xyz --format plain-text (default)
cf rsl -s xyz --format table
cf rsl -s xyz --format json
# or both, why not
cf rsl -s xyz --format table --format json--format plain-text:
d6bb8908-a8f8-46b9-9c21-3069cdb939ef
small-redis
grundlework
scratchpad--format json:
[
{
"organization": {
"name": "grundlework"
},
"service": {
"guid": "d6bb8908-a8f8-46b9-9c21-3069cdb939ef",
"name": "small-redis",
"space_guid": "8a90a486-6a40-4709-b65f-efe6705bdc8f"
},
"space": {
"name": "scratchpad",
"organization_guid": "d63feced-41d1-44d7-ba9b-8d062975313b"
}
}
]--format table:
+--------------------------------------+-------------+-------------+------------+
| SERVICE GUID | SERVICE | ORG | SPACE |
+--------------------------------------+-------------+-------------+------------+
| d6bb8908-a8f8-46b9-9c21-3069cdb939ef | small-redis | grundlework | scratchpad |
| a23c6626-2e42-484d-8664-0f6008316f09 | other-redis | otherorgxyz | 123xyspace |
+--------------------------------------+-------------+-------------+------------+If you want to try it out, install it directly from the github releases tab as follows:
# osx 64bit
cf install-plugin -f https://github.com/aegershman/cf-reverse-service-lookup-plugin/releases/download/0.7.0/cf-reverse-service-lookup-plugin-darwin
# linux 64bit (32bit and ARM6 also available)
cf install-plugin -f https://github.com/aegershman/cf-reverse-service-lookup-plugin/releases/download/0.7.0/cf-reverse-service-lookup-plugin-amd64
# windows 64bit (32bit also available)
cf install-plugin -f https://github.com/aegershman/cf-reverse-service-lookup-plugin/releases/download/0.7.0/cf-reverse-service-lookup-plugin-windows-amd64.exego get -u allgo mod tidy- update the plugin version in
main.go - update the
READMEinstall-plugin section to reference the new upcoming release version git tag 0.7.0-- or whatever version, of coursegit push origin --tagsexport GITHUB_TOKEN="xyzabc"goreleaser release
Ideas, use-cases, opinions on architecture, doc, etc. all welcome