From 881fbbbca692ebe25314b0b6abae86e4a609835b Mon Sep 17 00:00:00 2001 From: Max Rydahl Andersen Date: Mon, 24 Jan 2022 11:23:21 +0100 Subject: [PATCH] fix cli install Details in https://github.com/quarkusio/quarkusio.github.io/pull/1307 on why the "trust" call is added. I moved jbang up as it is the only one that works on every OS and without java first installed. Thus absolute fastest/simplest to use on all major OS's. And moved homebrew down as that is only available for mac/osx. --- docs/src/main/asciidoc/cli-tooling.adoc | 77 +++++++++++++------------ 1 file changed, 41 insertions(+), 36 deletions(-) diff --git a/docs/src/main/asciidoc/cli-tooling.adoc b/docs/src/main/asciidoc/cli-tooling.adoc index b2b0f6e30305e..9d51d1fc75aa0 100644 --- a/docs/src/main/asciidoc/cli-tooling.adoc +++ b/docs/src/main/asciidoc/cli-tooling.adoc @@ -17,59 +17,31 @@ include::./status-include.adoc[] You can install the Quarkus CLI via: -* <> -* <> -* <> +* <> for Linux, OSX and Windows (no java required) +* <> for Linux and OSX (java required) +* <> for OSX (java required) More alternatives such as https://chocolatey.org[Chocolatey] will be made available soon. -[[homebrew]] -=== Installing with Homebrew - -https://brew.sh[Homebrew] is a package manager for macOS (and Linux). - -You can use Homebrew to install (and update) the Quarkus CLI. - -[NOTE] -==== -Make sure you have a JDK installed before installing the Quarkus CLI. -We haven't added an explicit dependency as we wanted to make sure you could use your preferred JDK version. - -You can install a JDK with `brew install openjdk` for Java 17 or `brew install openjdk@11` for Java 11. -==== - -To install the Quarkus CLI using Homebrew, run the following command: - -[source,shell] ----- -brew install quarkusio/tap/quarkus ----- - -It will install the latest version of the Quarkus CLI. -This command can also be used to update the Quarkus CLI. - -Once installed `quarkus` will be in your `$PATH` and if you run `quarkus --version` it will print the installed version: - -[source,shell,subs=attributes+] ----- -quarkus --version -{quarkus-version} ----- [[jbang]] === Installing with JBang -The Quarkus CLI is currently available as a jar installable using https://jbang.dev[JBang]. +The Quarkus CLI is available as a jar installable using https://jbang.dev[JBang]. + +JBang will use your existing Java or install one for you if needed. On Linux, macOS, and Windows (using WSL or bash compatible shell like Cygwin or MinGW) [source,bash] ---- +curl -Ls https://sh.jbang.dev | bash -s - trust add https://repo1.maven.org/maven2/io/quarkus/quarkus-cli/ curl -Ls https://sh.jbang.dev | bash -s - app install --fresh --force quarkus@quarkusio ---- On Windows using Powershell: [source,powershell] ---- +iex "& { $(iwr https://ps.jbang.dev) } trust add https://repo1.maven.org/maven2/io/quarkus/quarkus-cli/" iex "& { $(iwr https://ps.jbang.dev) } app install --fresh --force quarkus@quarkusio" ---- @@ -135,6 +107,39 @@ sdk install quarkus It will install the latest version of the Quarkus CLI. SDKMAN! will let you know when new versions are available so updates will be straightforward. +[[homebrew]] +=== Installing with Homebrew + +https://brew.sh[Homebrew] is a package manager for macOS (and Linux). + +You can use Homebrew to install (and update) the Quarkus CLI. + +[NOTE] +==== +Make sure you have a JDK installed before installing the Quarkus CLI. +We haven't added an explicit dependency as we wanted to make sure you could use your preferred JDK version. + +You can install a JDK with `brew install openjdk` for Java 17 or `brew install openjdk@11` for Java 11. +==== + +To install the Quarkus CLI using Homebrew, run the following command: + +[source,shell] +---- +brew install quarkusio/tap/quarkus +---- + +It will install the latest version of the Quarkus CLI. +This command can also be used to update the Quarkus CLI. + +Once installed `quarkus` will be in your `$PATH` and if you run `quarkus --version` it will print the installed version: + +[source,shell,subs=attributes+] +---- +quarkus --version +{quarkus-version} +---- + Once installed `quarkus` will be in your `$PATH` and if you run `quarkus --version` it will print the installed version: [source,shell,subs=attributes+]