It is easy to develop a Google Cloud Function using Java with Gradle as the build tool. It is however not so simple to test it locally.
The current recommended approach to testing especially with gradle is very complicated. It requires pulling in Invoker libraries and adding a custom task to run the invoker function.
I have now authored a gradle plugin which makes local testing way more easier!
Problem
The way the Invoker is added in for a Cloud Function Gradle project looks like this today:
configurations {
invoker
}
dependencies {
...
invoker("com.google.cloud.functions.invoker:java-function-invoker:1.1.0")
...
}
tasks.register("runFunction", JavaExec) {
main = 'com.google.cloud.functions.invoker.runner.Invoker'
classpath(configurations.invoker)
inputs.files(configurations.runtimeClasspath, sourceSets.main.output)
args(
'--target', project.findProperty('run.functionTarget') ?: 'functions.HelloHttp',
'--port', project.findProperty('run.port') ?: 8080
)
doFirst {
args('--classpath', files(configurations.runtimeClasspath, sourceSets.main.output).asPath)
}
}
This has a lot of opaque details, for eg, what does the configurations of invoker even mean, what is the magical task that is being registered?
Fix
Now contrast it with the approach with the plugin:
plugins{
id 'java'
id "io.github.bijukunjummen.cloudfunction"
}
dependencies {
...
}
cloudFunction {
target = "functions.HelloHttp"
port = 8080
}
All the boiler plate is now gone, configuration around the function class, which port to start it up on much more simplified. Adding this new plugin contributes a task that can be invoked the following way:
./gradlew cloudFunctionRun
It would start up an endpoint using which the function can be tested locally.
Conclusion
It may be far easier to see fully working samples incorporating this plugin. These samples are available here
Published on Java Code Geeks with permission by Biju Kunjummen, partner at our JCG program. See the original article here: Google Cloud Function Gradle Plugin Opinions expressed by Java Code Geeks contributors are their own. |
