Skip to content

Commit fece46d

Browse files
committed
Add WSL recommendation
1 parent f4a0540 commit fece46d

3 files changed

Lines changed: 15 additions & 10 deletions

File tree

documentation/modules/ROOT/pages/_partials/compile-and-run.adoc

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -43,6 +43,11 @@ java -jar target/quarkus-app/quarkus-run.jar
4343
Native mode::
4444
+
4545
--
46+
47+
Quarkus simplifies the https://quarkus.io/guides/building-native-image[compilation of Java applications down to a native binary] using GraalVM/Mandrel. To do so, add a "native" flag to your build command.
48+
49+
NOTE: To force building a native binary in a GraalVM Mandrel container, add `-Dquarkus.native.container-build=true`.
50+
4651
[%header,cols="1,1"]
4752
|=====
4853
@@ -109,8 +114,8 @@ quarkus image build --native
109114
110115
NOTE: Native compilation will take few minutes to complete.
111116
112-
The above command built a native binary of the Java code and also built it into a container image.
113-
To run the application (in native mode) you will need to start up a container:
117+
The above command will build a native binary of the Java code and then copy it into a container image.
118+
Start the container that runs the native binary:
114119
115120
[#basics-build-run-native-docker-app]
116121
[.console-input]
@@ -131,8 +136,7 @@ __ ____ __ _____ ___ __ ____ ______
131136
--/ __ \/ / / / _ | / _ \/ //_/ / / / __/
132137
-/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
133138
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
134-
INFO [io.quarkus] (Quarkus Main Thread) tutorial-app 1.0-SNAPSHOT on JVM (powered by Quarkus 3.1.2.Final) started in 0.394s. Listening on: http://localhost:8080
135-
136-
INFO [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
137-
INFO [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, resteasy-reactive, smallrye-context-propagation, vertx]
139+
2023-07-07 11:47:14,046 INFO [io.quarkus] (main) code-with-quarkus 1.0.0-SNAPSHOT native (powered by Quarkus 3.2.0.Final) started in 0.019s. Listening on: http://0.0.0.0:8080
140+
2023-07-07 11:47:14,047 INFO [io.quarkus] (main) Profile prod activated.
141+
2023-07-07 11:47:14,047 INFO [io.quarkus] (main) Installed features: [cdi, resteasy-reactive, smallrye-context-propagation, vertx]
138142
----

documentation/modules/ROOT/pages/basics.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ IMPORTANT: All the remaining parts of this tutorial assume that you'll be workin
4646

4747
include::ROOT:partial$compile-and-run.adoc[]
4848

49-
Notice how *fast* Quarkus was ready to serve your requests. In this particular example Quarkus only required *0.394s* to start.
49+
Notice how *fast* Quarkus was ready to serve your requests. In this particular example Quarkus only required *0.019s* to start.
5050

5151
You can open your browser with the url `http://localhost:8080/hello[window="_blank"]` and you should see a response like `hello`.
5252

documentation/modules/ROOT/pages/setup.adoc

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,9 @@ endif::workshop[]
2727
GraalVM is only required if you intend to build a native image for your local operating system. If you want to create a container using a native image, you can use the Quarkus feature for this and don't need to install GraalVM locally.
2828
====
2929

30-
NOTE: * You can also use Docker instead of Podman. The advantage of Podman is that it is 100% Free Open Source and does not need to run with elevated privileges. Just use 'podman' instead of 'docker' throughout the tutorial's instructions, or easier yet, alias docker=podman to automatically use podman under the hood for docker commands.
30+
NOTE: * You can also use Docker instead of Podman. The advantage of Podman is that it is 100% Free Open Source and does not need to run with elevated privileges.
31+
32+
IMPORTANT: We highly recommend Windows users to use https://learn.microsoft.com/en-us/windows/wsl/install[WSL].
3133

3234
[tabs]
3335
====
@@ -81,8 +83,7 @@ You can also install Java and Maven using https://sdkman.io[SDKMAN!]. This allow
8183
Container Image::
8284
+
8385
--
84-
If you have https://podman-desktop.io/downloads[Podman Desktop for Linux, window="_blank"] then you can pull the Linux container image
85-
https://quay.io/repository/rhdevelopers/tutorial-tools?tab=tags[tutorial tools] which has all the tools listed below installed and pre-configured.
86+
You can run the tutorial from inside a container which has all the tools listed below installed and pre-configured.
8687
[#docker-pull-tutorials-cli]
8788
[source,bash]
8889
-----

0 commit comments

Comments
 (0)