Homebrew Tap & Debian Packages for useful BOSH / Cloud Foundry / Kubernetes utilities. These were initially created by Stark & Wayne and contains some software they had written, and other community tools that have been found valuable in day-to-day operations with CF and Kubernetes.
Tap the formula repository:
brew tap cloudfoundry-community/cf
Current software offered:
| Package | Description | Author | Source |
|---|---|---|---|
| eden | CLI tool to interact with any Open Service Broker API | Stark & Wayne | starkandwayne/eden |
| genesis | BOSH Deployment Paradigm | Stark & Wayne | starkandwayne/genesis |
| gotcha | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic | Stark & Wayne | starkandwayne/gotcha |
| govc | vSphere CLI built on top of govmomi | VMWare | vmware/govmomi |
| kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB | Stark & Wayne | starkandwayne/kafka-service-broker |
| quaa | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | quaa |
| riff | CLI tool that helps developers build and run functions using Knative | Pivotal | projectriff/riff |
| safe | CLI tool to interact with a Vault server | Stark & Wayne | starkandwayne/safe |
| shield | CLI tool to interact with SHIELD, a data protection offering | Stark & Wayne | starkandwayne/shield |
| spruce | General purpose YAML & JSON merging tool | geoffranks et al. | geoffranks/spruce |
| uaa-cli | Experimental CLI for UAA written in Golang | Various | cloudfoundry-community/uaa-cli |
To install a package from our tap, run:
brew install cloudfoundry-community/cf/<package>, e.g. brew install cloudfoundry-community/cf/safe
Please note that while some of the above software is provided by other
formulas, we only support installations from our tap. Other taps contain
mismatched dependency versions which outright break some of our software.
Please make sure you prefix package names with
cloudfoundry-community/cf/<package> to avoid installing an unsupported
version.
This project automatically packages several CLI binaries as Debian packages as well. To add our APT repository to your OS:
wget -q -O - https://raw.githubusercontent.com/cloudfoundry-community/homebrew-cf/master/public.key | apt-key add -
echo "deb http://apt.community.cloudfoundry.org stable main" | tee /etc/apt/sources.list.d/starkandwayne.list
apt-get update
The above snippet will add our GPG key to your APT keychain, add the repository, and update your cache.
The following packages are provided by the APT repository:
| Package | Description | Author | Source |
|---|---|---|---|
| bosh-cli | CLI tool to interact with a BOSH director | Cloudfoundry | cloudfoundry/bosh-cli |
| bosh-bootloader | CLI tool for standing up a BOSH director | Cloudfoundry | cloudfoundry/bosh-bootloader |
| eden | CLI tool to interact with any Open Service Broker API | Stark & Wayne | starkandwayne/eden |
| certstrap | Tools to bootstrap CAs, certificate requests, and signed certificates. | Square | square/certstrap |
| cf-cli | [currently v6, PRs welcome] CLI tool to interact with the Cloudfoundry API | Cloudfoundry | cloudfoundry/cli |
| cf6-cli | legacy v6 CLI tool to interact with the Cloudfoundry API | Cloudfoundry | cloudfoundry/cli |
| cf7-cli | v7 CLI tool to interact with the Cloudfoundry API | Cloudfoundry | cloudfoundry/cli |
| v8 CLI tool is not yet provided, PRs are welcome | Cloudfoundry | cloudfoundry/cli | |
| credhub-cli | CLI tool to interact with a CredHub server | Cloudfoundry | cloudfoundry-community/credhub-cli |
| direnv | Environment switcher for the shell | direnv | direnv/direnv |
| genesis | BOSH Deployment Paradigm | Stark & Wayne | starkandwayne/genesis |
| gotcha | Small HTTP/HTTPS MITM proxy, to troubleshoot encrypted HTTP traffic | Stark & Wayne | starkandwayne/gotcha |
| govc | vSphere CLI built on top of govmomi | VMWare | vmware/govmomi |
| hub | CLI tool that wraps git in order to extend it with extra features | GitHub | github/hub |
| install-debs-in-order | Install Debian packages in order | Stark & Wayne | starkandwayne/install-debs-in-order |
| jq | Command-line JSON processor, like sed for JSON. |
Stedolan | stedolan/jq |
| kafka-service-broker | CLI tool to interact with Kafka/ZooKeeper OSB | Stark & Wayne | starkandwayne/kafka-service-broker |
| om | CLI tool to deploy products with Ops Manager | Pivotal | pivotal-cf/om |
| pivnet-cli | CLI tool to interact with the Pivotal Network | Pivotal | pivotal-cf/pivnet-cli |
| quaa | Tool to quickly deploy/run the Cloud Foundry UAA locally, or to a remote platform/cloud | Stark & Wayne | quaa |
| riff | CLI tool that helps developers build and run functions using Knative | Pivotal | projectriff/riff |
| safe | CLI tool to interact with a Vault server | Stark & Wayne | starkandwayne/safe |
| shield | CLI tool to interact with SHIELD, a data protection offering | Stark & Wayne | starkandwayne/shield |
| spruce | General purpose YAML & JSON merging tool | geoffranks et al. | geoffranks/spruce |
| terraform | Tool for building, changing, and combining infrastructure safely | HashiCorp | hashicorp/terraform |
| uaa-cli | Experimental CLI for UAA written in Golang | Various | cloudfoundry-community/uaa-cli |
| vault | Secrets management, encryption as a service, and privileged access management | HashiCorp | hashicorp/vault |
| aliyun-cli | Alibaba Cloud CLI | Alibaba Cloud | aliyun/aliyun-cli |
| minica | MiniCA | Jacob Hoffman-Andrews | jsha/minica |
To update the static site's index.html, run:
aws s3 sync apt/ s3://apt.community.cloudfoundry.org/
The CI pipeline to automatically update these Homebrew & Debian packages is:
- Pipeline is currently being migrated to a new Concourse
- Defined at https://github.com/cloudfoundry-community/homebrew-cf under the ci/ folder