导出为 PDF 本地化安装

# 支持的技术

应用程序默认情况下以 Docker 镜像的形式提供。

它可以在任何开放容器运行时工具（例如 Kubernetes、OpenShift、Podman、Docker 和许多其他工具）中运行。

有关运行导出为 PDF 本地化的硬件和软件要求的更多信息，请参阅 要求指南。

# 使用 Kubernetes 和 Helm 图表设置应用程序

使用提供的 Helm 图表设置导出为 PDF 本地化。
您可以在 我们的存储库 中找到更多说明和 Helm 图表。

# 使用 Docker 容器设置应用程序

1. 使用 CKEditor 生态系统客户仪表板 中的说明登录到导出为 PDF 本地化（PDF 转换器）Docker 存储库并拉取 Docker 镜像。

2. 使用 docker 或 docker-compose 对应用程序进行容器化。

3. 使用演示页面验证应用程序是否正常运行。

# 使用 docker 的容器化示例

启动 Docker 容器

docker run --init -p 8080:8080 -e LICENSE_KEY=[your_license_key] docker.cke-cs.com/pdf-converter:[version]

如果您要使用授权，则应提供 SECRET_KEY

docker run --init -p 8080:8080 -e LICENSE_KEY=[your_license_key] -e SECRET_KEY=[your_secret_key] docker.cke-cs.com/pdf-converter:[version]

您可以在 授权 部分中了解有关使用授权的更多信息。

# 使用 docker-compose 的容器化示例

1. 创建 docker-compose.yml 文件

version: "3.8"
  services:
    image: docker.cke-cs.com/pdf-converter:[version]
      ports:
        - "8080:8080"
      restart: always
      init: true
      environment:
        LICENSE_KEY: your_license_key
        # Secret Key is optional
        SECRET_KEY: secret_key
        # Custom request origin is optional
        CUSTOM_REQUEST_ORIGIN: https://your_custom_origin

有关 SECRET_KEY 用法的详细信息，请查看 授权 部分。

2. 运行

docker-compose up

# 说明

• 如果没有正确的 LICENSE_KEY，应用程序将无法启动。如果许可证无效，您将在日志中看到 Wrong license key 错误，并且应用程序将无法运行。
• 出于安全原因，您应使用唯一且难以猜测的字符串覆盖 SECRET_KEY 变量。
• 如果您的基础设施启用了严格的 CORS，则可以使用 CUSTOM_REQUEST_ORIGIN 变量设置转换器发出的请求的来源。默认值为 https://pdf-internal。

# Windows 字体支持

如果您想在 PDF 文件中使用 Calibri、Verdana 等 Windows 字体，您可以使用 pdf-converter-windows Docker 镜像并在 Windows 操作系统上运行它。

有关更多详细信息，请参阅 字体 部分。

# 后续步骤

使用 http://localhost:8080/v1/convert 端点导出 PDF 文件。查看 授权 部分以了解有关令牌和令牌端点的更多信息。

您还可以使用 http://localhost:8080/demo 上提供的演示页面生成示例 PDF 文件。

有关更多详细信息，请参阅 http://localhost:8080/docs 上的导出为 PDF REST API 文档。