apache/sling

Apache Sling Starter Docker镜像

镜像概述和主要用途

Apache Sling Starter Docker镜像是Apache Sling项目的一部分，用于生成可通过https://github.com/apache/sling-org-apache-sling-feature-launcher%E5%90%AF%E5%8A%A8%E7%9A%84%E5%8A%9F%E8%83%BD%E5%B7%A5%E4%BB%B6%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F**%E5%B9%B6%E9%9D%9E%E7%94%9F%E4%BA%A7%E5%B0%B1%E7%BB%AA%E7%9A%84%E8%AE%BE%E7%BD%AE**%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E4%B8%BASling%E7%9A%84%E5%AE%9E%E9%AA%8C%E5%92%8C%E5%AD%A6%E4%B9%A0%E6%8F%90%E4%BE%9B%E4%BE%BF%E5%88%A9%EF%BC%8C%E5%B8%AE%E5%8A%A9%E5%BC%80%E5%8F%91%E8%80%85%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BASling%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E3%80%82

核心功能和特性

• 多版本支持：提供多个稳定版本标签及开发快照标签，满足不同学习和实验需求。
• 存储后端支持：默认使用Oak SegmentStore（本地存储），同时支持MongoDB存储后端。
• 持久化配置：支持通过Docker卷挂载实现运行时数据持久化。
• 简单部署：仅需暴露8080端口即可快速启动，无需复杂配置。
• 可扩展性：支持通过添加自定义功能文件扩展Sling Starter功能。

使用场景和适用范围

• Sling学习与实验：适合开发者快速搭建Sling环境，学习Sling框架的基本使用和核心概念。
• 开发环境搭建：作为Sling应用开发的本地测试环境，验证应用功能。
• 功能验证：验证Sling相关功能或扩展在不同存储后端（本地存储、MongoDB）下的表现。

使用方法和配置说明

Docker镜像标签说明

支持以下标签，对应不同版本的Apache Sling Starter：

基本运行命令

Docker镜像仅需暴露8080端口即可启动：

bash
docker run --rm -p 8080:8080 apache/sling:snapshot

启动后可通过 http://localhost:8080 访问Sling。

存储后端配置

Oak SegmentStore（默认）

默认使用Oak SegmentStore（本地存储），无需额外配置，直接运行上述基本命令即可。

MongoDB支持

若需使用MongoDB存储后端，启动命令需指定聚合文件：

bash
docker run --rm -p 8080:8080 apache/sling:snapshot oak_mongo

注意：需确保MongoDB服务器已运行，默认连接URL为 mongodb://localhost:27017（可在功能文件中搜索 mongodb:// 查看具体配置）。

数据持久化配置

为避免容器重启后数据丢失，推荐将 /opt/sling/launcher 目录挂载为Docker卷：

1. 创建持久化卷：

bash
docker volume create sling-launcher

2. 使用卷启动容器：

bash
docker run --rm -p 8080:8080 -v sling-launcher:/opt/sling/launcher apache/sling:snapshot

构建Docker镜像

可通过Maven命令构建自定义Docker镜像，默认情况下Docker构建被跳过，需指定 -Ddocker.skip=false 参数：

bash
mvn clean package -Ddocker.skip=false -Ddocker.label=local

上述命令将构建标签为 apache/sling:local 的镜像，可通过以下命令运行：

bash
docker run --rm -p 8080:8080 apache/sling:local

扩展Sling Starter

若需扩展Sling Starter并排除应用级功能（如Composum、Slingshot等），可基于 nosample_base 聚合启动，该聚合包含：

• 所有基础功能
• Oak基础功能（不含NodeStore设置）
• 无应用程序

例如，启动带Segment持久化的空Sling Starter：

bash
target/dependency/org.apache.sling.feature.launcher/bin/launcher -f target/slingfeature-tmp/feature-nosample_base.json,target/slingfeature-tmp/feature-oak_persistence_sns.json

可在功能列表中添加自定义功能文件以扩展功能。

helper脚本

scripts 目录包含辅助脚本，简化Sling Starter外部工具的本地开发使用。