cfdot is the CF Diego Operator Toolkit, a CLI tool designed to interact with Diego components.
At present, its commands focus on the Diego BBS API, the main public interface to a Diego deployment.
$ cfdot --help
A command-line tool to interact with a Cloud Foundry Diego deployment
Usage:
cfdot [command]
Available Commands:
actual-lrp-groups List actual LRP groups
actual-lrp-groups-for-guid List actual LRP groups for a process guid
create-desired-lrp Create a desired LRP
delete-desired-lrp Delete a desired LRP
desired-lrp Show the specified desired LRP
desired-lrp-scheduling-infos List desired LRP scheduling infos
desired-lrps List desired LRPs
domains List domains
retire-actual-lrp Retire actual LRP by index and process guid
set-domain Set domain
task Display task
update-desired-lrp Update a desired LRP
Use "cfdot [command] --help" for more information about a command.cfdot is most useful in the context of a running Diego deployment.
If you use the generate-deployment-manifest script in diego-release to generate your Diego manifest, cfdot is already available on the BOSH-deployed Diego VMs. To use it:
$ bosh ssh <DIEGO_JOB>/<INDEX>
$ source /var/vcap/jobs/cfdot/bin/setupThis setup script does 3 things:
- Exports environment variables to target the BBS API in the deployment.
- Puts the
cfdotbinary on thePATH. - Puts a
jqbinary on thePATH.
# count the total number of desired instances
$ cfdot desired-lrp-scheduling-infos | jq '.instances' | jq -s 'add'
568
# show instance counts by state
$ cfdot actual-lrp-groups | jq '.instance, .evacuating | values' | jq -s -r 'group_by(.state)[] | .[0].state + ": " + (length | tostring)'
CRASHED: 36
RUNNING: 531
UNCLAIMED: 1cfdot requires the Diego BBS client library.
If you have already cloned diego-release,
you can run the following commands using that diego-release directory as your GOPATH.
Alternatively, run these commands with any other GOPATH and go get will automatically fetch the latest BBS code from diego-release.
# Get cfdot and required dependencies
go get code.cloudfoundry.org/cfdot
cd src/code.cloudfoundry.org/cfdot
# Build for Linux
GOOS=linux go build .
# Build for Mac
GOOS=darwin go build .
# Build for Windows
GOOS=windows go build .- Execution is stateless: configuration is specified either as flags or as environment variables.
- Conform to UNIX conventions of successful output on stdout and error messages on stderr.
- For BBS API commands, output is a stream of JSON values, one per line, optimal for processing with
jqand suitable for processing withbashand other line-based UNIX utilities.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent