arm32v5/jetty

注意：这是https://hub.docker.com/_/jetty%E7%9A%84%60arm32v5%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22%E6%AF%8F%E6%9E%B6%E6%9E%84%22%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84https://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/eclipse/jetty.docker

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

警告：此镜像在arm32v5架构上不受支持

快速参考（续）

• 提交issue的位置：
  https://github.com/eclipse/jetty.docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/jetty/%E3%80%81https://hub.docker.com/r/arm64v8/jetty/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/jetty%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/jetty%EF%BC%89
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fjetty
  https://github.com/docker-library/official-images/blob/master/library/jetty%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/jetty%EF%BC%89

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/jetty%EF%BC%88https://github.com/docker-library/docs/commits/master/jetty%EF%BC%89

什么是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)

!https://raw.githubusercontent.com/docker-library/docs/c14d620ba7dbd254b6a44f753ee1ba4e700906f0/jetty/logo.pngLogo © Eclipse Foundation

如何使用此镜像

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

console
$ docker run -d arm32v5/jetty

可通过浏览器访问http://容器IP:8080或https://容器IP:8443/进行测试。要将Jetty服务器暴露给外部请求，使用端口映射：

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

这会将容器内的8080端口映射为主机的80端口，容器的8443端口映射为主机的443端口。之后可通过浏览器访问http://主机IP或https://主机IP。

环境变量

镜像中的默认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的旧版已终止支持的镜像，请遵循Eclipse Wiki上的旧版说明，将应用部署在/usr/local/jetty/webapps而非/var/lib/jetty/webapps。

配置

可通过运行带有--list-config选项的命令查看Jetty服务器配置：

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

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

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

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

Dockerfile
FROM arm32v5/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 arm32v5/jetty

只读容器

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

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

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

HTTP/2支持

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

Dockerfile
FROM arm32v5/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 arm32v5/jetty

许可证

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

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

一些能够自动检测到的额外许可证信息可在https://github.com/docker-library/repo-info/tree/master/repos/jetty%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

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