Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robertpeteuil/terraform-installer
Installer for HashiCorp Terraform - Automatic Download, Extract and Install of Latest or Specific Version
https://github.com/robertpeteuil/terraform-installer
automated-deployment automation bash-script hashicorp hashicorp-downloads hashicorp-terraform installer linux macos terraform terraform-installer terraform-scripts windows
Last synced: about 1 month ago
JSON representation
Installer for HashiCorp Terraform - Automatic Download, Extract and Install of Latest or Specific Version
- Host: GitHub
- URL: https://github.com/robertpeteuil/terraform-installer
- Owner: robertpeteuil
- License: apache-2.0
- Created: 2018-02-01T18:28:22.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-10T23:53:55.000Z (almost 2 years ago)
- Last Synced: 2024-10-29T23:15:09.410Z (about 2 months ago)
- Topics: automated-deployment, automation, bash-script, hashicorp, hashicorp-downloads, hashicorp-terraform, installer, linux, macos, terraform, terraform-installer, terraform-scripts, windows
- Language: Shell
- Homepage:
- Size: 84 KB
- Stars: 75
- Watchers: 8
- Forks: 41
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Installer for HashiCorp Terraform - Automated Installation
## Automatically Download, Extract and Install Latest or Specific Version
[](https://github.com/robertpeteuil/terraform-installer)
[](https://github.com/robertpeteuil/terraform-installer)
[](https://github.com/robertpeteuil/terraform-installer)
---
**Note:** An updated script with additional capabilities and multi-product support has been published to the [hashicorp-installer](https://github.com/robertpeteuil/hashicorp-installer) repo. It defaults to installing Terraform and can be a drop-in replacement for this script.
---
The **terraform-install** script automates the process of downloading and installing Terraform. It provides an ideal method for installing installing updates or a specific version.
This script detects the latest version, OS and CPU-Architecture and allows installation to local or system locations. Optional parameters allow installing a specific version and installing to /usr/local/bin without prompting.
Example - install last pre-0.13 release: `./terraform-install.sh -i 0.12.29`
Options:
- `-i VERSION`: Install specific version
- `-a`: Automatically use `sudo` to install to /usr/local/bin
- allows for unattended installation via scripts or CD tools
- can be set as default behavior by uncommenting line 14 (`sudoInstall=true`)
- sudo password may be required unless NOPASSWD is enabled
- `-c`: leave binary in working directory (for CI/DevOps use)
- `-h`: help
- `-v`: display version
This installer is similar to my [Packer Installer](https://github.com/robertpeteuil/packer-installer) and [Vault Installer](https://github.com/robertpeteuil/vault-installer)
## Download and Use Locally
Download Installer
``` shell
curl -LO https://raw.github.com/robertpeteuil/terraform-installer/master/terraform-install.sh
chmod +x terraform-install.sh
```
Download installer via my bootstrap server (iac.sh or https://iac.sh)
``` shell
curl iac.sh/terraform > getinst.sh
bash getinst.sh
# installer downloaded as terraform-install.sh in current directory
```
### Run local installer
``` shell
./terraform-install.sh
# usage: terraform-install.sh [-i VERSION] [-a] [-c] [-h] [-v]
# -i VERSION : specify version to install in format '' (OPTIONAL)
# -a : automatically use sudo to install to /usr/local/bin
# -c : leave binary in working directory (for CI/DevOps use)
# -h : help
# -v : display vault-install.sh version
```
## System Requirements
- System with Bash Shell (Linux, macOS, Windows Subsystem for Linux)
- `unzip` - terraform downloads are in zip format
- `curl` or `wget` - script will use either one to retrieve metadata and download
Optional
- `jq` - if installed, latest version parsed from hashicorp downloads
- Useful if latest github release differs from version on hashicorp downloads
- Avoids github api limit of 60 requests per hour (unauthenticated)
## Script Process Details
- Determines Version to Download and Install
- Uses Version specified by `-i VERSION` parameter (if specified)
- Otherwise determines Latest Version
- If `jq` installed parse version from hashicorp downloads
- Otherwise use GitHub API to retrieve latest version
- Calculates Download URL based on Version, OS and CPU-Architecture
- Verifies URL Validity before Downloading in Case:
- VERSION incorrectly specified with `-i`
- Download URL Format Changed on terraform Website
- Determines Install Destination
- The destination can be specified with `-c` option, or passing `TF_INSTALL_DIR` environment variable
- The default is `/usr/local/bin` if it is writable, or with `-a`
- Otherwise the user is prompted for options
- Performed before Download/Install Process in case user selects `abort`
- Installation Process
- Download, Download SHA, Verify SHA of zip, Extract, Install, Cleanup and Display Results
### CPU Architecture Detection
CPU architecture is detected for each OS accordingly:
- Linux / Windows (WSL since this is a Bash script)
- detected with `lscpu` or by inspecting `/proc/cpuinfo`
- Arm variants use `arm` as it's the only `arm` version available (for now)
- macOS - uses Default Arch `amd64` as it's the only version available on macOS
- Default Value - `amd64`
## Disclaimer
I am a HashiCorp employee, but this is a personal project and not officially endorsed or supported by HashiCorp.
## License
Apache 2.0 License - Copyright (c) 2020 Robert Peteuil