Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs update: macos quarantine and JDK version #3878

Merged
merged 1 commit into from
Feb 9, 2022
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
6 changes: 3 additions & 3 deletions docs/about/02_introduction.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
///////////////////////////////////////////////////////////////////////////////

Copyright (c) 2018, 2020 Oracle and/or its affiliates.
Copyright (c) 2018, 2022 Oracle and/or its affiliates.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -91,8 +91,8 @@ Based upon the Tyrus implementation, Helidon receives WebSocket API support.
<<se/websocket/01_overview.adoc, Learn more about Websocket Support>>.


* *Support for Java 11 APIs* +
Helidon will require Java 11 or newer.
* *Support for Java 17 APIs* +
Helidon will require Java 17 or newer.
<<about/03_prerequisites.adoc, Learn more about the prerequisites for Helidon 2.0>>.


Expand Down
10 changes: 5 additions & 5 deletions docs/about/03_prerequisites.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
///////////////////////////////////////////////////////////////////////////////

Copyright (c) 2018, 2021 Oracle and/or its affiliates.
Copyright (c) 2018, 2022 Oracle and/or its affiliates.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand All @@ -24,14 +24,14 @@ Everything you need to get started with Helidon is listed here.

== Prerequisites

Helidon requires Java 11 (or newer) and Maven. You need Docker if you
Helidon 3 requires Java 17 (or newer) and Maven. You need Docker if you
want to build and deploy Docker containers. If you want to
deploy to Kubernetes, you need `kubectl` and a Kubernetes cluster (you can
<<about/05_kubernetes.adoc,install one on your desktop>>).

[role="flex, sm7"]
|=======
|https://www.oracle.com/technetwork/java/javase/downloads[Java{nbsp}SE{nbsp}11] (http://jdk.java.net[Open{nbsp}JDK{nbsp}11]) or newer
|https://www.oracle.com/technetwork/java/javase/downloads[Java{nbsp}SE{nbsp}17] (http://jdk.java.net[Open{nbsp}JDK{nbsp}17]) or newer
|https://maven.apache.org/download.cgi[Maven 3.6.1+]
|https://docs.docker.com/install/[Docker 18.09+]
|https://kubernetes.io/docs/tasks/tools/install-kubectl/[Kubectl 1.16.5+]
Expand All @@ -53,11 +53,11 @@ kubectl version --short
.Setting JAVA_HOME
----
# On Mac
export JAVA_HOME=`/usr/libexec/java_home -v 11`
export JAVA_HOME=`/usr/libexec/java_home -v 17`

# On Linux
# Use the appropriate path to your JDK
export JAVA_HOME=/usr/lib/jvm/jdk-11
export JAVA_HOME=/usr/lib/jvm/jdk-17
----

== Try the Quickstart Examples
Expand Down
14 changes: 9 additions & 5 deletions docs/about/05_cli.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
///////////////////////////////////////////////////////////////////////////////

Copyright (c) 2020, 2021 Oracle and/or its affiliates.
Copyright (c) 2020, 2022 Oracle and/or its affiliates.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down Expand Up @@ -34,11 +34,11 @@ and you’re ready to go.

== Prerequisites

Helidon requires Java 11 (or newer) and Maven.
Helidon 3 requires Java 17 (or newer) and Maven.

[role="flex, sm7"]
|=======
|https://www.oracle.com/technetwork/java/javase/downloads[Java{nbsp}SE{nbsp}11] (http://jdk.java.net[Open{nbsp}JDK{nbsp}11]) or newer
|https://www.oracle.com/technetwork/java/javase/downloads[Java{nbsp}SE{nbsp}17] (http://jdk.java.net[Open{nbsp}JDK{nbsp}17]) or newer
|https://maven.apache.org/download.cgi[Maven 3.6.1+]
|=======

Expand All @@ -55,15 +55,19 @@ mvn --version
[source,bash]
.MacOS
----
curl -O https://helidon.io/cli/latest/darwin/helidon
curl -L -O https://helidon.io/cli/latest/darwin/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/
----

If you get a warning that "the developer cannot be verified" when running the CLI
this is due to the Helidon CLI not being signed and notarized yet. You can disable
this check by running: `xattr -d com.apple.quarantine helidon`

[source,bash]
.Linux
----
curl -O https://helidon.io/cli/latest/linux/helidon
curl -L -O https://helidon.io/cli/latest/linux/helidon
chmod +x ./helidon
sudo mv ./helidon /usr/local/bin/
----
Expand Down
2 changes: 1 addition & 1 deletion docs/about/05_kubernetes.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
///////////////////////////////////////////////////////////////////////////////

Copyright (c) 2018, 2020 Oracle and/or its affiliates.
Copyright (c) 2018, 2022 Oracle and/or its affiliates.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
21 changes: 3 additions & 18 deletions docs/common/guides/migration.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
///////////////////////////////////////////////////////////////////////////////

Copyright (c) 2020 Oracle and/or its affiliates.
Copyright (c) 2020, 2022 Oracle and/or its affiliates.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand All @@ -17,24 +17,9 @@
///////////////////////////////////////////////////////////////////////////////


== Java 8 Runtime
== Java 11 Runtime

Java 8 is no longer supported. Java 11 or newer is required.

== Common Utilities

Since Helidon 2.x now requires Java 11 the helper classes that were provided for Java 8
support have been removed. These have been replaced by the standard JDK classes:

|===
|Removed | Replacement

|`io.helidon.reactive.Flow`|`java.util.concurrent.Flow`
|`io.helidon.common.CollectionsHelper`|Factory methods of `Set`, `Map` and `List`
|`io.helidon.common.OptionalHelper`|Methods of `java.util.Optional`
|`io.helidon.common.StackWalker`|`java.lang.StackWalker`
|`io.helidon.common.InputStreamHelper`|Methods of `java.io.InputStream`
|===
Java 11 is no longer supported in Helidon 3. Java 17 or newer is required.

== Tracing

Expand Down