Cloud Run + Cloud Endpoints (GoogleCloudPlatform#3406)

aubreyyan · web-flow · commit 2754a0d36db4 · 2020-11-03T21:42:03.000Z
Fixes GoogleCloudPlatform#3095 > It's a good idea to open an issue first for discussion. - [x] I have followed [Sample Format Guide](https://github.com/GoogleCloudPlatform/java-docs-samples/blob/master/SAMPLE_FORMAT.md) - [X] `pom.xml` parent set to latest `shared-configuration` - [x] Appropriate changes to README are included in PR - [X] API's need to be enabled to test (tell us) - [ ] Environment Variables need to be set (ask us to set them) - [X] **Tests** pass: `mvn clean verify` **required** - [X] **Lint** passes: `mvn -P lint checkstyle:check` **required** - [X] **Static Analysis**: `mvn -P lint clean compile pmd:cpd-check spotbugs:check` **advisory only** - [X] Please **merge** this PR for me once it is approved. <details> <summary>mvn clean verify</summary> <pre> aubre@DESKTOP-F4APIAI ~/Projects/java-docs-samples/run/endpoints-v2-backend (run-endpoints) $ mvn clean verify [INFO] Scanning for projects... [INFO] [INFO] -----------------------< com.example:endpoints >------------------------ [INFO] Building rest 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ endpoints --- [INFO] Deleting /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target [INFO] [INFO] --- jacoco-maven-plugin:0.8.5:prepare-agent (default) @ endpoints --- [INFO] argLine set to -javaagent:/mnt/c/Users/aubre/.m2/repository/org/jacoco/org.jacoco.agent/0.8.5/org.jacoco.agent-0.8.5-runtime.jar=destfile=/mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target/jacoco.ex ec [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ endpoints --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ endpoints --- [INFO] Changes detected - recompiling the module! [INFO] Compiling 2 source files to /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target/classes [INFO] [INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ endpoints --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] skip non existing resourceDirectory /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/src/test/resources [INFO] [INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ endpoints --- [INFO] No sources to compile [INFO] [INFO] --- maven-surefire-plugin:3.0.0-M4:test (default-test) @ endpoints --- [INFO] No tests to run. [INFO] [INFO] --- jacoco-maven-plugin:0.8.5:report (report) @ endpoints --- [INFO] Skipping JaCoCo execution due to missing execution data file. [INFO] [INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ endpoints --- [INFO] Building jar: /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target/endpoints-1.0-SNAPSHOT.jar [INFO] [INFO] --- spring-boot-maven-plugin:2.3.1.RELEASE:start (pre-integration-test) @ endpoints --- [INFO] Attaching agents: [] . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.3.1.RELEASE) 2020-07-22 23:44:57.590 INFO 23566 --- [ main] c.e.endpoints.EndpointsApplication : Starting EndpointsApplication on DESKTOP-F4APIAI with PID 23566 (/mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-bac kend/target/classes started by aubre in /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend) 2020-07-22 23:44:57.597 INFO 23566 --- [ main] c.e.endpoints.EndpointsApplication : No active profile set, falling back to default profiles: default 2020-07-22 23:45:01.012 INFO 23566 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http) 2020-07-22 23:45:01.042 INFO 23566 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat] 2020-07-22 23:45:01.042 INFO 23566 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.36] 2020-07-22 23:45:01.397 INFO 23566 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext 2020-07-22 23:45:01.397 INFO 23566 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 3661 ms 2020-07-22 23:45:02.025 INFO 23566 --- [ main] o.s.s.concurrent.ThreadPoolTaskExecutor : Initializing ExecutorService 'applicationTaskExecutor' 2020-07-22 23:45:03.723 INFO 23566 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path '' 2020-07-22 23:45:03.753 INFO 23566 --- [ main] c.e.endpoints.EndpointsApplication : Started EndpointsApplication in 7.509 seconds (JVM running for 9.314) [INFO] [INFO] --- maven-failsafe-plugin:3.0.0-M4:integration-test (default) @ endpoints --- [INFO] No tests to run. [INFO] [INFO] --- springdoc-openapi-maven-plugin:1.0:generate (integration-test) @ endpoints --- 2020-07-22 23:45:06.712 INFO 23566 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring DispatcherServlet 'dispatcherServlet' 2020-07-22 23:45:06.713 INFO 23566 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Initializing Servlet 'dispatcherServlet' 2020-07-22 23:45:06.728 INFO 23566 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet : Completed initialization in 15 ms 2020-07-22 23:45:07.120 INFO 23566 --- [nio-8080-exec-1] o.springdoc.api.AbstractOpenApiResource : Init duration for springdoc-openapi is: 280 ms [INFO] [INFO] --- openapi-converter-maven-plugin:1.0.0-SNAPSHOT:convertOpenApiDocs (integration-test) @ endpoints --- [INFO] [INFO] --- spring-boot-maven-plugin:2.3.1.RELEASE:stop (post-integration-test) @ endpoints --- [INFO] Stopping application... 2020-07-22 23:45:08.039 INFO 23566 --- [on(2)-127.0.0.1] inMXBeanRegistrar$SpringApplicationAdmin : Application shutdown requested. 2020-07-22 23:45:08.083 INFO 23566 --- [on(2)-127.0.0.1] o.s.s.concurrent.ThreadPoolTaskExecutor : Shutting down ExecutorService 'applicationTaskExecutor' [INFO] [INFO] --- maven-failsafe-plugin:3.0.0-M4:verify (default) @ endpoints --- [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 38.060 s [INFO] Finished at: 2020-07-22T23:45:08-04:00 [INFO] ------------------------------------------------------------------------ </pre> </details> <details> <summary>mvn -P lint checkstyle:check</summary> <pre> aubre@DESKTOP-F4APIAI ~/Projects/java-docs-samples/run/endpoints-v2-backend (run-endpoints) $ mvn -P lint checkstyle:check [INFO] Scanning for projects... [INFO] [INFO] -----------------------< com.example:endpoints >------------------------ [INFO] Building rest 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-checkstyle-plugin:3.1.1:check (default-cli) @ endpoints --- [INFO] Starting audit... Audit done. [INFO] You have 0 Checkstyle violations. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 12.978 s [INFO] Finished at: 2020-07-22T23:57:47-04:00 [INFO] ------------------------------------------------------------------------ </pre> </details> <details> <summary>mvn -P lint clean compile pmd:cpd-check spotbugs:check</summary> <pre> aubre@DESKTOP-F4APIAI ~/Projects/java-docs-samples/run/endpoints-v2-backend (run-endpoints) $ mvn -P lint clean compile pmd:cpd-check spotbugs:check [INFO] Scanning for projects... [INFO] [INFO] -----------------------< com.example:endpoints >------------------------ [INFO] Building rest 1.0-SNAPSHOT [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ endpoints --- [INFO] Deleting /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target [INFO] [INFO] --- jacoco-maven-plugin:0.8.5:prepare-agent (default) @ endpoints --- [INFO] argLine set to -javaagent:/mnt/c/Users/aubre/.m2/repository/org/jacoco/org.jacoco.agent/0.8.5/org.jacoco.agent-0.8.5-runtime.jar=destfile=/mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target/jacoco.ex ec [INFO] [INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ endpoints --- [INFO] Using 'UTF-8' encoding to copy filtered resources. [INFO] Copying 1 resource [INFO] [INFO] --- maven-compiler-plugin:3.8.1:compile (default-compile) @ endpoints --- ... [INFO] Changes detected - recompiling the module! [INFO] Compiling 2 source files to /mnt/c/Users/aubre/Projects/java-docs-samples/run/endpoints-v2-backend/target/classes [INFO] [INFO] >>> spotbugs-maven-plugin:4.0.0:check (analyze-compile) > :spotbugs @ endpoints >>> [INFO] [INFO] --- spotbugs-maven-plugin:4.0.0:spotbugs (spotbugs) @ endpoints --- ... [INFO] Done SpotBugs Analysis.... [INFO] [INFO] <<< spotbugs-maven-plugin:4.0.0:check (analyze-compile) < :spotbugs @ endpoints <<< [INFO] [INFO] [INFO] --- spotbugs-maven-plugin:4.0.0:check (analyze-compile) @ endpoints --- [INFO] BugInstance size is 2 [INFO] Error size is 0 [INFO] Total bugs: 2 [ERROR] com.example.endpoints.controllers.RepeatController is a Spring endpoint (Controller) [com.example.endpoints.controllers.RepeatController] At RepeatController.java:[lines 34-40] SPRING_ENDPOINT [ERROR] Method com.example.endpoints.controllers.RepeatController.repeat(String, Integer) passes constant String of length 1 to character overridden method [com.example.endpoints.controllers.RepeatController] At RepeatController.jav a:[line 38] UCPM_USE_CHARACTER_PARAMETERIZED_METHOD [INFO] To see bug detail using the Spotbugs GUI, use the following command "mvn spotbugs:gui" [INFO] ------------------------------------------------------------------------ [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:11 min [INFO] Finished at: 2020-07-23T00:00:14-04:00 [INFO] ------------------------------------------------------------------------ [ERROR] Failed to execute goal com.github.spotbugs:spotbugs-maven-plugin:4.0.0:check (analyze-compile) on project endpoints: failed with 2 bugs and 0 errors -> [Help 1] [ERROR] [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch. [ERROR] Re-run Maven using the -X switch to enable full debug logging. [ERROR] [ERROR] For more information about the errors and possible solutions, please read the following articles: [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException </pre> </details> ~~This pull request is **not** final. I wanted to get the functional part of the code approved before writing a detailed instructional README.~~
diff --git a/run/endpoints-v2-backend/README.md b/run/endpoints-v2-backend/README.md
@@ -0,0 +1,53 @@
+# Cloud Run Endpoints Sample
+
+This sample shows how to create a Cloud Endpoints service.
+
+Use it with the [Getting Started with Endpoints for Cloud Run with ESPv2 tutorial][tutorial_link].
+
+For more details on how to work with this sample read the [Google Cloud Run Java Samples README][tutorial_link].
+
+[![Run in Google Cloud][run_img]][run_link]
+
+## Dependencies
+
+* **Spring Boot**: Web server framework.
+* **SpringDoc OpenApi**: API documentation generation tool.
+* **Jib**: Container build tool.
+
+## Generating the Endpoints spec
+
+
+1. Update `PROJECT_ID` in `pom.xml` with your GCP Project Id:
+
+    ```
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <maven.compiler.target>11</maven.compiler.target>
+        <maven.compiler.source>11</maven.compiler.source>
+        <endpoints.project.id>PROJECT ID</endpoints.project.id>
+    </properties>
+    ```
+
+1. Update `<CLOUD_RUN_HOSTNAME>` and `<CLOUD_RUN_SERVICE_URL>` in `EndpointsApplication.java` according to variable
+
+definitions at [Getting Started with Endpoints for Cloud Run with ESPv2](https://cloud.google.com/endpoints/docs/openapi/get-started-cloud-run#reserve_hostname)
+ (Reserving a Cloud Run hostname).
+
+1. Run `mvn clean install` (or alternatively just `mvn verify`) to use the SpringDoc Maven Plugin to generate a base
+    openapi file in the root directory.
+
+    You are able to customize the output filename by changing its plugin configuration `outputFileName` in pom.xml.
+    
+    SpringDoc Openapi Maven Plugin runs during the integration test lifecycle phase in order to pull down a Swagger 3.0
+    openapi specification and automatically write into a file.
+    
+1. Manually, you must switch the generated file's swagger version from 3.0 to 2.0. At the end, it should look like the
+    file openapi-run.yaml in this demo project. If you are using an IDE like IntelliJ IDEA Ultimate, after switching the
+    version number to 2.0, it should tell you what's wrong with the file.
+    
+1. Follow the [Getting Started with Endpoints for Cloud Run with ESPv2](https://cloud.google.com/endpoints/docs/openapi/get-started-cloud-run#deploy_configuration)
+    guide (Deploying the Endpoints configuration).
+
+[run_img]: https://storage.googleapis.com/cloudrun/button.svg
+[run_link]: https://deploy.cloud.run/?git_repo=https://github.com/GoogleCloudPlatform/java-docs-samples&dir=run/markdown-preview
+[tutorial_link]: https://cloud.google.com/endpoints/docs/openapi/get-started-cloud-run
diff --git a/run/endpoints-v2-backend/openapi-run.yaml b/run/endpoints-v2-backend/openapi-run.yaml
@@ -0,0 +1,44 @@
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+swagger: "2.0"
+info:
+  title: Cloud Endpoints + Cloud Run
+  description: Sample API on Cloud Endpoints with a Cloud Run backend
+  version: 1.0.0
+paths:
+  /api/v1/repeat:
+    get:
+      tags:
+      - repeat-controller
+      operationId: repeat
+      parameters:
+      - name: text
+        in: query
+        required: true
+        type: string
+      - name: times
+        in: query
+        required: true
+        type: integer
+      responses:
+        "200":
+          description: OK
+produces:
+- application/json
+x-google-backend:
+  protocol: h2
+  address: <CLOUD_RUN_SERVICE_URL>
+schemes:
+- https
+host: <CLOUD_RUN_HOSTNAME>
diff --git a/run/endpoints-v2-backend/pom.xml b/run/endpoints-v2-backend/pom.xml
@@ -0,0 +1,153 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Copyright 2020 Google LLC
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <groupId>com.example</groupId>
+    <artifactId>endpoints</artifactId>
+    <packaging>jar</packaging>
+    <version>1.0-SNAPSHOT</version>
+    <name>rest</name>
+
+    <!--
+    The parent pom defines common style checks and testing strategies for our samples.
+    Removing or replacing it should not affect the execution of the samples in anyway.
+  -->
+    <parent>
+        <groupId>com.google.cloud.samples</groupId>
+        <artifactId>shared-configuration</artifactId>
+        <version>1.0.18</version>
+    </parent>
+
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <maven.compiler.target>11</maven.compiler.target>
+        <maven.compiler.source>11</maven.compiler.source>
+        <endpoints.project.id>PROJECT ID</endpoints.project.id>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot</artifactId>
+            <version>2.3.1.RELEASE</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-autoconfigure</artifactId>
+            <version>2.3.1.RELEASE</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework</groupId>
+            <artifactId>spring-web</artifactId>
+            <version>5.2.7.RELEASE</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+            <version>2.3.1.RELEASE</version>
+        </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+            <version>2.11.1</version>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2</artifactId>
+            <version>2.1.2</version>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
+            <version>2.1.2</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-ui</artifactId>
+            <version>1.4.3</version>
+        </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>1.18.12</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.6.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <version>2.3.3.RELEASE</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>2.3.1.RELEASE</version>
+                <executions>
+                    <execution>
+                        <id>pre-integration-test</id>
+                        <goals>
+                            <goal>start</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>post-integration-test</id>
+                        <goals>
+                            <goal>stop</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>com.google.cloud.tools</groupId>
+                <artifactId>jib-maven-plugin</artifactId>
+                <version>2.4.0</version>
+                <configuration>
+                    <to>
+                        <image>gcr.io/${endpoints.project.id}/endpoints-container</image>
+                    </to>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.springdoc</groupId>
+                <artifactId>springdoc-openapi-maven-plugin</artifactId>
+                <version>1.0</version>
+                <executions>
+                    <execution>
+                        <id>integration-test</id>
+                        <goals>
+                            <goal>generate</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <apiDocsUrl>http://localhost:8080/v3/api-docs.yaml</apiDocsUrl>
+                    <outputFileName>openapi-run.yaml</outputFileName>
+                    <outputDir>${project.basedir}</outputDir>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>
diff --git a/run/endpoints-v2-backend/src/main/java/com/example/endpoints/EndpointsApplication.java b/run/endpoints-v2-backend/src/main/java/com/example/endpoints/EndpointsApplication.java
@@ -0,0 +1,51 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.endpoints;
+
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import java.util.Collections;
+import java.util.Map;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.Bean;
+
+@SpringBootApplication
+public class EndpointsApplication {
+
+  public static void main(String[] args) {
+    SpringApplication.run(EndpointsApplication.class, args);
+  }
+
+  @Bean
+  public OpenAPI customOpenApi() {
+    return new OpenAPI()
+        .info(new Info()
+            .title("Cloud Endpoints + Cloud Run")
+            .description("Sample API on Cloud Endpoints with a Cloud Run backend")
+            .version("1.0.0"))
+        .servers(null)
+        .extensions(Map.of(
+            "host", "<CLOUD_RUN_HOSTNAME>",
+            "schemes", Collections.singletonList("https"),
+            "produces", Collections.singletonList("application/json"),
+            "x-google-backend", Map.of(
+                "address", "<CLOUD_RUN_SERVICE_URL>",
+                "protocol", "h2"
+            )));
+  }
+}
diff --git a/run/endpoints-v2-backend/src/main/java/com/example/endpoints/controllers/RepeatController.java b/run/endpoints-v2-backend/src/main/java/com/example/endpoints/controllers/RepeatController.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.endpoints.controllers;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+
+@RequestMapping("/api/v1")
+@RestController
+public class RepeatController {
+
+  @GetMapping("/repeat")
+  public ResponseEntity<String> repeat(@RequestParam("text") String text,
+                                       @RequestParam("times") Integer times) {
+    StringBuilder response = new StringBuilder();
+    for (int i = 0; i < times - 1; i++) {
+      response.append(text).append(", ");
+    }
+    response.append(text).append("!");
+
+    return new ResponseEntity<>(response.toString(), HttpStatus.OK);
+  }
+}
diff --git a/run/endpoints-v2-backend/src/main/resources/application.yml b/run/endpoints-v2-backend/src/main/resources/application.yml
@@ -0,0 +1,15 @@
+#  Copyright 2020 Google LLC
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+server:
+  port: ${PORT:8080}
diff --git a/run/endpoints-v2-backend/src/test/java/com/example/controllers/RepeatControllerIT.java b/run/endpoints-v2-backend/src/test/java/com/example/controllers/RepeatControllerIT.java
diff --git a/run/endpoints-v2-backend/src/test/java/com/example/controllers/RepeatControllerTest.java b/run/endpoints-v2-backend/src/test/java/com/example/controllers/RepeatControllerTest.java
