**Spring Cloud GCP 1.2.3.RELEASE** 是一个用于将 Spring Framework 应用程序与 Google Cloud Platform (GCP) 集成的框架版本

Spring Cloud GCP 1.2.3 是 Spring Cloud GCP 项目的一个版本，旨在为 Spring 应用程序提供与 Google Cloud Platform (GCP) 的无缝集成。它通过一系列自动配置和绑定，简化了在 GCP 上运行 Spring 应用程序的过程，使开发者能够更轻松地利用 GCP 的功能。以下是关于该版本的详细介绍：

---

1. 核心功能

Spring Cloud GCP 1.2.3 提供了以下核心功能：

• Spring Cloud GCP Pub/Sub 支持：包括 Spring Integration 和 Spring Cloud Stream Binder，用于与 Google Cloud Pub/Sub 服务集成。
• Spring Data 集成：支持 Google Cloud Spanner、Datastore 和 Cloud SQL，简化了数据存储和访问。
• Google Cloud Storage：通过 Spring Resource 和 Spring Integration 提供对 Google Cloud Storage 的支持。
• Google Cloud Vision API 模板：简化了与 Google Cloud Vision API 的集成。
• Spring Security 集成：支持从 Google Cloud IAP 头中提取身份信息，增强安全性。
• Google Cloud Stackdriver Logging & Tracing：提供日志记录和分布式跟踪功能。

---

2. 使用场景

Spring Cloud GCP 1.2.3 适用于以下场景：

• 微服务架构：在微服务架构中集成 GCP 服务，如 Pub/Sub、Cloud Storage 和 Cloud SQL。
• 大数据分析：通过集成 BigQuery 进行高性能数据分析。
• 云原生应用：构建云原生 Spring 应用，充分利用 GCP 的托管服务。
• 异常处理：使用 Pub/Sub DLQ（死信队列）处理无法正常消费的消息。

---

3. 快速入门

3.1 添加依赖

在 Maven 项目中添加 Spring Cloud GCP 的依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-gcp-starter</artifactId>
    <version>1.2.3.RELEASE</version>
</dependency>

3.2 配置 GCP 服务

在 application.properties 中配置 GCP 项目 ID 和凭据：

spring.cloud.gcp.project-id=your-project-id
spring.cloud.gcp.credentials.location=file:/path/to/credentials.json

3.3 使用 Pub/Sub

通过 Spring Integration 发送和接收消息：

@Autowired
private PubSubTemplate pubSubTemplate;

public void sendMessage(String topic, String message) {
    pubSubTemplate.publish(topic, message);
}

@Bean
public MessageChannel pubsubInputChannel() {
    return new PublishSubscribeChannel();
}

@ServiceActivator(inputChannel = "pubsubInputChannel")
public void messageReceiver(String payload) {
    System.out.println("Received: " + payload);
}

---

4. 注意事项

• 版本兼容性：Spring Cloud GCP 1.2.3 需要 Spring Boot 2.x 版本。
• 凭据管理：确保正确配置 GCP 凭据，避免身份验证问题。
• 功能限制：某些高级功能（如 Pub/Sub DLQ）可能需要更高版本的 Spring Cloud GCP。

---

5. 总结

Spring Cloud GCP 1.2.3 是一个功能强大的工具，帮助开发者在 Spring 应用程序中无缝集成 Google Cloud Platform 服务。通过自动配置和绑定，开发者可以更高效地构建和管理云原生应用。如果需要更详细的使用指南或示例代码，可以参考 Spring Cloud GCP 官方文档 和相关资源。

如果需要进一步了解其技术细节或实践案例，可以参考以下资源：

• Spring Cloud GCP 项目地址。
• Spring Cloud GCP 示例代码。

Spring Cloud GCP 1.2.3.RELEASE 介绍

