Micronaut Quickstart - Deployment for The Hello-World App by Gradle Tasks
Here's how to deploy the Hello-World app by Gradle Tasks to a variety of plugins.
Join the DZone community and get the full member experience.
Join For FreeTo facilitate deployment across platforms, you can use Gradle tasks and plugins. Gradle supports different plugins to deploy to Kubernetes, OpenShift, GCP, and deploy as AWS Lambda.
In this tutorial, we will consider the Micronaut Framework by using Kotlin language.
Micronaut positioned as a modern, JVM-based, full-stack framework for building modular, easily testable microservice and serverless applications. Let's create a simple "hello-world" app with multiple platform deployment(OpenShift/Kubernetes/Amazon/Google Cloud Platform) by using simple Gradle tasks.
Source: micronaut project
Application
Create your first Kotlin application:
mn create-app com.micronaut.complete --lang=kotlin
With a simple controller:
xxxxxxxxxx
@Controller
class GreetingController {
@Get(uris = ["/hello", "/greeting"])
fun greeting(): String {
return "Hello from Micronaut!"
}
}
Docker Support
Setup jib for Docker support in project build.gradle:
xxxxxxxxxx
plugins {
id 'com.google.cloud.tools.jib' version '2.3.0'
}
jib {
to {
image = 'elvaliev/micronaut-quickstart'
auth {
username = DOCKERHUB_USERNAME
password = DOCKERHUB_PASSWORD
}
}
}
Run in command line: .gradlew jib
Google Cloud Platform (GCP)
Prerequisites: Google Cloud Platform account.
Create a project
Create a project directly in your GCP or by using a command-line tool:
xxxxxxxxxx
gcloud projects create PROJECT_ID --set-as-default
gcloud app create --project=PROJECT_ID
Plugin setup
For deploying to GCP used appengine-gradle-plugin.
Setup plugin configuration in project build.gradle:
xxxxxxxxxx
buildscript {
repositories {
jcenter()
mavenLocal()
}
dependencies {
classpath 'com.google.cloud.tools:appengine-gradle-plugin:2.2.0'
}
}
apply plugin: "com.google.cloud.tools.appengine-appyaml"
appengine {
stage.artifact =
"${buildDir}/libs/${project.name}-${project.version}.jar"
deploy {
stopPreviousVersion = true
promote = true
projectId = GCLOUD_CONFIG
version = GCLOUD_CONFIG
}
}
Parameter GCLOUD_CONFIG (it's PROJECT_ID from the previous step) you could set in build.gradle directly or in gradle.properties.
Appengine Setup
In your project create file: src/main/appengine/app.yaml:
xxxxxxxxxx
runtimejava11
instance_classF4
entrypoint'java -agentpath:/opt/cdbg/cdbg_java_agent.so=--log_dir=/var/log
-jar <JAR_FILE_NAME>.jar'
Deploy task
Execute the Gradle commands:
xxxxxxxxxx
./gradlew appengineDeploy
Browse your application:
xxxxxxxxxx
gcloud app browse
Kubernetes/OpenShift
Prerequisites: OC/Kubernetes Client - already logged in.
For deploying to Kubernetes/OpenShift used my plugin k8s_aws_plugin, which used templates or file configuration list (supported .json and .yaml formats) and image-streams for deployment.
Template Setup
Define in your project file for OpenShift and/or Kubernetes deployment as a "configuration list":
xxxxxxxxxx
...
---
apiVersion"v1"
kind"Service"
metadata
...
name"micronaut-quickstart"
spec
ports
name"http"
port8090
targetPort8090
...
Or "template":
xxxxxxxxxx
apiVersionv1
kindTemplate
metadata
namemy-template
objects
kindDeploymentConfig
apiVersionv1
metadata
labels
...
Plugin Setup
Setup plugin configuration in the project build.gradle:
xxxxxxxxxx
plugins {
...
id "com.elvaliev.k8s_aws_plugin" version "1.0.4"
}
apply plugin: "com.elvaliev.k8s_aws_plugin"
kubernetes {
template = 'k8s/kubernetes.yml'
image = 'elvaliev/micronaut-quickstart'
}
openshift {
template = 'k8s/openshift.yml'
image = 'elvaliev/micronaut-quickstart'
}
Note: If you named template as "openshift" and "kubernetes" in project root - don't need to specify templates. The plugin will recognize it.
Note: Plugin support command options, it's not necessary to specify extensions "openshift" and "kubernetes"
Deploy tasks
For deploying to Openshift by using extensions: ./gradlew openshiftDeploy or by using command-line options:
xxxxxxxxxx
./gradlew openshiftDeploy --template="k8s/openshift.yml" --image="elvaliev/micronaut-quickstart"
For deploying to Kubernetes by using extensions: ./gradlew kubernetesDeploy or by using command-line options:
xxxxxxxxxx
./gradlew kubernetesDeploy --template="k8s/kubernetes.yml" --image="elvaliev/micronaut-quickstart"
AWS Lambda
Prerequisites: AWS Client - already logged in.
Dependency
Setup aws dependency in the project build.gradle:
xxxxxxxxxx
dependencies {
implementation "io.micronaut:micronaut-function-aws"
}
Serverless Function
For deploying as AWS Lambda setup serverless-function:
xxxxxxxxxx
@FunctionBean("hello-micronaut")
class HelloKotlinFunction : Supplier<String> {
override fun get(): String {
return "Hello from Serverless Micronaut Functions!"
}
}
Plugin Setup
For deploying serverless functions used gradle aws plugin. Define AWS_ROLE and AWS_REGION in gradle.properties.
Setup plugin configuration in the project build.gradle:
xxxxxxxxxx
import com.amazonaws.services.lambda.model.InvocationType
import com.amazonaws.services.lambda.model.Runtime
import jp.classmethod.aws.gradle.lambda.*
plugins {
...
id "jp.classmethod.aws.lambda" version "0.41"
}
apply plugin: 'jp.classmethod.aws.lambda'
aws {
profileName = "default"
region = AWS_REGION
}
lambda {
region = AWS_REGION
}
task zip(type: Zip) {
from "function/"
destinationDir file("build")
}
mainClassName = "io.micronaut.function.executor.FunctionApplication"
task deploy(type: AWSLambdaMigrateFunctionTask, dependsOn: shadowJar) {
functionName = "hello-micronaut"
handler = "io.micronaut.function.aws.MicronautRequestStreamHandler"
role = AWS_ROLE
runtime = Runtime.Java8
zipFile = shadowJar.archivePath
memorySize = 256
timeout = 60
}
task invoke(type: AWSLambdaInvokeTask) {
functionName = "hello-micronaut"
invocationType = InvocationType.RequestResponse
payload = ''
doLast {
println "Lambda function result: " + new String(invokeResult.payload.array())
}
}
Deploy Tasks
Deploy to AWS Lambda: ./gradlew deploy and invoke Lambda: ./gradlew invoke.
Github: https://github.com/ElinaValieva/micronaut-quarkus-quickstarts
Published at DZone with permission of Elina Valieva. See the original article here.
Opinions expressed by DZone contributors are their own.
Trending
-
Strategies for Reducing Total Cost of Ownership (TCO) For Integration Solutions
-
Manifold vs. Lombok: Enhancing Java With Property Support
-
How To Use Pandas and Matplotlib To Perform EDA In Python
-
Alpha Testing Tutorial: A Comprehensive Guide With Best Practices
Comments