Skip to content
This repository has been archived by the owner on Nov 22, 2024. It is now read-only.

New CLI installation instructions #981

Merged
merged 1 commit into from
Feb 12, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -19,29 +19,21 @@ First, make sure that you have the following installed:

== Download and install the Cloudflow CLI

Using one of the links below, download the Cloudflow CLI appropriate for your development platform.
Install it on your local system by unzipping the archive and moving the executable into your `PATH`.
Install the Cloudflow CLI using the official installer:

* https://bintray.com/lightbend/cloudflow-cli/download_file?file_path=kubectl-cloudflow-{kubectl-plugin-version}-linux-amd64.tar.gz[Linux]

* https://bintray.com/lightbend/cloudflow-cli/download_file?file_path=kubectl-cloudflow-{kubectl-plugin-version}-darwin-amd64.tar.gz[MacOS]

* https://bintray.com/lightbend/cloudflow-cli/download_file?file_path=kubectl-cloudflow-{kubectl-plugin-version}-windows-amd64.tar.gz[Windows]

Please make sure you have the executable in your path with proper permission settings.
For Linux or MacOS, put the executables in `/usr/local/bin` with permission settings of `755`.
....
curl -sL http://cloudflow.io/docs/get.sh | sh
....

[NOTE]
====
On MacOS Catalina and later, the default behavior is to not allow unsigned executables downloaded from the internet.
It is planned to sign the executable with an Apple developer certificate to fix this but, in the mean time, there is a very simple workaround.
After downloading and unpacking the executable, please execute the following command to remove the "downloaded from the internet" filesystem flag that blocks the file from being executed:
You can pass options to the installer script with `-s --` e.g.:

....
xattr -d com.apple.quarantine [path to]/kubectl-cloudflow
curl -sL http://cloudflow.io/docs/get.sh | sh -s -- --prefix=$HOME --version=2.0.22 --verbose
curl -sL http://cloudflow.io/docs/get.sh | sh -s -- -P $HOME -v 2.0.22 -V
....
+
More details can be found in the https://github.com/lightbend/cloudflow/issues/47[associated issue].
====

If the installer script fails (e.g. there is no `curl` nor `wget` installed) downaload the binaries at the specific version from:

* https://bintray.com/lightbend/cloudflow-cli/kubectl-cloudflow

ifdef::review[Reviewers:still need recommendations for Windows.]
1 change: 0 additions & 1 deletion tools/get.sh
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@
# `get.sh` is a simple one-liner shell script to
# Install the official Cloudflow kubectl plugin
#
# TODO review instructions when is live
# $ curl -sL http://cloudflow.io/docs/get.sh | sh
#
# Options may be passed to the shell script with `-s --`:
Expand Down