mauvaisetroupe/ea-design-it

EADesignIt Docker镜像文档

镜像概述和主要用途

EADesignIt是一款轻量级开源企业架构软件，旨在帮助企业架构师以最小工作量记录企业状态，创建资产、资产连接及其特性的透明度。它的核心用途是通过数据库存储替代难以维护的Excel文件，作为企业架构信息的中央存储库。

核心功能和特性

核心定位

该应用并非架构图表工具，而应优先视为数据库存储库。

图表功能

尽管核心是存储库，EADesignIt仍提供两种图表能力：

• 使用PlantUML实现实时可视化
• 生成可编辑的Drawio格式图表

使用场景和适用范围

适用于需要文档化企业架构状态的企业架构师，特别适合以下场景：

• 管理企业应用景观描述
• 替代基于Excel的架构文档管理
• 需要集中存储和维护企业资产信息
• 需实时可视化和编辑架构关系图

使用方法和配置说明

Docker Compose配置

EADesignIT + PostgreSQL + pgAdmin完整配置

可在GitHub仓库获取Docker Compose示例：https://github.com/mauvaisetroupe/ea-design-it/tree/main/src/main/docker

使用以下命令启动完整环境（包含应用、数据库和管理工具）：

bash
docker-compose -f src/main/docker/app.yml up

完整配置示例：

yaml
# 此配置用于开发目的，生产环境下需自行加强安全性
version: '3.8'
services:
  eadesignit-app:
    image: mauvaisetroupe/ea-design-it
    environment:
      - _JAVA_OPTIONS=-Xmx512m -Xms256m
      - SPRING_PROFILES_ACTIVE=prod,api-docs
      - MANAGEMENT_METRICS_EXPORT_PROMETHEUS_ENABLED=true
      - SPRING_DATASOURCE_URL=jdbc:postgresql://eadesignit-postgresql:5432/EADesignIt
      - SPRING_LIQUIBASE_URL=jdbc:postgresql://eadesignit-postgresql:5432/EADesignIt
      - JHIPSTER_SLEEP=30 # 给其他服务启动留出时间
    # 如需在开发电脑外暴露端口，移除"127.0.0.1:"前缀
    ports:
      - 127.0.0.1:8080:8080
  eadesignit-postgresql:
    image: postgres:14.1
    # volumes:
    #   - ~/volumes/jhipster/EADesignIt/postgresql/:/var/lib/postgresql/data/
    environment:
      - POSTGRES_USER=EADesignIt
      - POSTGRES_PASSWORD=
      - POSTGRES_HOST_AUTH_METHOD=trust
    # 如需在开发电脑外暴露端口，移除"127.0.0.1:"前缀
    ports:
      - 127.0.0.1:5432:5432

  pgadmin:
    container_name: pgadmin4_container
    image: dpage/pgadmin4
    restart: always
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@admin.com
      PGADMIN_DEFAULT_PASSWORD: root
    ports:
      - '5050:80'
    links:
      - 'eadesignit-postgresql:pgsql-server'
      # pgadmin中使用'pgsql-server'作为服务器名称
      # 参考: https://linuxhint.com/postgresql_docker/

运行独立数据库

如需仅启动数据库服务（不启动其他服务），使用数据库专用Docker Compose配置：

https://github.com/mauvaisetroupe/ea-design-it/blob/main/src/main/docker/postgresql.yml

启动命令：

bash
docker-compose -f src/main/docker/postgresql.yml up

之后可在VS Code等环境中单独运行EADesignIt应用。

填充合成数据

可通过导入以下实体的Excel文件来填充数据库：

• 应用程序（Aplication）
• 景观（Landscape）
• 能力（Capabilities）
• 应用程序/能力映射（pplications/Capabilities mapping）

Excel示例文件：https://github.com/mauvaisetroupe/ea-design-it/blob/main/docs/excel-import/samples/full-data-export-generated-by-chat-gpt.xlsx

文档和源码

• 完整文档：[***]
• 源码：https://github.com/mauvaisetroupe/ea-design-it/
• 发布版本：https://github.com/mauvaisetroupe/ea-design-it/releases