Skip to content

Updated Java package tutorial instructions #110

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.

Sign up for GitHub

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

Merged
brendandburns merged 1 commit into from
Mar 7, 2018
Merged

Updated Java package tutorial instructions #110

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
36 changes: 20 additions & 16 deletions tutorials/java/tutorial.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,8 +118,8 @@ import com.sun.net.httpserver.HttpServer;
public class Main {
private static final int port = 8080;

@Package(repository="docker.io/your-docker-user-goes-here",
jarFile="target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar")
@Package(repository = "your-docker-user-goes-here",
jarFile = "target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar")
public static void main(String[] args) {
Containerize(() -> {
try {
Expand All @@ -146,7 +146,7 @@ public class Main {

You will notice that we added a `@Package` annotation that describes how
to package the application. You will need to replace `your-docker-user-goes-here`
with an actual Docker repository path.
with an actual Docker Hub user name.

You will also notice that we wrapped the main function in the `Containerize`
function which kicks off the Metaparticle code.
Expand Down Expand Up @@ -203,8 +203,8 @@ public class Main {
private static final int port = 8080;

@Runtime(ports={port})
@Package(repository="docker.io/your-docker-user-goes-here",
jarFile="target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar")
@Package(repository = "your-docker-user-goes-here",
jarFile = "target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar")
public static void main(String[] args) {
Containerize(() -> {
try {
Expand Down Expand Up @@ -233,19 +233,22 @@ Now if you run this with `mvn compile exec:java -Dexec.mainClass=io.metaparticle

## Replicating and exposing on the web.
As a final step, consider the task of exposing a replicated service on the internet.
To do this, we're going to expand our usage of the `@Runtime` tag. First we will
add a `replicas` field, which will specify the number of replicas. Second we will
set our execution environment to `metaparticle` which will launch the service
into the currently configured Kubernetes environment.
To do this, we're going to expand our usage of the `@Runtime` and `@Package` annotations.
First, `@Package` has its `publish` field added with a value of `true`. This is necessary in order to push the built image to the Docker repository.
Next, we add a `executor` field to the `@Runtime` annotation to set our execution environment to `metaparticle` which will launch the service
into the currently configured Kubernetes environment. Finally, we add a `replicas` field to the `@Runtime` annotation. This specifies the number of replicas to schedule.

Here's what the snippet looks like:

```java
...
@Runtime(ports={port},
replicas = 4,
publicAddress = true,
executor="metaparticle")
executor = "metaparticle")
@Package(repository = "your-docker-user-goes-here",
jarFile = "target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar",
publish = true,
verbose = true)
...
```

Expand All @@ -270,10 +273,11 @@ public class Main {

@Runtime(ports={port},
replicas=4,
publicAddress=true,
executor="metaparticle")
@Package(repository="docker.io/your-docker-user-goes-here",
jarFile="target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar")
@Package(repository = "your-docker-user-goes-here",
jarFile = "target/metaparticle-package-tutorial-0.1-SNAPSHOT-jar-with-dependencies.jar",
publish = true,
verbose = true)
public static void main(String[] args) {
Containerize(() -> {
try {
Expand All @@ -298,8 +302,8 @@ public class Main {
}
```

After you compile and run this, you can see that there are four replicas running behind a
Kubernetes Service Load balancer:
After you compile and run this, you can see that there are four pod replicas running behind a
Kubernetes ClusterIP service:

```sh
$ kubectl get pods
Expand Down