sburn/apache-atlas

Apache Atlas Docker镜像

镜像概述和主要用途

该镜像基于Apache Atlas 2.3.0发布版源码包构建，已打补丁以适应Docker容器环境。Atlas内置嵌入式HBase和Solr，且已预初始化，下载后可直接使用，无需额外配置步骤。如需使用外部后端存储，可参考官方文档进行设置。

核心功能和特性

• 基于Apache Atlas 2.3.0稳定版本构建
• 内置嵌入式HBase和Solr，无需额外配置后端存储
• 预初始化配置，启动即可使用
• 支持通过环境变量自定义JVM参数和服务配置
• 可挂载日志、配置和数据目录实现持久化
• 内置Tinkerpop Gremlin支持，可通过Gremlin Console操作Janusgraph和Atlas元数据

使用场景和适用范围

• 元数据管理与数据治理场景
• 数据血缘追踪与数据资产管理
• 开发和测试环境中快速部署Apache Atlas
• 学习和评估Apache Atlas功能特性

详细使用方法和配置说明

基本用法

启动Apache Atlas容器并暴露Web-UI端口21000：

bash
docker run -d \
    -p 21000:21000 \
    --name atlas \
    sburn/apache-atlas

注意：首次启动Atlas可能需要几分钟（取决于主机性能），之后Web界面可通过http://localhost:21000/访问。Web-UI默认凭据：admin / admin

使用选项

优雅停止Atlas

bash
docker exec -ti atlas /apache-atlas/bin/atlas_stop.py

查看启动脚本输出

bash
docker logs atlas

查看应用日志（首次运行或调试时有用）

bash
docker exec -ti atlas tail -f /apache-atlas/logs/application.log

运行示例（添加示例类型、实例和特性）

bash
docker exec -ti atlas /apache-atlas/bin/quick_start.py

通过环境变量覆盖设置（例如支持大量元数据对象）

bash
docker run --detach \
    -e "ATLAS_SERVER_OPTS=-server -XX:SoftRefLRUPolicyMSPerMB=0 \
    -XX:+CMSClassUnloadingEnabled -XX:+UseConcMarkSweepGC \
    -XX:+CMSParallelRemarkEnabled -XX:+PrintTenuringDistribution \
    -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=dumps/atlas_server.hprof \
    -Xloggc:logs/gc-worker.log -verbose:gc -XX:+UseGCLogFileRotation \
    -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=1m -XX:+PrintGCDetails \
    -XX:+PrintHeapAtGC -XX:+PrintGCTimeStamps" \
    -p 21000:21000 \
    --name atlas \
    sburn/apache-atlas

暴露日志目录到主机

bash
docker run --detach \
    -v ${PWD}/atlas-logs:/apache-atlas/logs \
    -p 21000:21000 \
    --name atlas \
    sburn/apache-atlas

自定义配置（暴露配置目录到主机）

bash
docker run --detach \
    -v ${PWD}/pre-conf:/apache-atlas/conf \
    -p 21000:21000 \
    --name atlas \
    sburn/apache-atlas

数据持久化（挂载数据目录到主机）

bash
docker run --detach \
    -v ${PWD}/data:/apache-atlas/data \
    -p 21000:21000 \
    --name atlas \
    sburn/apache-atlas

Tinkerpop Gremlin支持

镜像内置Gremlin相关工具，可用于操作Janusgraph和Atlas元数据：

1. 确保Atlas容器已启动
2. 安装gremlin-server和gremlin-console：

bash
docker exec -ti atlas /gremlin/install-gremlin.sh

3. 启动gremlin-server：

bash
docker exec -d atlas /gremlin/start-gremlin-server.sh

4. 交互式运行gremlin-console：

bash
docker exec -ti atlas /gremlin/run-gremlin-console.sh

Gremlin-console使用示例：

bash
         \,,,/
         (o o)
-----oOOo-(3)-oOOo-----

gremlin>:remote connect tinkerpop.server conf/remote.yaml session
==>Configured localhost/127.0.0.1:8182-[d1b2d9de-da1f-471f-be14-34d8ea769ae8]
gremlin> :remote console
==>All scripts will now be sent to Gremlin Server - [localhost/127.0.0.1:8182]-[d1b2d9de-da1f-471f-be14-34d8ea769ae8] - type ':remote console' to return to local mode
gremlin> g = graph.traversal()
==>graphtraversalsource[standardjanusgraph[hbase:[localhost]], standard]
gremlin> g.V().has('__typeName','hdfs_path').count()

环境变量

以下环境变量可用于配置：

有关更多可配置选项，请查看官方Apache Atlas文档。

Bug跟踪

Bug在https://github.com/sburn/docker-apache-atlas/issues%E4%B8%8A%E8%B7%9F%E8%B8%AA%E3%80%82%E5%A6%82%E6%9C%89%E9%97%AE%E9%A2%98%EF%BC%8C%E8%AF%B7%E5%85%88%E6%A3%80%E6%9F%A5%E6%98%AF%E5%90%A6%E5%B7%B2%E6%8A%A5%E5%91%8A%E3%80%82%E5%A6%82%E9%A6%96%E6%AC%A1%E5%8F%91%E7%8E%B0%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BE%9B%E8%AF%A6%E7%BB%86%E5%8F%8D%E9%A6%88%E5%B8%AE%E5%8A%A9%E4%BF%AE%E5%A4%8D%E3%80%82

维护者

此镜像由Vadim Korchagin维护。

• https://github.com/sburn/docker-apache-atlas