|
|
|
#!/usr/bin/env bash
|
|
|
|
|
|
|
|
# Copyright The Helm Authors.
|
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.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.
|
|
|
|
|
|
|
|
# The install script is based off of the MIT-licensed script from glide,
|
|
|
|
# the package manager for Go: https://github.com/Masterminds/glide.sh/blob/master/get
|
|
|
|
|
|
|
|
PROJECT_NAME="helm"
|
|
|
|
|
|
|
|
: ${HELM_INSTALL_DIR:="/usr/local/bin"}
|
|
|
|
|
|
|
|
# initArch discovers the architecture for this system.
|
|
|
|
initArch() {
|
|
|
|
ARCH=$(uname -m)
|
|
|
|
case $ARCH in
|
|
|
|
armv5*) ARCH="armv5";;
|
|
|
|
armv6*) ARCH="armv6";;
|
|
|
|
armv7*) ARCH="armv7";;
|
|
|
|
aarch64) ARCH="arm64";;
|
|
|
|
x86) ARCH="386";;
|
|
|
|
x86_64) ARCH="amd64";;
|
|
|
|
i686) ARCH="386";;
|
|
|
|
i386) ARCH="386";;
|
|
|
|
esac
|
|
|
|
}
|
|
|
|
|
|
|
|
# initOS discovers the operating system for this system.
|
|
|
|
initOS() {
|
|
|
|
OS=$(echo `uname`|tr '[:upper:]' '[:lower:]')
|
|
|
|
|
|
|
|
case "$OS" in
|
|
|
|
# Minimalist GNU for Windows
|
|
|
|
mingw*) OS='windows';;
|
|
|
|
esac
|
|
|
|
}
|
|
|
|
|
|
|
|
# runs the given command as root (detects if we are root already)
|
|
|
|
runAsRoot() {
|
|
|
|
local CMD="$*"
|
|
|
|
|
|
|
|
if [ $EUID -ne 0 ]; then
|
|
|
|
CMD="sudo $CMD"
|
|
|
|
fi
|
|
|
|
|
|
|
|
$CMD
|
|
|
|
}
|
|
|
|
|
|
|
|
# verifySupported checks that the os/arch combination is supported for
|
|
|
|
# binary builds.
|
|
|
|
verifySupported() {
|
|
|
|
local supported="darwin-386\ndarwin-amd64\nlinux-386\nlinux-amd64\nlinux-arm\nlinux-arm64\nlinux-ppc64le\nwindows-386\nwindows-amd64"
|
|
|
|
if ! echo "${supported}" | grep -q "${OS}-${ARCH}"; then
|
|
|
|
echo "No prebuilt binary for ${OS}-${ARCH}."
|
replace github org with The Kubernetes package manager
To begin working with Helm, run the 'helm init' command:
$ helm init
This will install Tiller to your running Kubernetes cluster.
It will also set up any necessary local configuration.
Common actions from this point include:
- helm search: search for charts
- helm fetch: download a chart to your local directory to view
- helm install: upload the chart to Kubernetes
- helm list: list releases of charts
Environment:
$HELM_HOME set an alternative location for Helm files. By default, these are stored in ~/.helm
$HELM_HOST set an alternative Tiller host. The format is host:port
$HELM_NO_PLUGINS disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins.
$TILLER_NAMESPACE set an alternative Tiller namespace (default "kube-system")
$KUBECONFIG set an alternative Kubernetes configuration file (default "~/.kube/config")
Usage:
helm [command]
Available Commands:
completion Generate autocompletions script for the specified shell (bash or zsh)
create create a new chart with the given name
delete given a release name, delete the release from Kubernetes
dependency manage a chart's dependencies
fetch download a chart from a repository and (optionally) unpack it in local directory
get download a named release
history fetch release history
home displays the location of HELM_HOME
init initialize Helm on both client and server
inspect inspect a chart
install install a chart archive
lint examines a chart for possible issues
list list releases
package package a chart directory into a chart archive
plugin add, list, or remove Helm plugins
repo add, list, remove, update, and index chart repositories
reset uninstalls Tiller from a cluster
rollback roll back a release to a previous revision
search search for a keyword in charts
serve start a local http web server
status displays the status of the named release
template locally render templates
test test a release
upgrade upgrade a release
verify verify that a chart at the given path has been signed and is valid
version print the client/server version information
Flags:
--debug enable verbose output
-h, --help help for helm
--home string location of your Helm config. Overrides $HELM_HOME (default "/Users/rimas/.helm")
--host string address of Tiller. Overrides $HELM_HOST
--kube-context string name of the kubeconfig context to use
--tiller-connection-timeout int the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
--tiller-namespace string namespace of Tiller (default "kube-system")
Use "helm [command] --help" for more information about a command. one
6 years ago
|
|
|
echo "To build from source, go to https://github.com/helm/helm"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
if ! type "curl" > /dev/null && ! type "wget" > /dev/null; then
|
|
|
|
echo "Either curl or wget is required"
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
|
|
|
# checkDesiredVersion checks if the desired version is available.
|
|
|
|
checkDesiredVersion() {
|
|
|
|
# Use the GitHub releases webpage for the project to find the desired version for this project.
|
replace github org with The Kubernetes package manager
To begin working with Helm, run the 'helm init' command:
$ helm init
This will install Tiller to your running Kubernetes cluster.
It will also set up any necessary local configuration.
Common actions from this point include:
- helm search: search for charts
- helm fetch: download a chart to your local directory to view
- helm install: upload the chart to Kubernetes
- helm list: list releases of charts
Environment:
$HELM_HOME set an alternative location for Helm files. By default, these are stored in ~/.helm
$HELM_HOST set an alternative Tiller host. The format is host:port
$HELM_NO_PLUGINS disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins.
$TILLER_NAMESPACE set an alternative Tiller namespace (default "kube-system")
$KUBECONFIG set an alternative Kubernetes configuration file (default "~/.kube/config")
Usage:
helm [command]
Available Commands:
completion Generate autocompletions script for the specified shell (bash or zsh)
create create a new chart with the given name
delete given a release name, delete the release from Kubernetes
dependency manage a chart's dependencies
fetch download a chart from a repository and (optionally) unpack it in local directory
get download a named release
history fetch release history
home displays the location of HELM_HOME
init initialize Helm on both client and server
inspect inspect a chart
install install a chart archive
lint examines a chart for possible issues
list list releases
package package a chart directory into a chart archive
plugin add, list, or remove Helm plugins
repo add, list, remove, update, and index chart repositories
reset uninstalls Tiller from a cluster
rollback roll back a release to a previous revision
search search for a keyword in charts
serve start a local http web server
status displays the status of the named release
template locally render templates
test test a release
upgrade upgrade a release
verify verify that a chart at the given path has been signed and is valid
version print the client/server version information
Flags:
--debug enable verbose output
-h, --help help for helm
--home string location of your Helm config. Overrides $HELM_HOME (default "/Users/rimas/.helm")
--host string address of Tiller. Overrides $HELM_HOST
--kube-context string name of the kubeconfig context to use
--tiller-connection-timeout int the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
--tiller-namespace string namespace of Tiller (default "kube-system")
Use "helm [command] --help" for more information about a command. one
6 years ago
|
|
|
local release_url="https://github.com/helm/helm/releases/${DESIRED_VERSION:-latest}"
|
|
|
|
if type "curl" > /dev/null; then
|
|
|
|
TAG=$(curl -SsL $release_url | awk '/\/tag\//' | grep -v no-underline | cut -d '"' -f 2 | awk '{n=split($NF,a,"/");print a[n]}' | awk 'a !~ $0{print}; {a=$0}')
|
|
|
|
elif type "wget" > /dev/null; then
|
|
|
|
TAG=$(wget -q -O - $release_url | awk '/\/tag\//' | grep -v no-underline | cut -d '"' -f 2 | awk '{n=split($NF,a,"/");print a[n]}' | awk 'a !~ $0{print}; {a=$0}')
|
|
|
|
fi
|
|
|
|
if [ "x$TAG" == "x" ]; then
|
|
|
|
echo "Cannot determine ${DESIRED_VERSION} tag."
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
|
|
|
# checkHelmInstalledVersion checks which version of helm is installed and
|
|
|
|
# if it needs to be changed.
|
|
|
|
checkHelmInstalledVersion() {
|
|
|
|
if [[ -f "${HELM_INSTALL_DIR}/${PROJECT_NAME}" ]]; then
|
|
|
|
local version=$(helm version -c | grep '^Client' | cut -d'"' -f2)
|
|
|
|
if [[ "$version" == "$TAG" ]]; then
|
|
|
|
echo "Helm ${version} is already ${DESIRED_VERSION:-latest}"
|
|
|
|
return 0
|
|
|
|
else
|
|
|
|
echo "Helm ${TAG} is available. Changing from version ${version}."
|
|
|
|
return 1
|
|
|
|
fi
|
|
|
|
else
|
|
|
|
return 1
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
|
|
|
# downloadFile downloads the latest binary package and also the checksum
|
|
|
|
# for that binary.
|
|
|
|
downloadFile() {
|
|
|
|
HELM_DIST="helm-$TAG-$OS-$ARCH.tar.gz"
|
|
|
|
DOWNLOAD_URL="https://kubernetes-helm.storage.googleapis.com/$HELM_DIST"
|
|
|
|
CHECKSUM_URL="$DOWNLOAD_URL.sha256"
|
|
|
|
HELM_TMP_ROOT="$(mktemp -dt helm-installer-XXXXXX)"
|
|
|
|
HELM_TMP_FILE="$HELM_TMP_ROOT/$HELM_DIST"
|
|
|
|
HELM_SUM_FILE="$HELM_TMP_ROOT/$HELM_DIST.sha256"
|
|
|
|
echo "Downloading $DOWNLOAD_URL"
|
|
|
|
if type "curl" > /dev/null; then
|
|
|
|
curl -SsL "$CHECKSUM_URL" -o "$HELM_SUM_FILE"
|
|
|
|
elif type "wget" > /dev/null; then
|
|
|
|
wget -q -O "$HELM_SUM_FILE" "$CHECKSUM_URL"
|
|
|
|
fi
|
|
|
|
if type "curl" > /dev/null; then
|
|
|
|
curl -SsL "$DOWNLOAD_URL" -o "$HELM_TMP_FILE"
|
|
|
|
elif type "wget" > /dev/null; then
|
|
|
|
wget -q -O "$HELM_TMP_FILE" "$DOWNLOAD_URL"
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
|
|
|
# installFile verifies the SHA256 for the file, then unpacks and
|
|
|
|
# installs it.
|
|
|
|
installFile() {
|
|
|
|
HELM_TMP="$HELM_TMP_ROOT/$PROJECT_NAME"
|
|
|
|
local sum=$(openssl sha1 -sha256 ${HELM_TMP_FILE} | awk '{print $2}')
|
|
|
|
local expected_sum=$(cat ${HELM_SUM_FILE})
|
|
|
|
if [ "$sum" != "$expected_sum" ]; then
|
|
|
|
echo "SHA sum of ${HELM_TMP_FILE} does not match. Aborting."
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
|
|
|
|
mkdir -p "$HELM_TMP"
|
|
|
|
tar xf "$HELM_TMP_FILE" -C "$HELM_TMP"
|
|
|
|
HELM_TMP_BIN="$HELM_TMP/$OS-$ARCH/$PROJECT_NAME"
|
|
|
|
echo "Preparing to install into ${HELM_INSTALL_DIR}"
|
|
|
|
runAsRoot cp "$HELM_TMP_BIN" "$HELM_INSTALL_DIR"
|
|
|
|
}
|
|
|
|
|
|
|
|
# fail_trap is executed if an error occurs.
|
|
|
|
fail_trap() {
|
|
|
|
result=$?
|
|
|
|
if [ "$result" != "0" ]; then
|
|
|
|
if [[ -n "$INPUT_ARGUMENTS" ]]; then
|
|
|
|
echo "Failed to install $PROJECT_NAME with the arguments provided: $INPUT_ARGUMENTS"
|
|
|
|
help
|
|
|
|
else
|
|
|
|
echo "Failed to install $PROJECT_NAME"
|
|
|
|
fi
|
replace github org with The Kubernetes package manager
To begin working with Helm, run the 'helm init' command:
$ helm init
This will install Tiller to your running Kubernetes cluster.
It will also set up any necessary local configuration.
Common actions from this point include:
- helm search: search for charts
- helm fetch: download a chart to your local directory to view
- helm install: upload the chart to Kubernetes
- helm list: list releases of charts
Environment:
$HELM_HOME set an alternative location for Helm files. By default, these are stored in ~/.helm
$HELM_HOST set an alternative Tiller host. The format is host:port
$HELM_NO_PLUGINS disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins.
$TILLER_NAMESPACE set an alternative Tiller namespace (default "kube-system")
$KUBECONFIG set an alternative Kubernetes configuration file (default "~/.kube/config")
Usage:
helm [command]
Available Commands:
completion Generate autocompletions script for the specified shell (bash or zsh)
create create a new chart with the given name
delete given a release name, delete the release from Kubernetes
dependency manage a chart's dependencies
fetch download a chart from a repository and (optionally) unpack it in local directory
get download a named release
history fetch release history
home displays the location of HELM_HOME
init initialize Helm on both client and server
inspect inspect a chart
install install a chart archive
lint examines a chart for possible issues
list list releases
package package a chart directory into a chart archive
plugin add, list, or remove Helm plugins
repo add, list, remove, update, and index chart repositories
reset uninstalls Tiller from a cluster
rollback roll back a release to a previous revision
search search for a keyword in charts
serve start a local http web server
status displays the status of the named release
template locally render templates
test test a release
upgrade upgrade a release
verify verify that a chart at the given path has been signed and is valid
version print the client/server version information
Flags:
--debug enable verbose output
-h, --help help for helm
--home string location of your Helm config. Overrides $HELM_HOME (default "/Users/rimas/.helm")
--host string address of Tiller. Overrides $HELM_HOST
--kube-context string name of the kubeconfig context to use
--tiller-connection-timeout int the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
--tiller-namespace string namespace of Tiller (default "kube-system")
Use "helm [command] --help" for more information about a command. one
6 years ago
|
|
|
echo -e "\tFor support, go to https://github.com/helm/helm."
|
|
|
|
fi
|
|
|
|
cleanup
|
|
|
|
exit $result
|
|
|
|
}
|
|
|
|
|
|
|
|
# testVersion tests the installed client to make sure it is working.
|
|
|
|
testVersion() {
|
|
|
|
set +e
|
|
|
|
echo "$PROJECT_NAME installed into $HELM_INSTALL_DIR/$PROJECT_NAME"
|
|
|
|
HELM="$(which $PROJECT_NAME)"
|
|
|
|
if [ "$?" = "1" ]; then
|
|
|
|
echo "$PROJECT_NAME not found. Is $HELM_INSTALL_DIR on your "'$PATH?'
|
|
|
|
exit 1
|
|
|
|
fi
|
|
|
|
set -e
|
|
|
|
echo "Run '$PROJECT_NAME init' to configure $PROJECT_NAME."
|
|
|
|
}
|
|
|
|
|
|
|
|
# help provides possible cli installation arguments
|
|
|
|
help () {
|
|
|
|
echo "Accepted cli arguments are:"
|
|
|
|
echo -e "\t[--help|-h ] ->> prints this help"
|
|
|
|
echo -e "\t[--version|-v <desired_version>] . When not defined it defaults to latest"
|
|
|
|
echo -e "\te.g. --version v2.4.0 or -v latest"
|
|
|
|
}
|
|
|
|
|
replace github org with The Kubernetes package manager
To begin working with Helm, run the 'helm init' command:
$ helm init
This will install Tiller to your running Kubernetes cluster.
It will also set up any necessary local configuration.
Common actions from this point include:
- helm search: search for charts
- helm fetch: download a chart to your local directory to view
- helm install: upload the chart to Kubernetes
- helm list: list releases of charts
Environment:
$HELM_HOME set an alternative location for Helm files. By default, these are stored in ~/.helm
$HELM_HOST set an alternative Tiller host. The format is host:port
$HELM_NO_PLUGINS disable plugins. Set HELM_NO_PLUGINS=1 to disable plugins.
$TILLER_NAMESPACE set an alternative Tiller namespace (default "kube-system")
$KUBECONFIG set an alternative Kubernetes configuration file (default "~/.kube/config")
Usage:
helm [command]
Available Commands:
completion Generate autocompletions script for the specified shell (bash or zsh)
create create a new chart with the given name
delete given a release name, delete the release from Kubernetes
dependency manage a chart's dependencies
fetch download a chart from a repository and (optionally) unpack it in local directory
get download a named release
history fetch release history
home displays the location of HELM_HOME
init initialize Helm on both client and server
inspect inspect a chart
install install a chart archive
lint examines a chart for possible issues
list list releases
package package a chart directory into a chart archive
plugin add, list, or remove Helm plugins
repo add, list, remove, update, and index chart repositories
reset uninstalls Tiller from a cluster
rollback roll back a release to a previous revision
search search for a keyword in charts
serve start a local http web server
status displays the status of the named release
template locally render templates
test test a release
upgrade upgrade a release
verify verify that a chart at the given path has been signed and is valid
version print the client/server version information
Flags:
--debug enable verbose output
-h, --help help for helm
--home string location of your Helm config. Overrides $HELM_HOME (default "/Users/rimas/.helm")
--host string address of Tiller. Overrides $HELM_HOST
--kube-context string name of the kubeconfig context to use
--tiller-connection-timeout int the duration (in seconds) Helm will wait to establish a connection to tiller (default 300)
--tiller-namespace string namespace of Tiller (default "kube-system")
Use "helm [command] --help" for more information about a command. one
6 years ago
|
|
|
# cleanup temporary files to avoid https://github.com/helm/helm/issues/2977
|
|
|
|
cleanup() {
|
|
|
|
if [[ -d "${HELM_TMP_ROOT:-}" ]]; then
|
|
|
|
rm -rf "$HELM_TMP_ROOT"
|
|
|
|
fi
|
|
|
|
}
|
|
|
|
|
|
|
|
# Execution
|
|
|
|
|
|
|
|
#Stop execution on any error
|
|
|
|
trap "fail_trap" EXIT
|
|
|
|
set -e
|
|
|
|
|
|
|
|
# Parsing input arguments (if any)
|
|
|
|
export INPUT_ARGUMENTS="${@}"
|
|
|
|
set -u
|
|
|
|
while [[ $# -gt 0 ]]; do
|
|
|
|
case $1 in
|
|
|
|
'--version'|-v)
|
|
|
|
shift
|
|
|
|
if [[ $# -ne 0 ]]; then
|
|
|
|
export DESIRED_VERSION="${1}"
|
|
|
|
else
|
|
|
|
echo -e "Please provide the desired version. e.g. --version v2.4.0 or -v latest"
|
|
|
|
exit 0
|
|
|
|
fi
|
|
|
|
;;
|
|
|
|
'--help'|-h)
|
|
|
|
help
|
|
|
|
exit 0
|
|
|
|
;;
|
|
|
|
*) exit 1
|
|
|
|
;;
|
|
|
|
esac
|
|
|
|
shift
|
|
|
|
done
|
|
|
|
set +u
|
|
|
|
|
|
|
|
initArch
|
|
|
|
initOS
|
|
|
|
verifySupported
|
|
|
|
checkDesiredVersion
|
|
|
|
if ! checkHelmInstalledVersion; then
|
|
|
|
downloadFile
|
|
|
|
installFile
|
|
|
|
fi
|
|
|
|
testVersion
|
|
|
|
cleanup
|