Apache Fineract CN Docker Compose项目安装指南

1. 项目介绍

Apache Fineract CN 是一个开源的、用于构建金融服务的平台，它提供了一个完整的、模块化的银行系统，支持各种金融服务。Docker Compose版本则使得部署Apache Fineract CN更加便捷，它通过Docker容器和Kubernetes脚本来部署服务。

2. 项目下载位置

项目托管在GitHub上，您可以访问以下位置下载Apache Fineract CN Docker Compose项目：

https://github.com/apache/fineract-cn-docker-compose.git

3. 项目安装环境配置

在开始安装之前，确保您的系统中已经安装了以下环境：

• Kubernetes
• Docker
• Docker Compose
• Java

以下是一个示例图片，展示了在终端中检查Docker Compose版本的情况：

$ docker-compose --version
docker-compose version 1.29.2, build 0746c7a

请确保您的环境与上述要求一致。

4. 项目安装方式

克隆项目

首先，从GitHub上克隆项目到本地：

git clone https://github.com/apache/fineract-cn-docker-compose.git
cd fineract-cn-docker-compose

部署到Kubernetes

在项目目录中，使用以下命令部署Apache Fineract CN服务到您的Kubernetes集群：

cd kubernetes_scripts
bash kubectl-start-up.sh

部署完成后，通过以下命令检查所有服务的状态：

kubectl get services

最后，通过以下命令来配置微服务：

cd bash_scripts
bash provision.sh --deploy-on-kubernetes playground # 将playground替换为您的租户名称

使用Docker和Docker Compose部署

您也可以选择使用Docker和Docker Compose来自动或手动部署服务。

自动部署

启动所有Apache 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 # 将playground替换为您的租户名称

手动部署

首先，生成环境变量文件：

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

然后，启动外部工具（如数据库、Cassandra等）：

cd external_tools
docker-compose up

接下来，启动微服务：

docker-compose up provisioner-ms

等待provisioner-ms启动并创建所需的数据库表后，再启动其他服务。

5. 项目处理脚本

项目中的脚本主要用于部署和配置Apache Fineract CN。以下是一些关键脚本的简要说明：

• kubectl-start-up.sh：用于在Kubernetes集群上启动所有Apache Fineract CN服务。
• provision.sh：用于配置微服务，需要指定部署的环境（如Kubernetes）和租户名称。
• start-up.sh：用于使用Docker Compose启动所有Apache Fineract CN服务。

通过遵循上述步骤，您应该能够成功下载并安装Apache Fineract CN Docker Compose项目。