By Version

Google Cloud Functions (Serverless) con RESTEasy Reactive, Undertow o Reactive Routes

Requisitos previos
Solución
Creación del proyecto de Maven
Iniciar sesión en Google Cloud
Creación de los endpoints
Construir y desplegar en Google Cloud
Pruebas locales
¿Qué es lo siguiente?

La extensión quarkus-google-cloud-functions-http permite escribir microservicios con RESTEasy Reactive (JAX-RS), Undertow (Servlet), Reactive Routes o Funqy HTTP, y hacer que estos microservicios se puedan desplegar en el tiempo de ejecución de Google Cloud Functions.

Una implementación de Google Cloud Functions puede representar cualquier número de endpoints JAX-RS, Servlet, Rutas Reactivas o Funqy HTTP.

This technology is considered preview.

En la preview, la compatibilidad con versiones anteriores y la presencia en el ecosistema no están garantizadas. Las mejoras específicas podrían requerir cambios en la configuración o en las API, y los planes para convertirse en estables están en marcha. Los comentarios son bienvenidos en nuestra lista de correo o como problemas en nuestro GitHub issue tracker.

For a full list of possible statuses, check our FAQ entry.

Requisitos previos

To complete this guide, you need:

Roughly 15 minutes
An IDE
JDK 11+ installed with JAVA_HOME configured appropriately
Apache Maven 3.8.6
Optionally the Quarkus CLI if you want to use it
Una cuenta de Google Cloud. Las cuentas gratuitas funcionan.
Cloud SDK CLI instalado

Solución

Esta guía le guiará a través de la generación de un proyecto de ejemplo, seguido de la creación de tres endpoints HTTP escritos con APIs JAX-RS, APIs Servlet, Rutas Reactivas o APIs Funqy HTTP. Una vez construido, podrás desplegar el proyecto en Google Cloud.

Si no quieres seguir todos estos pasos, puedes ir directamente al ejemplo completo.

Clone el repositorio Git: git clone https://github.com/quarkusio/quarkus-quickstarts.git o descargue un archivo.

La solución se encuentra en google-cloud-functions-http-quickstart directorio.

Creación del proyecto de Maven

Cree una aplicación con la extensión quarkus-google-cloud-functions-http. Puedes utilizar el siguiente comando de Maven para crearla:

CLI

quarkus create app org.acme:google-cloud-functions-http \
    --extension='google-cloud-functions-http,resteasy-reactive-jackson,undertow,reactive-routes,funqy-http' \
    --no-code
cd google-cloud-functions-http

To create a Gradle project, add the --gradle or --gradle-kotlin-dsl option.

For more information about how to install the Quarkus CLI and use it, please refer to the Quarkus CLI guide.

Maven

mvn io.quarkus.platform:quarkus-maven-plugin:2.16.5.Final:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=google-cloud-functions-http \
    -Dextensions='google-cloud-functions-http,resteasy-reactive-jackson,undertow,reactive-routes,funqy-http' \
    -DnoCode
cd google-cloud-functions-http

To create a Gradle project, add the -DbuildTool=gradle or -DbuildTool=gradle-kotlin-dsl option.

Iniciar sesión en Google Cloud

gcloud auth login

Creación de los endpoints

Para este proyecto de ejemplo, crearemos cuatro endpoints, uno para RESTEasy (JAX-RS), uno para Undertow (Servlet), uno para Reactive routes y uno para Funqy HTTP.

Estos diferentes endpoints son para fines de demostración. Para las aplicaciones de la vida real, debes elegir una de estas tecnologías y ceñirte a ella.

Si no necesita endpoints de cada tipo, puede eliminar las extensiones correspondientes de su pom.xml.

Quarkus supports Cloud Functions gen 1 and gen 2. For an overview of Cloud Functions gen 2 see this page on the Google Cloud Functions documentation. To use gen 2 you must and add the --gen2 parameter.

El endpoint JAX-RS

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/hello")
public class GreetingResource {

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "Hello from RESTEasy Reactive";
    }
}

