# etlcloud-deploy

**Repository Path**: wwyy1/etlcloud-deploy

## Basic Information

- **Project Name**: etlcloud-deploy
- **Description**: 部署etlcloud的项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-09-01
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 平台部署指南

基于 `docker-compose`，快速部署DataOps数据集成平台。

## 目录

- [平台部署指南](#平台部署指南)
  - [目录](#目录)
  - [简介](#简介)
  - [特性](#特性)
  - [环境要求](#环境要求)
  - [目录结构](#目录结构)
  - [安装步骤](#安装步骤)
    - [1. 克隆项目](#1-克隆项目)
    - [2. 准备WAR包](#2-准备war包)
    - [3. 检查配置](#3-检查配置)
    - [4. 启动服务](#4-启动服务)
    - [5. 访问平台](#5-访问平台)
  - [配置说明](#配置说明)
    - [MongoDB用户初始化](#mongodb用户初始化)
    - [应用程序配置](#应用程序配置)
    - [Tomcat配置](#tomcat配置)
  - [常见问题](#常见问题)
  - [贡献](#贡献)
  - [许可证](#许可证)

## 简介

本项目旨在使用Docker和Docker Compose快速部署DataOps数据集成平台。通过容器化的方式，简化了MongoDB和Tomcat的安装配置过程，使部署更加快捷、方便。

## 特性

- **快速部署**：使用Docker容器，几行命令即可完成部署。
- **环境隔离**：容器化的服务，避免了依赖冲突。
- **可定制性**：通过配置文件，可以自定义MongoDB和Tomcat的设置。
- **持久化存储**：数据和配置持久化，容器重启数据不丢失。

## 环境要求

- Docker CE 20.10+
- Docker Compose 1.29+
- 服务器硬件要求：
  - CPU：Intel 1.6G 4核或以上
  - 内存：至少4GB可用内存（不包括操作系统等其他程序占用内存）
  - 硬盘空间：至少40GB可用空间

## 目录结构

项目目录结构如下：

```
├── docker-compose.yml
├── tomcat
│   ├── Dockerfile
│   ├── entrypoint.sh
│   ├── conf
│   │   └── application.properties
│   ├── lib
│   └── webapps
│       └── ROOT
|           └── ROOT.war
└── mongodb
    ├── Dockerfile
    ├── mongo-init.js
    ├── mongod.conf
    ├── data
    └── log

```

- `docker-compose.yml`：Docker Compose配置文件。
- `tomcat/`：Tomcat相关文件和配置。
- `mongodb/`：MongoDB相关文件和配置。
- `tomcat/webapps/ROOT`：应用程序WAR包（需自行添加）。
- `tomcat/lib`: tomcat所有依赖lib包


## 安装步骤

### 1. 克隆项目

```bash
git clone https://github.com/yourusername/your-repo-name.git
cd your-repo-name
```

### 2. 准备WAR包

将平台提供的 `ROOT.war` 文件复制到 `tomcat/webapps/ROOT` 目录下。如果没有该目录，请手动创建。

```bash
mkdir -p root_war
# 将ROOT.war复制到root_war目录
cp /path/to/your/ROOT.war tomcat/webapps/ROOT/
```

### 3. 检查配置

根据需要，检查并修改以下配置文件：

- `tomcat/conf/application.properties`：应用程序配置。
- `mongodb/mongod.conf`：MongoDB配置文件。
- `mongodb/mongo-init.js`：MongoDB用户初始化脚本。

### 4. 启动服务

构建并启动容器：

```bash
docker-compose up -d --build
```

### 5. 访问平台

在浏览器中访问：

```
http://localhost:8080/restcloud/admin/login
```

使用默认的用户名和密码登录：

- **用户名**：`admin`
- **密码**：`pass`

## 配置说明

### MongoDB用户初始化

`mongodb/mongo-init.js` 文件用于初始化MongoDB的用户：

```javascript
db = db.getSiblingDB('admin');

db.createUser({
  user: "admin",
  pwd: "pass@2022",
  roles: [
    { role: "readWriteAnyDatabase", db: "admin" },
    { role: "dbAdminAnyDatabase", db: "admin" }
  ]
});

db.createUser({
  user: "root",
  pwd: "root@2022",
  roles: [ { role: "root", db: "admin" } ]
});
```

### 应用程序配置

`tomcat/conf/application.properties` 文件配置应用程序与MongoDB的连接：

```properties
spring.data.mongodb.authentication-database=admin
spring.data.mongodb.host=mongodb:27017
spring.data.mongodb.username=admin
spring.data.mongodb.password=pass@2022
```

### Tomcat配置

`tomcat/entrypoint.sh` 脚本用于启动Tomcat，并解压WAR包：

```bash
#!/bin/bash

rm -rf /usr/tomcat/webapps/*
if [ -f "/root_war/ROOT.war" ]; then
  mkdir -p /usr/tomcat/webapps/ROOT
  unzip -o /root_war/ROOT.war -d /usr/tomcat/webapps/ROOT
fi

/usr/tomcat/bin/catalina.sh run
```

## 常见问题

- **无法访问平台**：检查Tomcat容器日志，确认应用是否正常启动。

  ```bash
  docker-compose logs -f tomcat
  ```

- **MongoDB连接失败**：确认`application.properties`中的MongoDB连接配置正确，主机名应为`mongodb`。

- **数据未持久化**：确保MongoDB的数据和日志目录正确挂载，并具有适当的权限。

## 贡献

欢迎提交问题（Issues）和合并请求（Pull Requests）来帮助改进本项目。

## 许可证

本项目采用 [MIT 许可证](LICENSE)。详情请参阅 [LICENSE](LICENSE) 文件。