i386/jetty

注意：这是 https://hub.docker.com/_/jetty 的 i386 架构构建的"每架构"仓库——更多信息，请参见官方镜像文档中的 https://github.com/docker-library/official-images#architectures-other-than-amd64 和官方镜像FAQ中的 https://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链接

警告：此镜像在 i386 架构上不被支持

快速参考（续）

• 问题提交地址：
  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 i386/jetty

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

console
$ docker run -d -p 80:8080 -p 443:8443 i386/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的旧版EOL镜像，请遵循Eclipse Wiki上的旧版说明，并部署在 /usr/local/jetty/webapps 而非 /var/lib/jetty/webapps。

配置

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

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

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

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

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

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

只读容器

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

console
$ docker run -d --read-only -v /tmp/jetty -v /run/jetty i386/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 i386/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 i386/jetty

许可

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

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

一些能够自动检测到的其他许可信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/jetty%E4%B8%AD%E3%80%82

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