semtech/static-file-service

static-file-service

static-file-service 是一个微服务，用于从 /data 目录托管静态文件，支持单页应用部署及灵活的配置扩展。

开始使用

将服务添加到您的栈

在 docker-compose.yml 中添加以下片段，将静态文件服务包含到项目中：

yaml
static-file:
  image: semtech/static-file-service:0.2.0
  volumes:
    - ./data/static-files:/data

添加请求调度规则

在 dispatcher.ex 中添加规则，将请求转发到静态文件服务。例如：

  get "/assets/*path" do
    Proxy.forward conn, path, "http://static-file/assets/"
  end

操作指南

如何构建托管Ember应用的镜像

在Ember应用根目录添加以下Dockerfile：

FROM madnificent/ember:3.22.0 as builder

LABEL maintainer="john.doe@example.com"

WORKDIR /app
COPY package.json .
RUN npm install
COPY . .
RUN ember build -prod

FROM semtech/static-file-service:0.2.0

COPY --from=builder /app/dist /data

如何自定义Nginx配置

文件由Nginx托管，默认配置极简，可通过挂载自定义配置扩展。将命名格式为 *.conf 的自定义Nginx配置文件挂载到 /config 目录，会自动包含在 server 块中。

示例配置

设置30秒缓存

location / {
    add_header Cache-Control "max-age=30, must-revalidate";
}

启用GZIP压缩

gzip on;
gzip_types application/json application/vnd.api+json application/javascript text/css;

启用基本认证

location / {
    auth_basic "Static file service";
    auth_basic_user_file /config/.htpasswd;
}

如何使用环境变量在运行时配置Ember应用

服务可通过环境变量在运行时配置Ember前端构建，通常用于环境特定（开发、生产、测试等）配置。服务启动时，前缀为 EMBER_ 的环境变量将用于替换 /data/index.html 中匹配的占位符值。

在Ember应用中配置占位符

在Ember配置文件 ./config/environment.js 中，使用 {{占位符名称}} 格式标记需要运行时替换的值。例如：

javascript
if (environment === 'production') {
    ENV.torii.providers['oauth2'].apiKey = '{{OAUTH_API_KEY}}'
}

在static-file服务上设置环境变量

在 docker-compose.yml 中为static-file服务配置环境变量，环境变量需以 EMBER_ 为前缀。例如，要替换占位符 {{OAUTH_API_KEY}}，需配置环境变量 EMBER_OAUTH_API_KEY：

yaml
services:
  static-file:
    environment:
      EMBER_OAUTH_API_KEY: "my-api-key-for-production"