Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robertpeteuil/sentinel-installer
Installer for HashiCorp Sentinel Simulator - Automatic Download, Extract and Install of Latest or Specific Version
https://github.com/robertpeteuil/sentinel-installer
hashicorp hashicorp-downloads hashicorp-sentinel installer policy-as-code sentinel simulator
Last synced: 12 days ago
JSON representation
Installer for HashiCorp Sentinel Simulator - Automatic Download, Extract and Install of Latest or Specific Version
- Host: GitHub
- URL: https://github.com/robertpeteuil/sentinel-installer
- Owner: robertpeteuil
- License: apache-2.0
- Created: 2019-05-28T22:31:52.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-27T00:11:32.000Z (about 2 years ago)
- Last Synced: 2024-10-27T06:52:42.548Z (2 months ago)
- Topics: hashicorp, hashicorp-downloads, hashicorp-sentinel, installer, policy-as-code, sentinel, simulator
- Language: Shell
- Size: 13.7 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sentinel Installer - Automated Installation
## Automatically Download, Extract and Install Latest or Specific Version
[](https://github.com/robertpeteuil/sentinel-installer)
[](https://github.com/robertpeteuil/sentinel-installer)
[](https://github.com/robertpeteuil/sentinel-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.
---
The **sentinel-install** script automates the process of downloading and installing HashiCorp Sentinel. It provides an ideal method for installing on new hosts, installing updates and downgrading if necessary.
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.
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 [Terraform Installer](https://github.com/robertpeteuil/terraform-installer) and [Packer Installer](https://github.com/robertpeteuil/packer-installer)
## Download and Use Locally
Download Installer
``` shell
curl -LO https://raw.github.com/robertpeteuil/sentinel-installer/master/sentinel-install.sh
chmod +x sentinel-install.sh
```
Download installer via my bootstrap server (iac.sh or https://iac.sh)
``` shell
curl iac.sh/sentinel > getinst.sh
bash getinst.sh
# installer downloaded as sentinel-install.sh in current directory
```
### Run local installer
``` shell
./sentinel-install.sh
# usage: sentinel-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 sentinel-install.sh version
```
## System Requirements
- System with Bash Shell (Linux, macOS, Windows Subsystem for Linux)
- `unzip` - Sentinel Simulator downloads are in zip format
- `curl` or `wget` - script will use either one to retrieve metadata and download
- `jq` - required to get latest version from HashiCorp downloads
## Script Process Details
- Determines Version to Download and Install
- Uses Version specified by `-i VERSION` parameter (if specified)
- Otherwise determines Latest Version using `jq`
- 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 Sentinel Simulator Website
- Determines Install Destination
- 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`
- 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