deliveroo/translations

deliveroo/translations 镜像文档

镜像概述

deliveroo/translations 是一个辅助镜像，旨在为项目构建过程提供 Phraseapp 翻译文件的自动下载与集成功能。通过在项目 Dockerfile 中添加简单指令，即可将 Phraseapp 管理的翻译文件下载并添加到项目构建镜像的指定位置，简化多语言项目的翻译文件管理流程。

核心功能

• 一键集成：提供单行 Dockerfile 指令，可直接集成到现有项目构建流程中，无需复杂配置
• 翻译文件下载：自动根据项目中的 .phraseapp.yml 配置文件，从 Phraseapp 平台下载最新翻译文件
• 文件整理：将下载的翻译文件统一放置于镜像内的 /artefacts 目录，便于项目直接引用

使用场景

适用于使用 Phraseapp 管理多语言翻译文件的 Deliveroo 项目，特别是需要在 Docker 镜像构建阶段自动获取最新翻译内容，确保项目镜像包含最新语言资源的场景。

使用方法与配置说明

前置条件

1. 项目根目录下需存在有效的 .phraseapp.yml 配置文件（Phraseapp 配置文件，用于指定翻译项目 ID、文件导出格式、输出路径等参数）
2. 构建环境中需配置 PHRASEAPP_ACCESS_TOKEN 环境变量（Phraseapp 访问令牌，用于授权翻译文件的下载请求，可从 Phraseapp 账户设置中获取）

Dockerfile 集成步骤

在项目 Dockerfile 中添加以下指令，将翻译文件从 deliveroo/translations 镜像复制到当前项目镜像的工作目录：

dockerfile
COPY --from=deliveroo/translations:latest /artefacts .

配置说明

• 环境变量要求：必须确保构建环境中存在 PHRASEAPP_ACCESS_TOKEN，该令牌用于通过 Phraseapp API 鉴权，获取翻译文件访问权限
• 配置文件要求：.phraseapp.yml 需正确配置翻译项目相关信息，具体配置规范可参考 Phraseapp 官方文档

使用示例

若项目需将翻译文件下载至 ./locales 目录，完整 Dockerfile 集成示例如下：

dockerfile
# 项目构建阶段
FROM docker.xuanyuan.run/some-base-image AS builder
# 复制项目文件
COPY . .
# 从 translations 镜像复制翻译文件到当前项目的 locales 目录
COPY --from=deliveroo/translations:latest /artefacts ./locales
# 执行后续构建步骤
...

注：确保在构建过程中通过 --build-arg 或环境变量注入 PHRASEAPP_ACCESS_TOKEN，例如：docker build --build-arg PHRASEAPP_ACCESS_TOKEN=your_token .