amd64/rapidoid

弃用通知

此镜像因缺乏活跃维护已被弃用（最后更新于2018年8月；https://github.com/docker-library/official-images/pull/4667%EF%BC%89%E3%80%82

如https://github.com/docker-library/official-images/pull/4667#issuecomment-565220107%E4%B8%AD%E6%89%80%E8%BF%B0%EF%BC%8C%E9%A2%84%E8%AE%A1%E5%9C%A8Rapidoid 6发布时可能会再次更新。

快速参考

• 维护者：
  https://github.com/rapidoid/docker-rapidoid

• 获取帮助：
  Docker社区论坛、Docker社区Slack或Stack Overflow

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

• https://github.com/rapidoid/docker-rapidoid/blob/8fbb45c706fec5b0a015a37c24862127180ae9e9/Dockerfile

![amd64/rapidoid构建状态徽章]([***]

快速参考（续）

• 问题提交地址：
  https://github.com/rapidoid/docker-rapidoid/issues

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

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

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

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

什么是Rapidoid？

Rapidoid是一个极快的HTTP服务器和现代Java Web框架/应用容器，专注于高生产力和高性能。

[***]

!https://raw.githubusercontent.com/docker-library/docs/7fc38a6e22991477a231ce556a7f2860623afb67/rapidoid/logo.png

如何使用此镜像

要快速启动Rapidoid并显示基本使用帮助，请运行：

console
$ docker run --rm amd64/rapidoid --help

Rapidoid可通过以下方式使用：

• 作为Web工具，从命令行快速原型化RESTful Web服务
• 作为HTTP服务器，提供静态资源服务
• 作为Java Web应用框架/容器，部署Web应用JAR

快速原型化SQL驱动的RESTful Web服务

要从命令行快速原型化SQL驱动的RESTful Web服务，需将数据库容器链接到Rapidoid容器。MySQL容器应通过名称mysql链接，PostgreSQL容器通过名称postgres链接。

以下示例启动一个新的MySQL容器，并在Rapidoid容器中以名称mysql链接，通过为路由GET /users指定SQL查询定义RESTful服务。该服务以JSON格式返回结果（MySQL用户列表）。

console
docker run -d --name some-mysql -e MYSQL_ROOT_PASSWORD=db-pass mysql

docker run -it --rm \
    -p 8888:8888 \
    --link some-mysql:mysql \
    rapidoid \
    profiles=mysql \
    jdbc.host=mysql \
    jdbc.password=db-pass \
    '/users <= SELECT user FROM mysql.user'

注意：请等待MySQL数据库初始化几秒钟，然后可在Web浏览器中访问http://localhost:8888/users（或http://your-host:8888/users）。

服务原型化参数语法：

console
'[GET|POST|PUT|DELETE|PATCH] <uri> <= <sql>'

提供静态文件服务

Rapidoid会自动从/app/static文件夹提供静态文件。要提供/your-www-root目录的内容，请将其挂载为/app/static：

console
$ docker run -it --rm \
    -p 8888:8888 \
    -v /your-www-root:/app/static \
    rapidoid

配置

Rapidoid会尝试从/app/config.yml读取配置。配置也可通过命令行参数或环境变量指定。

要为默认服务器和管理服务器配置自定义端口（默认8888），运行以下命令。如果未配置rapidoid-admin.port，默认服务器也会用作管理服务器，因此只会打开一个端口（rapidoid.port）。

console
$ docker run -it --rm \
    -p 4444:4444 \
    -p 9999:9999 \
    rapidoid \
    rapidoid.port=4444 \
    rapidoid-admin.port=9999 \
    app.services=ping \
    admin.services=status

然后可在Web浏览器中访问http://localhost:4444/_ping（或http://your-host:4444/_ping）和http://localhost:9999/_status（或http://your-host:9999/_status）。

相同设置可通过环境变量配置：

console
$ docker run -it --rm \
    -p 4444:4444 \
    -p 9999:9999 \
    -e RAPIDOID_PORT=4444 \
    -e RAPIDOID-ADMIN_PORT=9999 \
    rapidoid \
    app.services=ping \
    admin.services=status

更多详情，请参见完整的配置选项列表及其默认值。

安全

Rapidoid基于HMAC的安全令牌机制要求所有容器在扩展Web应用时共享相同的密钥：

console
$ docker run -it --rm \
    -p 8888:8888 \
    -e SECRET=your-secret-key \
    rapidoid

虽然这是快速入门的简单方法，但出于安全考虑，建议将密钥存储在/app/config.yml文件中，并设置适当的权限。

注意：生产环境中，必须将your-secret-key替换为真实的私有密钥。

注意：如果未指定密钥，将生成随机密钥，这在部署单个容器时是可接受的。

完整引导Rapidoid管理中心

要在Rapidoid中引导完整的管理中心，还需为内置admin用户配置密码：

console
$ docker run -d \
    --restart=always \
    -p 8888:8888 \
    -e SECRET=your-secret-key \
    -e USERS_ADMIN_PASSWORD=admin-pass \
    rapidoid \
    admin.services=center

请将admin-pass替换为admin用户的真实密码。然后可通过在Web浏览器中访问http://localhost:8888/_（或http://your-host:8888/_）登录管理中心。

注意：生产环境中，必须将your-secret-key替换为真实的私有密钥（请参见“安全”部分）。

如何扩展此镜像（应用JAR部署）

要将此镜像用作Web应用的基础镜像，只需将应用JAR添加为/app/app.jar：

dockerfile
COPY <location/of/your/webapp.jar> /app/app.jar

许可

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

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

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

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