Apache Karaf Container 4.x - Documentation

• 语言: 英语
• 格式: .pdf
• 来源: downloads.apache.org

摘要

文档介绍了Apache Karaf 4.x容器的核心功能与使用指南。它是一个基于OSGi的多态应用容器，支持Apache Felix或Eclipse Equinox框架，提供热部署、完整控制台、动态配置、高级日志、基于JAAS的安全框架（含RBAC）、SSH远程访问、JMX管理及多实例管理。快速入门部分描述了Java SE 8或更高版本的先决条件，以及启动服务器、使用Shell控制台、部署示例应用、停止和清理状态的基本步骤。从3.x升级到4.x的更新说明涵盖了发行版格式（tar.gz/zip）、命令变更（如新增feature:requirement-list等）、特性仓库（如mvn:org.apache.karaf.features/standard/4.0.x/xml/features）、新特性解析器（自动检查并安装所需bundle）、命名空间版本更新（如karaf-features-1.3.0.xsd）以及Maven插件目标的清理（如karaf:archive、karaf:assembly等）。目录结构包括bin、etc、data、deploy、lib和system等关键目录。

AI总结

Apache Karaf 4.x 是一个基于 OSGi 的现代多态应用容器，轻量、企业级，支持微服务、系统集成和大数据等场景。它可在独立或嵌入式模式下运行，支持热部署、完整的 Unix 风格控制台、动态配置、高级日志、基于 Maven 的 provisioning（通过 Karaf Features）、JMX 管理、SSH 远程访问、基于 JAAS 的 RBAC 安全机制，以及多实例管理，默认使用 Apache Felix 框架，可切换至 Equinox。

**快速启动**：需 Java SE 8 或更高版本。下载后启动服务器，通过控制台可部署示例应用（如 Apache Camel），使用 `feature:install` 命令安装，应用文件放入 `deploy` 目录即可热部署。停止 Karaf 可输入 `^D` 或执行 `system:shutdown`（或 `halt` 命令）。删除 `data` 目录可重置容器到干净状态。

**从 3.x 升级到 4.x 的注意事项**：
- **分发**：提供 tar.gz 和 zip 格式，内容相同，支持 Unix 和 Windows。
- **命令**：新增了 `feature:requirement-list/add/remove`、`jaas:group-*`、`shell:edit/env` 等命令。
- **Features 仓库**：提供了 enterprise、framework、spring、standard、static 等新的 features XML。
- **Features 解析器**：全新解析器，支持检查 feature 需求并自动安装所需 bundle，仅对使用 1.3.0 命名空间的新风格 feature 生效。
- **命名空间**：更新了 features、jaas、shell 的 XSD 版本。
- **Maven 插件**：`karaf-maven-plugin` 提供了 `archive`、`assembly`、`kar`、`verify`、`run`、`client`、`deploy` 等目标。
- **升级指南**：建议全新安装。若升级现有容器，需更新 `lib` 和 `system` 文件夹，`etc` 文件夹需对比差异（属性有变更，新增配置）。

**用户指南**：
- **安装**：可从二进制分发版安装或从源码构建。
- **目录结构**：`bin`（控制脚本）、`etc`（配置文件）、`data`（工作目录，含缓存和日志）、`deploy`（热部署目录）、`lib`（库文件）、`system`（OSGi bundle 仓库）。
- **启动/停止/重启**：支持前台（带/不带控制台）、后台和系统服务模式。