Xenit特定Alfresco Share骨架镜像文档

镜像概述

Xenit特定Alfresco Share骨架镜像是专为Alfresco Share应用开发的基础构建镜像，旨在为Alfresco Share服务提供标准化的基础框架。该镜像集成了Alfresco Share运行所需的核心依赖和基础配置，简化了Alfresco Share应用的定制、扩展与部署流程，适用于需要快速搭建Alfresco共享服务环境的场景。

核心功能与特性

基础环境标准化

• 预配置Alfresco Share运行所需的基础环境，包括Tomcat服务器、Java运行时及核心依赖库
• 提供标准化的目录结构，遵循Alfresco Share应用开发最佳实践

集成兼容性

• 与Alfresco Content Services（ACS）保持版本兼容性，支持主流ACS版本集成
• 内置Alfresco Share与ACS通信的基础配置，简化服务对接流程

可扩展性支持

• 预留扩展接口，支持自定义配置覆盖（如share-config-custom.xml）
• 提供模块化结构，方便添加自定义组件、主题及扩展模块

部署效率优化

• 精简基础镜像体积，减少部署资源占用
• 支持Docker多阶段构建，优化镜像构建流程

使用场景与适用范围

适用场景

• Alfresco Share定制开发：作为基础镜像，支持开发者在此基础上定制界面、功能及业务流程
• 企业文档管理系统搭建：快速部署Alfresco共享服务，实现企业级文档协作与管理
• Alfresco生态集成：与其他Alfresco组件（如ACS、Solr）集成，构建完整内容服务平台
• 快速原型验证：基于骨架镜像快速搭建测试环境，验证Alfresco Share扩展功能

目标用户

• 企业IT运维团队
• Alfresco应用开发者
• 系统集成商（SI）
• 需要定制Alfresco Share服务的组织

使用方法与配置说明

获取镜像

通过Docker Hub或私有仓库拉取镜像：

docker pull xenit/alfresco-share-skeleton:[版本标签]

注：请将[版本标签]替换为具体版本号，如6.2.0、7.0.0等。

基本运行示例

启动基础Alfresco Share骨架容器：

docker run -d \
  --name alfresco-share-skeleton \
  -p 8080:8080 \
  xenit/alfresco-share-skeleton:latest

容器启动后，可通过http://localhost:8080/share访问Alfresco Share基础界面。

环境变量配置

通过环境变量自定义基础配置，常用参数如下：

示例：指定ACS主机和端口

docker run -d \
  --name alfresco-share-skeleton \
  -p 8080:8080 \
  -e ALFRESCO_HOST=my-acs-server \
  -e ALFRESCO_PORT=8081 \
  xenit/alfresco-share-skeleton:latest

卷挂载配置

通过卷挂载实现自定义配置覆盖：

1. 自定义配置文件挂载

挂载本地自定义配置文件（如share-config-custom.xml）：

docker run -d \
  --name alfresco-share-skeleton \
  -p 8080:8080 \
  -v ./custom-config/share-config-custom.xml:/usr/local/tomcat/shared/classes/alfresco/web-extension/share-config-custom.xml \
  xenit/alfresco-share-skeleton:latest

2. 扩展模块挂载

挂载自定义扩展模块（如AMP包或Web资源）：

docker run -d \
  --name alfresco-share-skeleton \
  -p 8080:8080 \
  -v ./extensions:/usr/local/tomcat/webapps/share/WEB-INF/classes/alfresco/web-extension/site-data/extensions \
  xenit/alfresco-share-skeleton:latest

Docker Compose示例

与Alfresco Content Services集成的docker-compose配置示例：

version: '3.8'

services:
  alfresco-content:
    image: alfresco/alfresco-content-repository:latest
    environment:
      - DB_HOST=postgres
      - DB_USERNAME=alfresco
      - DB_PASSWORD=alfresco
    ports:
      - "8082:8080"

  alfresco-share:
    image: xenit/alfresco-share-skeleton:latest
    environment:
      - ALFRESCO_HOST=alfresco-content
      - ALFRESCO_PORT=8080
    ports:
      - "8080:8080"
    depends_on:
      - alfresco-content

启动服务：

docker-compose up -d