Spring Cloud GCP 1.2.3.RELEASE 是一个用于将 Spring Framework 应用程序与 Google Cloud Platform (GCP) 集成的框架版本，于 2020 年 5 月 29 日发布。以下是该版本的主要特性和更新内容：

主要特性

1. 自动配置支持：

   • 提供了自动配置模块，支持 Google Cloud 的多种服务，如 Pub/Sub、Datastore、Spanner、SQL、Logging 等。

2. Spring Data 集成：

   • 支持与 Google Cloud Spanner、Datastore 和 Firestore 的集成。

3. 消息传递支持：

   • 提供了与 Google Cloud Pub/Sub 的集成，包括 Spring Integration 和 Spring Cloud Stream Binder。

4. 日志和追踪：

   • 支持 Google Cloud Stackdriver Logging 和 Tracing。

5. 存储服务集成：

   • 提供了与 Google Cloud Storage 的集成，支持通过 Spring Resource 和 Spring Integration 进行读写操作。

6. 身份验证支持：

   • 提供了从 Google Cloud IAP（身份感知代理）头部提取身份信息的支持。

7. BigQuery 集成：

   • 提供了与 Google Cloud BigQuery 的集成。

更新内容

1. 依赖升级：

   • 升级到最新的库版本和 SQL Socket Factory。

2. 事务管理器优化：

   • 对 Spanner 和 Datastore 的事务管理器进行了优化，使其依赖于启用标志。

3. 日志格式变更：

   • 升级到最新的 google-cloud-logging-logback，日志条目现在以 JSON 格式写入。

4. Secret Manager 改动：

   • 对 Secret Manager 的属性源进行了多项重大变更，移除了版本属性，并引入了新的协议来指定密钥的项目和版本。

5. Pub/Sub 异步方法：

   • 引入了新的异步拉取方法和完全异步的 PubSubReactiveFactory.poll()。

6. Spanner 和 Datastore 优化：

   • 修复了 @Where 注解在生成 ORDER BY 查询时的问题。
   • 支持 Datastore 的嵌套属性和自定义映射。

7. Firestore 支持：

   • 支持 Firestore 的嵌套属性和排序 PartTree 查询。

使用方法

1. 添加依赖：

   • 在项目中引入 Spring Cloud GCP 的 BOM 文件，以管理依赖版本：

     <dependencyManagement>
         <dependencies>
             <dependency>
                 <groupId>org.springframework.cloud</groupId>
                 <artifactId>spring-cloud-gcp-dependencies</artifactId>
                 <version>1.2.3.RELEASE</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
         </dependencies>
     </dependencyManagement>
     

   • 根据需要引入特定模块的启动器，例如 Pub/Sub、Datastore、SQL 等。

2. 配置服务：

   • 在 application.properties 或 application.yml 文件中配置 Google Cloud 服务的连接信息。

3. 使用示例：

   • 示例代码可以在 Spring Cloud GCP 示例仓库 中找到。

官方文档

• 更多详细信息和使用指南可以参考 Spring Cloud GCP 官方文档。

Spring Cloud GCP 1.2.3.RELEASE 提供了丰富的功能和改进，使得在 Google Cloud Platform 上构建和部署 Spring 应用变得更加简单和高效。

The Spring Cloud GCP project makes the Spring Framework a first-class citizen of Google Cloud Platform (GCP).
Features

Spring Cloud GCP offers a wide collection of libraries that make it easier to use Google Cloud Platform from Spring Framework applications.

Project features include:

Spring Cloud GCP Pub/Sub Support (Spring Integration and Spring Cloud Stream Binder)

Spring Data Cloud Spanner

Spring Data Cloud Datastore

Spring Data Cloud SQL

Google Cloud Stackdriver Logging & Tracing

Google Cloud Storage (Spring Resource and Spring Integration)

Google Cloud Vision API Template

Spring Security identity extraction from Google Cloud IAP headers.

Google Cloud BigQuery with Spring Integration

Getting Started

