Spring Cloud GCP

Spring Cloud GCP contains a set of easy to use starters/autoconfigurations that allow you to easily connect and adopt GCP services.

Spring Cloud GCP is part of the Spring Cloud release train.

Even though Spring Cloud GCP is part of the Spring Cloud release train, it doesn't mean that you need to use any Spring Cloud features (Eureka, Config Server, etc.). The release train helps manage dependency versions so that you don't need to specify versions. It avoids having incompatible dependency versions, and eliminates dependency conflicts.

Demo

A short demo video of Spring Cloud GCP

Configure Spring Boot Project

New Spring Boot Project

Create a new Spring Boot project use Spring Initializr, and add the GCP Support dependency.

Add the GCP Support dependency

Or, generate the project using curl:

curl https://start.spring.io/starter.zip \
  -d dependencies=web,cloud-gcp,lombok \
  -d bootVersion=2.3.1.RELEASE \
  -d baseDir=demo

Unpack the downloaded zip file:

unzip demo.zip

The generated project will include Spring Cloud release train BOM.

Existing Spring Boot Project

If you want to add Spring Cloud GCP to existing project, simply add Spring Cloud release train configuration. Different Spring Boot version is compatible with different Spring Cloud releases.

Spring Boot Version	Spring Cloud Version
2.1	Greenwich
2.2	Hoxton
2.3	Hoxton.SR5

See Spring Cloud documentation for the latest versions.

Add the compatible Spring Cloud BOM version to your project:

Maven

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Hoxton.SR5</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Gradle

buildscript {
  dependencies {
    classpath "io.spring.gradle:dependency-management-plugin:1.0.2.RELEASE"
  }
}

apply plugin: "io.spring.dependency-management"

dependencyManagement {
  imports {
    mavenBom 'org.springframework.cloud:spring-cloud-dependencies:Hoxton.RELEASE'
  }
}

A BOM is a Bill of Material, when imported, you can specify dependencies managed by the BOM without explicitly specifying a version for that dependency. Using the Spring Cloud BOM will allow you to use all Google Cloud Client Libraries and Spring Cloud GCP libraries without explicitly specifying a version.

Services

Spring Cloud GCP supports many GCP services using de-facto Spring abstraction layers.

Concerns	GCP Service	Spring Abstraction
Databases	Cloud SQL	JDBC template
		Spring Data JPA
	Cloud Spanner	Spring Data Spanner
		Spring Data JPA with Hibernate
	Cloud Datastore	Spring Data Datastore
	Cloud Firestore	Spring Reactive Data Firestore
Messaging	Cloud Pub/Sub	Pub/Sub Template
		Spring Integration
		Spring Cloud Stream
		Spring Dataflow
Configuration	Cloud Secret Manager	Spring Cloud Config
Storage	Cloud Storage	Spring Resource
Cache	Cloud Memorystore	Spring Data Redis
Distributed Tracing	Cloud Trace	Spring Cloud Sleuth
		Zipkin / Brave
Centralized Logging	Cloud Logging	SLF4J / Logback
Monitoring Metrics	Cloud Monitoring	Micrometer / Prometheus
Security	Cloud Identity Aware Proxy	Spring Security