从浅入深 学习 SpringCloud 微服务架构（十八）
一、开源配置中心 Apollo：概述
1、开源配置中心 Apollo
Apollo -A reliable configuration management system
Apollo(阿波罗)是携程框架部门研发的分布式配置中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性，适用于微服务配置管理场景。服务端基于 Spring Boot 和SpringCloud 开发，打包后可以直接运行，不需要额外安装 Tomcat 等应用容器。
2、Apolo 概述
Apollo(阿波罗)是携程框架部门研发的开源配置管理中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性。
3、正是基于配置的特殊性，所以 Apoll0 从设计之初就立志于成为一个有治理能力的配置发布平台，目前提供了以下的特性:
统一管理不同环境、不同集群的配置
- Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、
不同命名空间(namespace)的配置。 - 同一份代码部署在不同的集群，可以有不同的配置，比如zookeeper的地址等
- 通过命名空间(namespace)可以很方便地支持多个不同应用共享同一份配置，同时还允许0应用对共享的配置进行覆盖。
- Apollo提供了一个统一界面集中式管理不同环境(environment)、不同集群(cluster)、
配置修改实时生效(热发布)
用户在Apollo修改完配置并发布后，客户端能实时(1秒)接收到最新的配置，并通知到应用。程序
版本发布管理
所有的配置发布都有版本概念，从而可以方便地支持配置的回滚。
灰度发布
支持配置的灰度发布，比如点了发布后，只对部分应用实例生效，等观察一段时间没问题后。再推给所有应用实例。
权限管理、发布审核、操作审计。
应用和配置的管理都有完善的权限管理机制，对配置的管理还分为了编辑和发布两个环节。
从而减少人为的错误。
所有的操作都有审计日志，可以方便地追踪问题。客户端配置信息监控。
可以在界面上方便地看到配置在被哪些实例使用。
提供 Java 和 .Net 原生客户端
提供了 Java 和 .Net 的原生客户端，方便应用集成
支持 Spring Placeholder,Annotation 和 Spring Boot的ConfigurationProperties,方便应用使用(需要Spring 3.1.1+)。
同时提供了 Http 接口，非 java 和 .Net 应用也可以方便地使用提供开放平台 API
Apollo自身提供了比较完善的统一配置管理界面，支持多环境、多数据中心配置管理、权限、流程治理等特性。不过Apollo出于通用性考虑，不会对配置的修改做过多限制，只要符合基本的格式就能保存，不会针对不同的配置值进行针对性的校验，如数据库用户名、密码，Redis服务地址等。
对于这类应用配置，Apollo支持应用方通过开放平台API在Apollo进行配置的修改和发布，并。且具备完善的授权和权限控制。部署简单
配置中心作为基础服务，可用性要求非常高，这就要求Apollo对外部依赖尽可能地少0目前唯一的外部依赖是MySQL，所以部署非常简单，只要安装好Java和MySQL就可以让Apollo跑起来
Apollo还提供了打包脚本，一键就可以生成所有需要的安装包，并且支持自定义运行时参数
二、开源配置中心 Apollo：实现过程
1、通过长连接，实时的获取最新的服务端配置数据。
2、定时拉取配置信息。
3、客户端获取数据之后，将数据保存到内存中，也会将数据保存到本地文件中。
三、开源配置中心 Apollo：搭建服务端
1、搭建 开源配置中心 Apolo 服务端 — 环境要求
1）Java
- Apollo 服务端 : 1.8+
- Apollo 客户端 : 1.7+
由于需要同时运行服务端和客户端，所以建议安装 Java1.8+。
2）MySQL
版本要求 : 5.6.5+
Apollo 的表结构对 timestamp 使用了多个 default 声明，所以需要 5.6.5 以上版本。
2、搭建 开源配置中心 Apolo 服务端 — 环境搭建
2.1 下载安装 Apollo（apollo-quick-start-1.5.0.zip）
1）apollo 下载地址：
Apollo 下载地址：https://github.com/ctripcorp/apollo/releases
Apollo Github 地址：https://github.com/ctripcorp/apollo
Apollo 官方安装教程：https://github.com/ctripcorp/apollo/wiki/Quick-Start
Apollo 分布式部署官方指南：https://github.com/ctripcorp/apollo/wiki/%E5%88%86%E5%B8%83%E5%BC%8F%E9%83%A8%E7%BD%B2%E6%8C%87%E5%8D%97
2）解压即安装，如：D:\Program Files\apollo-quick-start-1.5.0
2.2 配置 mysql 数据库
Apollo 服务端共需要两个数据库 : Apo11oPorta1D8 和 Apo11oconfigDB，
数据库、表的创建使用 sql 文件导入数据库即可。
- 打开 SQLyog 连接 mysql
- 右键 【root@localhost】 --》执行 SQL 脚本。
- 找到 apollo 解压包下的 sql 文件夹下的两个 sql 脚本。
- 点击执行即可。
注意:如果你本地已经创建过 Apollo 数据库，请注意备份数据。我们准备的 sql 文件会清空 Apollo 相关的表。
2.3 启动 apollo 服务 ./demo.sh start 。
1）使用 SecureCRT 软件连接一台 linux 虚拟机 。点击 SecureCRT 软件工具栏 SecureFX 上传文件 apollo-quick-start-1.5.0.zip 到 linux 虚拟机。
2）创建一个新目录 /usr/apollo/ 把 apollo-quick-start-1.5.0.zip 移动到 /usr/apollo 解压。
unzip apollo-quick-start-1.5.0.zip
3）修改 demo.sh 文件，配置好 连接 mysql 数据库的参数和用户名和密码，保存文件。
vim demo.sh
#!/bin/bash
# apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/apolloconfigdb?characterEncoding=utf8
apollo_config_db_username=root
apollo_config_db_password=12311
# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/apolloportaldb?characterEncoding=utf8
apollo_portal_db_username=root
apollo_portal_db_password=12311
4）也可以使用 Git Bash 在 windows 系统下，apollo 的安装目录下，直接启动 apollo 服务。
./demo.sh start
四、开源配置中心 Apollo：管理后台介绍
1、启动 Apollo 服务成功后（./demo.sh start）
1）浏览器地址输入：localhost:8080 登录 到 eureka 服务后台。
2）浏览器地址输入：localhost:8070 登录 到 apollo 服务后台。
默认用户名：apollo 默认密码：admin
2、在 apollo 服务后台，创建项目：
部门：【样例部门】
AppId: 【product-service】
启用名称：【商品微服务】
应用负责人：【apollo】
项目管理员：【apollo】
点击【提交】。
五、开源配置中心 Apollo：客户端集成开发
1、开源配置中心 Apollo：客户端集成开发案例搭建–准备数据库。
— 创建数据库：
create database shop;
— 使用数据库：
use shop;
— 创建数据表：
CREATE TABLE `tb_product` (
`id` int NOT NULL AUTO_INCREMENT,
`product_name` varchar(40) DEFAULT NULL COMMENT '名称',
`status` int DEFAULT NULL COMMENT '状态',
`price` decimal(10,2) DEFAULT NULL COMMENT '单价',
`product_desc` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL COMMENT '描述',
`caption` varchar(255) DEFAULT NULL COMMENT '标题',
`inventory` int DEFAULT NULL COMMENT '库存',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb3
— 插入数据：
insert into `tb_product` (`id`, `product_name`, `status`, `price`, `product_desc`, `caption`, `inventory`) values('1','iPhone 15 Pro','1','7999.00','iPhone 15 Pro 6.7 英寸或 6.1 英寸, 超视网膜 XDR 显示屏,ProMotion 自适应刷新率技术,钛金属搭配亚光质感玻璃背板, 灵动岛功能, A17 Pro 芯片,配备 6 核图形处理器, Pro 级摄像头系统,主摄 4800 万像素 | 超广角 | 长焦, 10 倍, 支持 USB 3, 视频播放最长可达 29 小时。 ','iPhone 15 Pro 巅峰之作','99');
2、开源配置中心 Apollo：客户端集成开发案例搭建–打开 idea 创建父工程
2.1 创建 artifactId 名为 spring_cloud_demo 的 maven 工程。
--> idea --> File
--> New --> Project
--> Maven
Project SDK: ( 1.8(java version "1.8.0_131" )
--> Next
--> Groupld : ( djh.it )
Artifactld : ( spring_cloud_demo )
Version : 1.0-SNAPSHOT
--> Name: ( spring_cloud_demo )
Location: ( ...\spring_cloud_demo\ )
--> Finish
2.2 开源配置中心 Apollo：客户端集成开发案例搭建–在父工程 spring_cloud_demo 的 pom.xml 文件中导入依赖坐标。
<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>djh.it</groupId>
<artifactId>spring_cloud_demo</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
<module>product_service</module>
<module>order_service</module>
<module>eureka_service</module>
<module>import_eurekaserver_test</module>
<module>api_zuul_service</module>
</modules>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.6.RELEASE</version>
</parent>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-logging</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.4</version>
<scope>provided</scope>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-dependencies</artifactId>
<version>Greenwich.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<repositories>
<repository>
<id>spring-snapshots</id>
<name>Spring Snapshots</name>
<url>http://repo.spring.io/libs-snapshot-local</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>spring-milestones</id>
<name>Spring Milestones</name>
<url>http://repo.spring.io/libs-milestone-local</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
<repository>
<id>spring-releases</id>
<name>Spring Releases</name>
<url>http://repo.spring.io/libs-release-local</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-snapshots</id>
<name>Spring Snapshots</name>
<url>http://repo.spring.io/libs-snapshot-local</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>spring-milestones</id>
<name>Spring Milestones</name>
<url>http://repo.spring.io/libs-milestone-local</url>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
<!-- spring_cloud_demo\pom.xml -->
3、开源配置中心 Apollo：客户端集成开发案例搭建–在父工程 spring_cloud_demo 下，创建子工程 product_server （子模块）。
3.1 创建 product_server 子工程（子模块）
--> 右键 spring_cloud_demo 父工程
--> Modules
--> Maven
--> Groupld : ( djh.it )
Artifactld : ( product_server )
Version : 1.0-SNAPSHOT
--> Next
--> Module name: ( product_server )
Content root : ( \spring_cloud_demo\product_server )
Module file location: ( \spring_cloud_demo\product_server )
--> Finish
3.2 在子工程 product_server （子模块）中的 pom.xml 中导入依赖
<?xml version="1.0" encoding="UTF-8"?>
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<parent>
<artifactId>spring_cloud_demo</artifactId>
<groupId>djh.it</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>product_server</artifactId>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-netflix-eureka-client</artifactId>
<version>2.1.0.RELEASE</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.ctrip.framework.apollo</groupId>
<artifactId>apollo-client</artifactId>
<version>1.1.0</version>
</dependency>
</dependencies>
</project>
<!-- C:\java-test\idea2019\spring_cloud_demo\product_server\pom.xml -->
3.3 在子工程 product_server （子模块）中，创建 商品实体类 Product.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\domain\Product.java
*
* 2024-5-14 商品实体类 Product.java
*/
package djh.it.product.domain;
import lombok.Data;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;
import java.math.BigDecimal;
@Data
@Entity
@Table(name="tb_product") //对应数据库中的数据表
public class Product {
@Id
private Long id;
private String productName;
private Integer status;
private BigDecimal price;
private String productDesc;
private String caption;
private Integer inventory;
}
3.4 在子工程 product_server （子模块）中，创建 dao 持久层接口 ProductDao.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\dao\ProductDao.java
*
* 2024-5-14 dao 持久层接口 ProductDao.java
*/
package djh.it.product.dao;
import djh.it.product.domain.Product;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
public interface ProductDao
extends JpaRepository<Product, Long>, JpaSpecificationExecutor<Product> {
}
3.5 在子工程 product_server （子模块）中，创建 service 服务层 接口类 ProductService.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\service\ProductService.java
*
* 2024-5-14 service 服务层 接口 ProductService.java
*/
package djh.it.product.service;
import djh.it.product.domain.Product;
public interface ProductService {
//根据id查询
Product findById(Long id);
//保存
void save(Product product);
//更新
void update(Product product);
//删除
void delete(Long id);
}
3.6 在子工程 product_server （子模块）中，创建 service 服务层 实现类 ProductServiceImpl.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\service\impl\ProductServiceImpl.java
*
* 2024-5-14 service 服务层 实现类
*/
package djh.it.product.service.impl;
import djh.it.product.dao.ProductDao;
import djh.it.product.domain.Product;
import djh.it.product.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class ProductServiceImpl implements ProductService {
@Autowired
private ProductDao productDao;
@Override
public Product findById(Long id) {
return productDao.findById(id).get();
}
@Override
public void save(Product product) {
productDao.save(product);
}
@Override
public void update(Product product) {
productDao.save(product);
}
@Override
public void delete(Long id) {
productDao.deleteById(id);
}
}
3.7 在子工程 product_server （子模块）中，创建 商品的 controller 类 ProductController.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\controller\ProductController.java
*
* 2024-5-14 商品的 controller 类 ProductController.java
*/
package djh.it.product.controller;
import djh.it.product.domain.Product;
import djh.it.product.service.ProductService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/product")
public class ProductController {
@Autowired
private ProductService productService;
@Value("${name}")
private String name;
@RequestMapping(value = "/{id}", method = RequestMethod.GET)
public Product findById(@PathVariable Long id){
return productService.findById(id);
}
@RequestMapping(value = "/test")
public String test (){
return name;
}
}
3.8 在子工程 product_server （子模块）中，创建配置文件 application.yml 配置文件。
## spring_cloud_demo\product_server\src\main\resources\application.yml
server:
port: 6001 #服务端口
spring:
application:
nmae: server-product #指定服务名
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://localhost:3306/shop?useUnicode=true&characterEncoding=utf8
username: root
password: 12311
jpa:
database: MySQL
show-sql: true
open-in-view: true
name: zhangsanfeng
apollo:
bootstrap: # 开启 apollo
enabled: true
meta: http://localhost:8080
app:
id: product-service # 指定 apollo 配置中心的名称 appId
3.9 在子工程 product_server （子模块）中，创建 启动类 ProductServerApplication.java
/**
* spring_cloud_demo\product_server\src\main\java\djh\it\product\ProductApplication.java
*
* 2024-5-14 启动类 ProductApplication.java
*/
package djh.it.product;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import java.io.Serializable;
@SpringBootApplication
@EntityScan("djh.it.product.domain")
@EnableEurekaClient //激活 EurekaClient, 同 @EnableDiscoveryClient 注解相同。
public class ProductApplication implements Serializable {
//运行启动类，浏览器地址栏输入：localhost:9001/product/1 进行访问测试。
public static void main(String[] args) {
SpringApplication.run(ProductApplication.class, args);
}
}
3.10 在子工程 product_server （子模块）中，运行启动类，同时 保留 apollo 服务在启动状态，进行测试
1）浏览器地址栏输入：http://localhost:9001/product/test 输出：zhangsanfeng
2）览器地址栏输入：http://localhost:8070/ 登录 apollo 服务后台，
找到我们创建的微服务 【product-service 】，点击【新增】
【添加配置项】：
Key: name
Value: 如：修改为：张三丰
点击【提交】。
3）浏览器地址栏输入：http://localhost:9001/product/test 发现 name 值无变化。
4）览器地址栏输入：http://localhost:8070/ 登录 apollo 服务后台，
点击 【发布】
5）浏览器地址栏输入：http://localhost:9001/product/test name 值已经同步更新。
上一节关联链接请点击：
# 从浅入深 学习 SpringCloud 微服务架构（十七）–Spring Cloud config（2）