s390x/jetty

注意：这是https://hub.docker.com/_/jetty%E7%9A%84%60s390x%60%E6%9E%B6%E6%9E%84%22per-architecture%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%EF%BC%8C%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链接

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

快速参考（续）

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

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

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

这会将容器内的8080端口映射为主机的80端口，容器的8443端口映射为主机的443端口。之后可通过浏览器访问http://host-ip或https://host-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 s390x/jetty --list-config

配置（如参数和其他模块）也可通过命令行传递。例如：

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

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

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

只读容器

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

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

许可

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

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

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

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