arm32v7/jetty Docker 镜像 - 轩辕镜像

注意：这是jetty官方镜像的arm32v7构建版本的“每架构”仓库——更多信息，请参见官方镜像文档中的“除amd64外的架构？”[[]]和官方镜像FAQ中的“镜像的源代码在Git中已更改，现在该怎么办？”[[]]。

快速参考

• 维护者：Docker社区
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow
• 支持的标签及对应Dockerfile链接： 警告：此镜像在arm32v7架构上不被支持
• 提交问题：[***]
• 支持的架构：(更多信息) amd64、arm64v8
• 镜像 artifact 详情：repo-info仓库的repos/jetty/目录（历史记录）（包含镜像元数据、传输大小等）
• 镜像更新：official-images仓库的library/jetty标签、official-images仓库的library/jetty文件（历史记录）
• 本描述的来源：docs仓库的jetty/目录（历史记录）

什么是Jetty？

Jetty是基于纯Java的HTTP（Web）服务器和Java Servlet容器。虽然Web服务器通常用于向用户提供文档，但Jetty现在常被用于机器间通信，通常在大型软件框架中。Jetty作为Eclipse基金会的免费开源项目开发。该Web服务器被用于Apache ActiveMQ、Alfresco、Apache Geronimo、Apache Maven、Apache Spark、Google App Engine、Eclipse、FUSE、***的Streaming API和Zimbra等产品。Jetty也是Lift、Eucalyptus、Red5、Hadoop和I2P等开源项目的服务器。Jetty支持最新的Java Servlet API（含JSP支持）以及SPDY和WebSocket协议。

***.org/wiki/Jetty_(web_server)

!logoLogo © Eclipse Foundation

如何使用此镜像

运行默认Jetty服务器

要在后台运行默认Jetty服务器，使用以下命令：

console
$ docker run -d arm32v7/jetty

可通过浏览器访问[***]或[***]进行测试。要将Jetty服务器暴露给外部请求，使用端口映射：

console
$ docker run -d -p 80:8080 -p 443:8443 arm32v7/jetty

这会将容器内的8080端口映射到主机的80端口，容器内的8443端口映射到主机的443端口。之后可通过浏览器访问[***]或[***]。

环境变量

镜像中的默认Jetty环境如下：

• JETTY_HOME = /usr/local/jetty
• JETTY_BASE = /var/lib/jetty
• TMPDIR = /tmp/jetty

部署应用

Web应用可通过常规方式（WAR文件、解压的WAR目录或上下文XML文件）部署在/var/lib/jetty/webapps下。要将应用部署到/上下文，使用名称ROOT.war、目录名ROOT或上下文文件ROOT.xml（不区分大小写）。

对于基于Jetty 7或Jetty 8的旧版EOL镜像，请遵循Eclipse Wiki上的旧版说明，并部署到/usr/local/jetty/webapps而非/var/lib/jetty/webapps。

配置服务器

可通过运行--list-config选项查看Jetty服务器配置：

console
$ docker run -d arm32v7/jetty --list-config

也可通过命令行传递配置参数和附加模块。例如：

console
$ docker run -d arm32v7/jetty --module=jmx jetty.threadPool.maxThreads=500

要在派生Docker镜像中更新服务器配置，Dockerfile可通过RUN命令启用附加模块：

Dockerfile
FROM arm32v7/jetty

RUN java -jar "$JETTY_HOME/start.jar" --add-to-startd=jmx,stats

模块可在Dockerfile中通过编辑/var/lib/jetty/start.d/*.ini文件中的属性进行配置，或通过删除该文件停用模块。

JVM配置

可通过向容器传递JAVA_OPTIONS环境变量设置JVM选项。例如，将最大堆大小设置为1GB：

console
$ docker run -e JAVA_OPTIONS="-Xmx1g" -d arm32v7/jetty

只读容器

要以只读容器运行arm32v7/jetty，需让Docker将/tmp/jetty和/run/jetty目录创建为卷：

console
$ docker run -d --read-only -v /tmp/jetty -v /run/jetty arm32v7/jetty

由于容器是只读的，需通过-v /path/to/my/webapps:/var/lib/jetty/webapps挂载webapps目录，或在派生镜像中填充/var/lib/jetty/webapps。

HTTP/2支持

从9.3版本开始，Jetty内置HTTP/2支持。但由于实现HTTP/2的ALPN库可能存在许可证兼容性问题，该模块默认未启用。要在派生Dockerfile中为私人使用启用HTTP/2支持，可添加RUN命令启用http2模块并批准其许可证：

Dockerfile
FROM arm32v7/jetty

RUN java -jar $JETTY_HOME/start.jar --add-to-startd=http2 --approve-all-licenses

这会在$JETTY_BASE/start.d目录添加http2.ini文件，并将所需ALPN库下载到$JETTY_BASE/lib/alpn，从而允许使用HTTP/2。HTTP/2连接应通过与普通HTTPS连接相同的端口（容器端口8443）进行。若要通过$JETTY_BASE/start.ini启用http2模块，将上述RUN命令中的--add-to-startd替换为--add-to-start。

安全注意事项

默认情况下，此镜像以root用户启动，并使用Jetty的setuid模块在初始化后降权为jetty用户。JETTY_BASE目录（/var/lib/jetty）归jetty:jetty（uid 999，gid 999）所有。

若要让镜像直接以jetty用户而非root启动，可使用-u jetty启动容器：

console
$ docker run -d -u jetty arm32v7/jetty

许可证

查看此镜像中包含软件的许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他软件，可能受其他许可证约束（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

部分能够自动检测到的附加许可证信息可在repo-info仓库的jetty/目录中找到。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。