如何使用Fineract CN Docker-Compose脚本进行开发部署

2024-12-21 10:06:49作者：魏献源Searcher

引言

在现代金融科技领域，快速部署和测试金融服务平台是开发过程中的关键步骤。Apache Fineract CN 是一个开源的金融服务平台，提供了丰富的微服务架构，能够支持多种金融业务场景。为了简化开发和测试过程，Fineract CN 提供了 Docker 和 Kubernetes 脚本，帮助开发者快速部署和配置环境。本文将详细介绍如何使用这些脚本进行开发部署，并探讨其在实际应用中的优势。

准备工作

环境配置要求

在开始部署之前，确保你的开发环境满足以下要求：

Kubernetes：用于管理容器化应用的集群。
Docker：用于创建和管理容器的工具。
Docker-compose：用于定义和运行多容器 Docker 应用程序的工具。
Java：Fineract CN 的核心服务依赖于 Java 环境。

所需数据和工具

在部署过程中，你可能需要以下数据和工具：

RSA 密钥：用于生成环境变量文件 .env。
Postman：用于手动部署和配置 Fineract CN 服务。
Eureka 控制台：用于监控服务的注册情况。

模型使用步骤

数据预处理方法

在部署之前，首先需要生成 RSA 密钥并创建 .env 文件。你可以使用以下命令生成 RSA 密钥：

java -cp external_tools/lang-0.1.0-BUILD-SNAPSHOT.jar org.apache.fineract.cn.lang.security.RsaKeyPairFactory UNIX > .env

然后，将其他环境变量添加到 .env 文件中：

cat env_variables >> .env

模型加载和配置

使用 Kubernetes 部署

设置 Kubernetes 集群：确保你已经设置并连接到 Kubernetes 集群。你可以参考这篇指南来设置 GKE 集群。
进入 Kubernetes 目录：
```
cd kubernetes_scripts
```
部署所有 Fineract CN 服务：
```
bash kubectl-start-up.sh
```
检查服务的外部 IP 地址：
```
kubectl get services
```

配置微服务：

cd bash_scripts
bash provision.sh --deploy-on-kubernetes playground

关闭并重置集群：
```
bash kubectl-shut-down.sh
```

使用 Docker 和 Docker-compose 部署

自动部署：
- 启动所有 Fineract CN 服务：
```
bash start-up.sh
```
- 检查最后一个部署的微服务（如 fineract-cn-notification）：
```
docker logs -f fineract-cn-docker-compose_notifications-ms_1
```
- 配置微服务：
```
cd bash_scripts
bash provision.sh playground
```
手动部署：
- 启动外部工具（如数据库、Cassandra 等）：
```
cd external_tools
docker-compose up
```
- 启动微服务：
```
docker-compose up provisioner-ms
```
- 选择要运行的服务，并启动它们：
```
docker-compose up rhythm-ms identity-ms customer-ms accounting-ms deposit-ms portfolio-ms office-ms teller-ms fims-web-app
```
- 使用 Postman 进行配置：
  - 导入 Postman 集合和环境文件。
  - 按顺序执行请求，获取认证令牌。
  - 使用 Postman Runner 导入账户数据。