ppc64le/jetty

注意：这是https://hub.docker.com/_/jetty%E7%9A%84%60ppc64le%60%E6%9E%B6%E6%9E%84%E4%B8%93%E5%B1%9E%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%80%83%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%8CFAQ%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链接

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

快速参考（续）

• 提交问题地址：
  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/
• 镜像 artifact 详情：
  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基金会旗下的免费开源项目，被Apache ActiveMQ、Alfresco、Apache Geronimo、Apache Maven、Apache Spark、Google App Engine、Eclipse、FUSE、***流API和Zimbra等产品采用，也是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 ppc64le/jetty

可通过浏览器访问http://容器IP:8080或https://容器IP:8443/测试。若需向外部暴露服务，使用端口映射：

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

此命令将容器内8080端口映射到主机80端口，443端口映射到主机443端口，之后可通过http://主机IP或https://主机IP访问。

环境变量

镜像中的默认Jetty环境变量：

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

部署Web应用

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

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

配置

查看配置

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

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

命令行配置

可通过命令行传递参数或添加模块，例如：

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

派生镜像配置

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

Dockerfile
FROM ppc64le/jetty

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

模块可通过编辑/var/lib/jetty/start.d/*.ini文件配置，或删除该文件停用模块。

JVM配置

通过JAVA_OPTIONS环境变量设置JVM选项，例如设置最大堆内存为1GB：

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

只读容器

要以只读模式运行ppc64le/jetty，让Docker创建/tmp/jetty和/run/jetty作为卷：

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

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

HTTP/2支持

从9.3版本开始，Jetty内置HTTP/2支持，但因ALPN库的许可兼容性问题，模块默认未启用。若需在派生镜像中启用HTTP/2（私人使用），可添加RUN命令启用http2模块并批准许可：

Dockerfile
FROM ppc64le/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启用，将--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 ppc64le/jetty

许可

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

与所有Docker镜像一样，此镜像可能包含其他许可下的软件（如基础发行版的Bash等，以及主软件的直接或间接依赖）。

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

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