tchia04 / pkenv

Packer version manager

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status

pkenv

Packer version manager mainly inspired by tfenv

Support

Currently pkenv supports the following OSes

  • Linux (64bit) (tested)

Installation

On Mac OS X, you can install pkenv with Homebrew:

$ brew tap kwilczynski/homebrew-pkenv
$ brew install pkenv

On any other platform, you can install pkenv as follows:

  1. Check out pkenv into any path (here is ${HOME}/.pkenv)
$ git clone https://github.com/iamhsa/pkenv.git ~/.pkenv
  1. Add ~/.pkenv/bin to your $PATH any way you like
$ echo 'export PATH="$HOME/.pkenv/bin:$PATH"' >> ~/.bash_profile

OR you can make symlinks for pkenv/bin/* scripts into a path that is already added to your $PATH (e.g. /usr/local/bin) OSX/Linux Only!

$ echo 'export PATH="$HOME/.pkenv/bin:$PATH"' >> ~/.bash_profile

OR you can make symlinks for pkenv/bin/* scripts into a path that is already added to your $PATH (e.g. /usr/local/bin) OSX/Linux Only!

$ ln -s ~/.pkenv/bin/* /usr/local/bin

Usage

pkenv install

Install a specific version of Packer latest is a syntax to install latest version latest:<regex> is a syntax to install latest version matching regex (used by grep -e)

$ pkenv install 0.7.0
$ pkenv install latest
$ pkenv install latest:^0.12

If shasum is present in the path, pkenv will verify the download against Hashicorp's published sha256 hash. If keybase is available in the path it will also verify the signature for those published hashes using hashicorp's published public key.

If you use .packer-version, pkenv install (no argument) will install the version written in it.

Specify architecture

Architecture other than the default amd64 can be specified with the PKENV_ARCH environment variable

PKENV_ARCH=arm pkenv install 0.7.9

pkenv use

Switch a version to use latest is a syntax to use the latest installed version latest:<regex> is a syntax to use latest installed version matching regex (used by grep -e)

$ pkenv use 0.12.3
$ pkenv use latest
$ pkenv use latest:^0.12

pkenv uninstall

Uninstall a specific version of Packer latest is a syntax to uninstall latest version latest:<regex> is a syntax to uninstall latest version matching regex (used by grep -e)

$ pkenv uninstall 0.7.0
$ pkenv uninstall latest
$ pkenv uninstall latest:^0.8

pkenv list

List installed versions

% pkenv list
* 1.1.1 (set by /opt/pkenv-build/work/pkenv/version)
  0.12.3
  0.12.2
  0.7.5
  0.6.1

pkenv list-remote

List installable versions

% pkenv list-remote
0.12.3
0.12.2
0.12.1
0.12.0
0.11.0
0.10.2
0.10.1
0.10.0
...

.packer-version

If you put .packer-version file on your project root, or in your home directory, pkenv detects it and use the version written in it. If the version is latest or latest:<regex>, the latest matching version currently installed will be selected.

$ cat .packer-version
0.12.2

$ packer version
Packer v0.12.2

$ echo 0.12.0 > .packer-version

$ packer version
Packer v0.12.0

$ echo latest:^0.12 > .packer-version

$ packer version
Packer v0.12.3

Upgrading

$ git --git-dir=~/.pkenv/.git pull

Uninstalling

$ rm -rf /some/path/to/pkenv

LICENSE

About

Packer version manager

License:MIT License


Languages

Language:Shell 100.0%