メインコンテンツへ移動

LibreOffice による形式変換

性能と適用範囲について

Word から PDF への変換には LibreOffice エンジンを使用します。リソースを多く消費する処理のため、CPU、メモリ、ディスク I/O、ファイルサイズ、文書の複雑さなどによって、変換性能が大きく変動します。

サービスの安定性を確保するため、ldoc を独立してデプロイする場合は、同時変換数を CPU の物理コア数以下に抑え、余裕を確保してください。上限の目安は CPU の物理コア数 - 2 を推奨します。たとえば、8コア（8C）のサーバーでは、同時に実行する変換タスクを6つ以下（8 - 2 = 6）にします。

実際の同時実行数の上限は、業務で使用する文書サンプルによる十分な負荷テストと容量評価を行ったうえで決定してください。

1. LibreOffice のデプロイ​

インストールと設定の詳細は、LibreOffice サービスのデプロイを参照してください。

2. LibreOffice による PDF 変換を有効にする​

app サービスの environment に次の設定を追加し、サービスを再起動します。

app:
  environment:
    ENV_PDF_CONVERT_TYPE: "libreoffice" # 追加：LibreOffice による PDF 変換を有効化
ENV_HAP_INTRANET_CROSS_ENDPOINT の設定場所

ENV_HAP_INTRANET_CROSS_ENDPOINT はファイルサービスから HAP マイクロサービスへアクセスするために使用し、次の場合のみ設定します。

ENV_HAP_INTRANET_CROSS_ENDPOINT: "192.168.0.10:8880"

単一ノード Docker Compose（ファイルサービスを独立してデプロイする場合）では、/data/mingdao/script/docker-compose.yaml の app.environment に追加します。

Kubernetes クラスターでは、/data/mingdao/script/kubernetes/config.yaml の env-list ConfigMap の data に追加します。

192.168.0.10:8880 は、ファイルサービスからアクセスできる HAP マイクロサービスの内部ネットワークアドレスに置き換えてください。

単一ノード Docker Compose の完全な変更例を表示
version: '3'

services:
  app:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-hap:7.5.3
    environment: &app-environment
      ENV_ADDRESS_MAIN: "https://hap.domain.com"
      ENV_APP_VERSION: "7.5.3"
      ENV_API_TOKEN: "******"
      ENV_PDF_CONVERT_TYPE: "libreoffice" # 追加：LibreOffice による PDF 変換を有効化
    ports:
      - 8880:8880
    volumes:
      - ./volume/data/:/data/
      - ../data:/data/mingdao/data

  sc:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-sc:3.2.0
    environment:
      <<: *app-environment
    volumes:
      - ./volume/data/:/data/

  command:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-command:node1018-python36

  doc:
    image: registry.cn-hangzhou.aliyuncs.com/mdpublic/mingdaoyun-doc:2.0.0