Warning This repository is not currently actively maintained. If you are interested in maintaining it, reach out to @ksatirli.

Homebrew: HashiCorp

Homebrew Tap for HashiCorp Suite of Tools

Table of Contents

• Homebrew: HashiCorp
  • Table of Contents
  • Requirements
  • Usage
    • Installing a Cask
  • Contributing
    • Adding or Updating Casks
  • Notes
  • Author Information
  • License

Requirements

• Homebrew
• macOS Mojave or macOS Catalina

Usage

Install this repository using the brew tap command:

brew tap operatehappy/homebrew-hashicorp

This Tap provides an exhaustive range of versions for the following applications:

• main Casks
  • Consul >= 1.0.0 and <= 1.8.0
  • Packer >= 1.0.0 and <= 1.5.6
  • Nomad >= 0.8.0-rc1 and <= 0.11.2
  • Vagrant >= 1.8.0 and <= 2.2.9
  • Vault >= 0.7.0 and <= 1.4.2
• misc. Casks
  • consul-aws >= 0.1.0 and <= 0.1.2
  • consul-template >= 0.1.0 and <= 0.25.0
  • envconsul >= 0.1.0 and <= 0.9.2
  • nomad-autoscaler >= 0.0.1 and <= 0.0.2
  • sentinel >= 0.10.0 and <= 0.15.5

Contrary to the upstream homebrew-core repository, this Tap uses pre-built binaries as available via releases.hashicorp.com.

Installing a Cask

Once the Tap is installed, you can use the brew cask install commands to install a Cask:

brew cask install product@X.Y.Z

For example, to install Vagrant 1.8.0 you would use the following:

brew cask install vagrant@1.8.0

Contributing

The operatehappy/homebrew-tools repository includes tools that assist with the generation of Casks for this and other @operatehappy-maintained Taps.

The generate-casks.sh and verify-casks.sh scripts expect the operatehappy/homebrew-tools repository to be available on the same level as this repository.

Adding or Updating Casks

In the following example, the steps reference a (currently unreleased) 1.9.9 version of Vagrant and a previously installed version of Vagrant 1.9.8.

Your contribution may be for a different product and version, but the steps remain alike:

• Edit the VAGRANT_19X_64BIT variable in VERSIONS.sh and add an entry of "1.9.9"

• Generate a Cask file for this version, using generate-casks.sh vagrant

• The generate-casks.sh helper will parse the VERSION.sh file and retrieve the checksum for Vagrant 1.9.9

• Use verify-casks.sh vagrant to verify installability of the newly generated Vagrant Cask

  • This helper will carry out the following steps:

    • Copy the generated Cask to $(brew --repo)/Library/Taps/operatehappy/homebrew-hashicorp/Casks/

    • Uninstalls the previously installed version of Vagrant using brew cask uninstall vagrant@1.9.8

    • Installs the new version using brew cask install vagrant@1.9.9

    • Lints the Cask file using brew cask style vagrant@1.9.9.

    • Uninstall the new version using brew cask uninstall vagrant@1.9.9

Notes

• An exhaustive list of versions, is available via VERSIONS.sh.

• Vagrant switched from a 32-bit architecture to a 64-bit one after version 1.9.2.

• For (legacy) versions of Terraform, please have a look at tfenv and tfswitch.

Author Information

This tap is maintained by the contributors listed on GitHub.

Development of this module was sponsored by Operate Happy.

Additionally, a special thanks goes out to the contributors of Brew's homebrew-core formulae:

• consul.rb
• consul-template.rb
• envconsul.rb
• nomad.rb
• packer.rb
• vagrant.rb
• vault.rb

License

Licensed under the Apache License, Version 2.0 (the "License").

You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" basis, without WARRANTIES or conditions of any kind, either express or implied.

See the License for the specific language governing permissions and limitations under the License.