vertx/vertx3

Vert.x 3 镜像文档

镜像概述和主要用途

该Docker镜像用于在容器中运行Vert.x 3应用程序，是Vert.x 3栈的基础镜像。主要用途是作为应用镜像的基础，通过Docker的FROM指令扩展，以部署自定义的Vert.x 3应用。详细信息可参考https://github.com/vert-x3/vertx-stack/tree/master/stack-docker%E3%80%82

核心功能和特性

• 提供Vert.x 3运行环境，支持部署Verticle应用
• 可通过环境变量配置应用参数：
  • VERTICLE_HOME：指定verticles的存放路径
  • VERTICLE_NAME：指定要部署的verticle全类名
  • VERTX_OPTIONS：设置Vert.x运行选项
• 内置vertx命令行工具，可直接执行相关操作

使用场景和适用范围

适用于需要构建、部署和运行Vert.x 3应用程序的开发者，作为应用容器化部署的基础镜像，尤其适合微服务架构下的Vert.x应用打包。

使用方法和配置说明

扩展镜像（推荐方式）

该镜像设计为通过FROM指令扩展使用，以下是典型的Dockerfile示例：

dockerfile
FROM vertx/vertx3

# 设置verticles的存放路径
ENV VERTICLE_HOME /usr/verticles

# 设置要部署的verticle名称（全类名）
ENV VERTICLE_NAME io.vertx.example.HelloWorldVerticle

# 设置Vert.x运行选项
ENV VERTX_OPTIONS ""

###
# 以下部分通常无需修改
###

# 复制本地verticles到容器中
COPY ./verticles $VERTICLE_HOME

# 配置入口点（解决环境变量扩展问题）
ENTRYPOINT ["sh", "-c"]
CMD ["vertx run $VERTICLE_NAME -cp $VERTICLE_HOME/* $VERTX_OPTIONS"]

直接启动镜像（不推荐）

该镜像本身不包含应用程序，因此不建议直接启动。若需测试环境，可使用以下命令：

bash
docker run -i -t vertx/vertx3

Vert.x文件位于/usr/local/vert.x-VERSION/目录下（VERSION为具体版本号）。

可直接访问vertx命令行工具：

bash
docker run -i -t vertx/vertx3 vertx