このページは先行公開版です。内容は今後予告なく更新される可能性があります。

​
対応しているコンテナレジストリ

  • AWS ECR（AK/SK または IRSA）/ Azure ACR / Aliyun ACR / Tencent TCR / Dockerhub

​
コンテナレジストリが必要な理由

  • Dify Enterprise では、プラグインイメージの保存および管理のためにコンテナレジストリが必要です。
  • プラグインパッケージは Docker イメージではなく、コードとメタデータを含む圧縮ファイルです。
  • Kubernetes クラスター上で実行される際、プラグインパッケージは Docker イメージとしてビルドされるため、コンテナレジストリが必要です。

​
Helm チャートの値を表示

helm show values dify/dify

以下は、Helm チャートにおけるコンテナレジストリ設定の例です：

plugin_connector:
  imageRepoSecret: "image-repo-secret"
  imageRepoPrefix: "docker.io/your-image-repo-prefix"
  imageRepoType: docker
  ecrRegion: "us-east-1"

​
コンテナレジストリの設定方法

​
1. imageRepoSecret（必須）

Kubernetes の Secret として、レジストリ認証情報を保存します。

​
1.1 警告

この Secret の名前は image-repo-secret で固定されており、Dify デプロイ時に作成される必要があります。

​
1.2 以下のスクリプトを generate-image-repo-secret.sh として保存してください：

#!/bin/bash    

if [ "$#" -lt 3 ]; then
  echo "使用方法: $0 <username> <password> <k8s-namespace> <registry: optional>"
  echo "例: $0 myuser mypass default https://index.docker.io/v1/"
  exit 1
fi

USERNAME="$1"
PASSWORD="$2"
NAMESPACE="$3"
REGISTRY="${4:-https://index.docker.io/v1/}"
OUTPUT_FILE="./config.json"

AUTH=$(echo -n "$USERNAME:$PASSWORD" | base64 | tr -d '\n')

cat > "$OUTPUT_FILE" <<EOF
{
  "auths": {
    "$REGISTRY": {
      "auth": "$AUTH"
    }
  }
}
EOF

echo "Docker config.json を生成しました: $OUTPUT_FILE"

kubectl -n $NAMESPACE create secret generic image-repo-secret --from-file=.dockerconfigjson=$OUTPUT_FILE --from-file=config.json=$OUTPUT_FILE --type=kubernetes.io/dockerconfigjson

rm "$OUTPUT_FILE"

​
1.3 実行権限を付与：

chmod +x ./generate-image-repo-secret.sh

​
1.4 スクリプトを実行して Secret を作成：

# 例:
./generate-image-repo-secret.sh myuser mypass default https://index.docker.io/v1/

​
2. imageRepoPrefix（必須）

プラグインイメージをプッシュする際に使用する、リポジトリのプレフィックスです。

​
3. imageRepoType（必須）

使用するレジストリの種類：

  • docker（デフォルト）：Docker Hub または互換レジストリ
  • ecr：AWS ECR 用

​
4. ecrRegion（オプション）

ECR を使用する場合、AWS リージョンを指定します。

​
プラグイン Pod の Kubernetes スケジューリング設定

plugin_connector:
  nodeSelector: {}
  affinity: {}
  tolerations: []
  labels: {}
  • plugin_connector サービスの設定項目（nodeSelector、affinity、tolerations、labels）は、プラグイン用 Pod にも拡張適用されます。

​
国や地域によるネットワーク制限がある場合の設定方法

ネットワーク制限により docker.io にアクセスできない場合は、カスタムのイメージリポジトリを使用することができます。

plugin_connector:
  gatewayImage: "nginx:1.27.3"
  shaderImage: "gcr.io/kaniko-project/executor:latest"
  busyBoxImage: "busybox:latest"
  awsCliImage: "amazon/aws-cli:latest"
  generatorConf: |
    generator:
      repo: langgenius
      python:
        pipMirror: ""
        preCompile: true
        versions:
          python3.13:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.13
          python3.12:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.12
          python3.11:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.11
          python3.10:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.10
  1. 置き換えが必要なイメージ一覧：
  • gatewayImage: プラグインゲートウェイサービス用のイメージ
  • shaderImage: プラグインビルド時に使用される Shader イメージ
  • busyBoxImage: プラグイン実行時に使用される BusyBox イメージ
  • awsCliImage: AWS CLI 用のイメージ（AWS を使用しない場合は無視して構いません）
  • python3.xx: プラグインビルド時に使用される Python ベースのイメージ
  1. イメージをプライベートレジストリへ同期する方法

各種イメージをプライベートレジストリに同期する方法については、プライベートレジストリへのイメージ同期手順 をご参照ください。