El endpoints del Servlet

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@WebServlet(name = "ServletGreeting", urlPatterns = "/servlet/hello")
public class GreetingServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        resp.setStatus(200);
        resp.addHeader("Content-Type", "text/plain");
        resp.getWriter().write("hello");
    }

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        String name = req.getReader().readLine();
        resp.setStatus(200);
        resp.addHeader("Content-Type", "text/plain");
        resp.getWriter().write("hello " + name);
    }
}

El endpoints de las rutas reactivas

import static io.quarkus.vertx.web.Route.HttpMethod.GET;

import io.quarkus.vertx.web.Route;
import io.vertx.ext.web.RoutingContext;

public class GreetingRoutes {
    @Route(path = "/vertx/hello", methods = GET)
    void hello(RoutingContext context) {
        context.response().headers().set("Content-Type", "text/plain");
        context.response().setStatusCode(200).end("hello");
    }
}

El endpoints HTTP de Funqy

import io.quarkus.funqy.Funq;

public class GreetingFunqy {
    @Funq
    public String funqy() {
        return "Make it funqy";
    }
}

Construir y desplegar en Google Cloud

Quarkus obliga a un empaquetado de tipo uber-jar para su función, ya que el despliegue de Google Cloud Function requiere un único JAR.

Empaqueta tu aplicación utilizando el comando estándar mvn clean package. El resultado del comando anterior es un único archivo JAR dentro del directorio target/deployment que contiene las clases y las dependencias del proyecto.

A continuación, podrá utilizar gcloud para desplegar su función en Google Cloud.

We will use the Java 17 runtime but you can switch to the Java 11 runtime by using --runtime=java11 instead of --runtime=java17 on the deploy commands.

gcloud functions deploy quarkus-example-http \
  --entry-point=io.quarkus.gcp.functions.http.QuarkusHttpFunction \
  --runtime=java17 --trigger-http --allow-unauthenticated --source=target/deployment

El punto de entrada debe ser siempre io.quarkus.gcp.functions.http.QuarkusHttpFunction ya que esta es la clase que integra las Funciones Cloud con Quarkus.

La primera vez que se lanza este comando, puede aparecer el siguiente mensaje de error:

ERROR: (gcloud.functions.deploy) OperationError: code=7, message=Build Failed: Cloud Build has not been used in project <project_name> before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudbuild.googleapis.com/overview?project=<my-project> then retry.

Esto significa que Cloud Build aún no está activado. Para superar este error, abra la URL que se muestra en el error, siga las instrucciones y luego espere unos minutos antes de volver a intentar el comando.

Este comando le dará como salida un httpsTrigger.url que apunta a su función.

A continuación, puede llamar a sus endpoints a través de:

Para JAX-RS: {httpsTrigger.url}/hello
Para el servlet: {httpsTrigger.url}/servlet/hello
Para las rutas reactivas: {httpsTrigger.url}/vertx/hello
Para Funqy: {httpsTrigger.url}/funqy

Pruebas locales

La forma más fácil de probar localmente su función es utilizando el JAR invocador de funciones en la nube.

Puede descargarlo a través de Maven utilizando el siguiente comando:

mvn dependency:copy \
  -Dartifact='com.google.cloud.functions.invoker:java-function-invoker:1.1.1' \
  -DoutputDirectory=.

Antes de utilizar el invocador, primero hay que construir la función a través de mvn package.

A continuación, puede utilizarlo para lanzar su función localmente.

java -jar java-function-invoker-1.1.1.jar \
  --classpath target/deployment/google-cloud-functions-http-1.0.0-SNAPSHOT-runner.jar \
  --target io.quarkus.gcp.functions.http.QuarkusHttpFunction

El parámetro --classpath necesita ser establecido en el JAR previamente empaquetado que contiene su clase de función y todas las clases relacionadas con Quarkus.

Sus endpoints estarán disponibles en http://localhost:8080.

¿Qué es lo siguiente?

You can use our Google Cloud Functions Funqy binding to use Funqy, a provider-agnostic function as a service framework, that allow to deploy HTTP function or Background function to Google Cloud.