adrianrudnik/mjml-server

MJML Docker微服务/服务器

独立的MJML服务器，监听80/tcp端口。

由于各种挑战，此镜像具有以下特性：

• Docker环境下的干净快速关闭
• 简单的CORS功能
• 较小的体积（至少在npm层面）
• 支持健康检查

目录

• 概述
• 默认配置
• 开发环境
• 故障排除
  • Kubernetes

概述

此镜像启动一个简单的MJML服务器实例，默认监听80/tcp端口。

出于GDPR/DSGVO原因，需要将MJML实例置于自己的控制之下，因为邮件内容生成过程中会处理个人信息。

启动镜像非常简单，可通过Docker运行测试实例：

sh
docker run -it --rm -p 8080:80 mjml-server

或使用docker-compose，示例配置如下：

yml
version: '3.7'

services:
  mjml:
    image: adrianrudnik/mjml-server
    ports:
      - 8080:80
    # environment:
    # 如需更改端口：
    #   - PORT=8080
    # 开发环境下，取消以下行的注释：
    #   - CORS=*
    #   - MJML_KEEP_COMMENTS=true
    #   - MJML_VALIDATION_LEVEL=strict
    #   - MJML_MINIFY=false
    #   - MJML_BEAUTIFY=true

默认配置

在不进行任何覆盖的情况下，生产环境的默认配置如下：

sh
CORS ""
MJML_KEEP_COMMENTS "false"
MJML_VALIDATION_LEVEL "soft"
MJML_MINIFY "true"
MJML_BEAUTIFY "false"
HEALTHCHECK "true"
CHARSET="utf8"
DEFAULT_RESPONSE_CONTENT_TYPE="text/html; charset=utf-8"

开发环境

对于开发环境，建议将配置切换为：

sh
CORS "*"
MJML_KEEP_COMMENTS "true"
MJML_VALIDATION_LEVEL "strict"
MJML_MINIFY "false"
MJML_BEAUTIFY "true"
HEALTHCHECK "false"

这会将MJML代码中的任何问题记录到Docker日志中（stdout或docker-compose logs）。

故障排除

确保传递正确的Content-Type头，并将MJML作为原始请求体传递。

通过HTTP响应代码捕获错误。

Kubernetes

由于Kubernetes不支持Dockerfile中指定的默认HEALTHCHECK指令，您可能需要指定自己的探针：

spec:
  containers:
  - name: ...
    livenessProbe:
      exec:
        command:
        - curl - -X POST - 'http://localhost:80/'
      initialDelaySeconds: 30
      periodSeconds: 30
    readinessProbe:
      exec:
        command:
        - curl - -X POST - 'http://localhost:80/'
      initialDelaySeconds: 25

请注意，这仅检查连接性，端口可能会有所不同。如果还需要功能检查，可以采用类似于Docker中healthcheck.sh的方法。但我不是Kubernetes用户，如有更简洁的方法，欢迎提交PR。

Docker

如果您想依赖Makefile或构建多架构镜像，请确保已启用Docker的实验性功能，并可以使用docker buildx。

在我的Ubuntu 20.04工作站上的设置如下（基于上述文档）：

bash
# 为当前主机Linux系统上的默认节点安装其他平台支持
docker run --privileged --rm tonistiigi/binfmt --install all

# 创建一个使用默认节点的独立端点
docker buildx create --use mjml-server default

# 之后，可以使用类似以下命令进行本地构建
docker buildx build -f Dockerfile --platform linux/amd64,linux/arm64 -t [registry-and-tag] --push .

# ... 或者如果想在本地使用mjml-server标签
docker buildx build -f Dockerfile --platform linux/amd64,linux/arm64 -t mjml-server --load .