このページは先行公開版です。内容は今後予告なく更新される可能性があります。

​
対応しているコンテナレジストリ

  • AWS ECR（AK/SK または IRSA）/ Azure ACR / Aliyun ACR / Tencent TCR / Dockerhub

​
コンテナレジストリが必要な理由

  • Dify Enterprise では、プラグインイメージの保存および管理のためにコンテナレジストリが必要です。
  • プラグインパッケージは Docker イメージではなく、コードとメタデータを含む圧縮ファイルです。
  • Kubernetes クラスター上で実行される際、プラグインパッケージは Docker イメージとしてビルドされるため、コンテナレジストリが必要です。

​
Helm チャートの値を表示

helm show values dify/dify

以下は、Helm チャートにおけるコンテナレジストリ設定の例です：

plugin_connector:
  imageRepoSecret: "image-repo-secret"
  imageRepoPrefix: "docker.io/your-image-repo-prefix"
  imageRepoType: docker
  ecrRegion: "us-east-1"

​
コンテナレジストリの設定方法

​
1. imageRepoSecret（必須）

Kubernetes の Secret として、レジストリ認証情報を保存します。

​
1.1 警告

この Secret の名前は image-repo-secret で固定されており、Dify デプロイ時に作成される必要があります。

​
1.2 以下のスクリプトを generate-image-repo-secret.sh として保存してください：

#!/bin/bash    

if [ "$#" -lt 3 ]; then
  echo "使用方法: $0 <username> <password> <k8s-namespace> <registry: optional>"
  echo "例: $0 myuser mypass default https://index.docker.io/v1/"
  exit 1
fi

USERNAME="$1"
PASSWORD="$2"
NAMESPACE="$3"
REGISTRY="${4:-https://index.docker.io/v1/}"
OUTPUT_FILE="./config.json"

AUTH=$(echo -n "$USERNAME:$PASSWORD" | base64 | tr -d '\n')

cat > "$OUTPUT_FILE" <<EOF
{
  "auths": {
    "$REGISTRY": {
      "auth": "$AUTH"
    }
  }
}
EOF

echo "Docker config.json を生成しました: $OUTPUT_FILE"

kubectl -n $NAMESPACE create secret generic image-repo-secret --from-file=.dockerconfigjson=$OUTPUT_FILE --from-file=config.json=$OUTPUT_FILE --type=kubernetes.io/dockerconfigjson

rm "$OUTPUT_FILE"

​
1.3 実行権限を付与：

chmod +x ./generate-image-repo-secret.sh

​
1.4 スクリプトを実行して Secret を作成：

# 例:
./generate-image-repo-secret.sh myuser mypass default https://index.docker.io/v1/

​
2. imageRepoPrefix（必須）

プラグインイメージをプッシュする際に使用する、リポジトリのプレフィックスです。

​
3. imageRepoType（必須）

使用するレジストリの種類：

  • docker（デフォルト）：Docker Hub または互換レジストリ
  • ecr：AWS ECR 用

​
4. ecrRegion（オプション）

ECR を使用する場合、AWS リージョンを指定します。

​
プラグイン Pod の Kubernetes スケジューリング設定

plugin_connector:
  nodeSelector: {}
  affinity: {}
  tolerations: []
  labels: {}
  • plugin_connector サービスの設定項目（nodeSelector、affinity、tolerations、labels）は、プラグイン用 Pod にも拡張適用されます。

​
国や地域によるネットワーク制限がある場合の設定方法

ネットワーク制限により docker.io にアクセスできない場合は、カスタムのイメージリポジトリを使用することができます。

plugin_connector:
  gatewayImage: "nginx:1.27.3"
  shaderImage: "gcr.io/kaniko-project/executor:latest"
  busyBoxImage: "busybox:latest"
  awsCliImage: "amazon/aws-cli:latest"
  generatorConf: |
    generator:
      repo: langgenius
      python:
        pipMirror: ""
        preCompile: true
        versions:
          python3.13:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.13
          python3.12:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.12
          python3.11:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.11
          python3.10:
            langgenius: docker.io/langgenius/plugin-build-base-python:3.10
  1. 置き換えが必要なイメージ一覧：
  • gatewayImage: プラグインゲートウェイサービス用のイメージ
  • shaderImage: プラグインビルド時に使用される Shader イメージ
  • busyBoxImage: プラグイン実行時に使用される BusyBox イメージ
  • awsCliImage: AWS CLI 用のイメージ（AWS を使用しない場合は無視して構いません）
  • python3.xx: プラグインビルド時に使用される Python ベースのイメージ
  1. イメージをプライベートレジストリへ同期する方法

各種イメージをプライベートレジストリに同期する方法については、プライベートレジストリへのイメージ同期手順 をご参照ください。