All Spring Cloud GCP artifacts are made available through Maven Central.
Bill of Materials

If you’re using Maven, you should first add the Spring Cloud GCP Bill of Materials (BOM) to your pom.xml. This will help you manage the version numbers of spring-cloud-gcp dependencies in your project.

org.springframework.cloud spring-cloud-gcp-dependencies {project-version} pom import

Starter Dependencies

Spring Cloud GCP offers starter dependencies through Maven to easily depend on different modules of the library. Each starter contains all the dependencies and transitive dependencies needed to begin using their corresponding Spring Cloud GCP module.

A sample of these artifacts are provided below.
Spring Cloud GCP Starter Description Maven Artifact Coordinates

Cloud Spanner

Provides integrations with Google Cloud Spanner

org.springframework.cloud:spring-cloud-gcp-starter-data-spanner

Cloud Datastore

Provides integrations with Google Cloud Datastore

org.springframework.cloud:spring-cloud-gcp-starter-data-datastore

Cloud Pub/Sub

Provides integrations with Google Cloud Pub/Sub

org.springframework.cloud:spring-cloud-gcp-starter-pubsub

Logging

Enables Stackdriver Logging

org.springframework.cloud:spring-cloud-gcp-starter-logging

SQL - MySQL

Cloud SQL integrations with MySQL

org.springframework.cloud:spring-cloud-gcp-starter-sql-mysql

SQL - PostgreSQL

Cloud SQL integrations with PostgreSQL

org.springframework.cloud:spring-cloud-gcp-starter-sql-postgresql

Storage

Provides integrations with Google Cloud Storage and Spring Resource

org.springframework.cloud:spring-cloud-gcp-starter-storage

Trace

Enables instrumentation with Google Stackdriver Tracing

org.springframework.cloud:spring-cloud-gcp-starter-trace

Vision

Provides integrations with Google Cloud Vision

org.springframework.cloud:spring-cloud-gcp-starter-vision

Security - IAP

Extracts IAP identity information from applications deployed to Google Cloud

org.springframework.cloud:spring-cloud-gcp-starter-security-iap
Code Samples

The best way to learn how to use Spring Cloud GCP is to consult the sample applications on Github.

The table below highlights several samples of the most commonly used integrations in Spring Cloud GCP.
GCP Integration Sample Application

Cloud Pub/Sub

spring-cloud-gcp-pubsub-sample

Cloud Spanner

spring-cloud-gcp-data-spanner-sample

Datastore

spring-cloud-gcp-data-datastore-sample

Cloud SQL (w/ MySQL)

spring-cloud-gcp-sql-mysql-sample

Cloud Storage

spring-cloud-gcp-storage-resource-sample

Stackdriver Logging

spring-cloud-gcp-logging-sample

Trace

spring-cloud-gcp-trace-sample

Cloud Vision

spring-cloud-gcp-vision-api-sample

Cloud Security - IAP

spring-cloud-gcp-security-iap-sample
Initializr

Spring Initializr is a tool which generates the scaffolding code for a new Spring Boot project. It handles the work of generating the Maven or Gradle build file so you do not have to manually add the dependencies yourself.

Spring Initializr offers three modules from Spring Cloud GCP that you can use to generate your project.

GCP Support: The GCP Support module contains auto-configuration support for every Spring Cloud GCP integration. Most of the autoconfiguration code is only enabled if the required dependency is added to your project.

GCP Messaging: Google Cloud Pub/Sub integrations work out of the box.

GCP Storage: Google Cloud Storage integrations work out of the box.

Contact Us

Spring Cloud GCP is an actively maintained project and we encourage users to raise issues and ask questions about the project.

We actively monitor the following communication channels:

Spring Cloud GCP Github Repository: Post an issue in our Github repository to ask questions, make a bug report, file feature requests, etc.

Spring Cloud GCP Gitter Lobby: Ask questions and talk to the developers in our Gitter chatroom.