> For AI agents: the complete documentation index is available at /resource/ucidm/docs/on-premise/1.8.0/llms.txt, the full documentation bundle is available at /resource/ucidm/docs/on-premise/1.8.0/llms-full.txt.

# UCIDM パッケージ アップデート時の移行作業

UCIDM パッケージ のアップデート時に必要となる作業について記載しています。

### 1.7.0 (2025-05-02) から 1.8.0 (2025-10-14) へアップデートするときに必要となる作業

#### コンテナの環境変数からデータベースのシステム設定への移行 \{#migrate-environment-variables}

[UCIDM API](/resource/ucidm/docs/on-premise/1.8.0/configuration/ucidm-api.md) と [Agent モジュール](/resource/ucidm/docs/on-premise/1.8.0/configuration/agent/index.md) のサービス設定の環境変数をシステム設定へ移行する必要があります。

詳細は弊社のサポート担当者にご確認ください。

#### RabbitMQ 接続設定の変更 \{#migrate-rabbitmq-env}

コンテナをアップグレードするときに compose サービスが停止した状態で compose.yml (ucidm.env) の環境変数を移行します。

[UCIDM API](/resource/ucidm/docs/on-premise/1.8.0/configuration/ucidm-api.md) と [外部連携モジュール](/resource/ucidm/docs/on-premise/1.8.0/configuration/destination/index.md) のサービス設定の環境変数を次のように変更する必要があります。

```diff
    environment:
-      AMQP_URL: "${AMQP_URL}"
+      RABBITMQ_USER: "${RABBITMQ_USER}"
+      RABBITMQ_PASSWORD: "${RABBITMQ_PASSWORD}"
+      RABBITMQ_HOST: "${RABBITMQ_HOST}"
```

#### MongoDB コンテナイメージのリポジトリ変更 \{#migrate-mongodb-repo}

[Upcoming changes to the Bitnami catalog (effective August 28th, 2025)](https://github.com/bitnami/containers/issues/83267) により、[MongoDB](/resource/ucidm/docs/on-premise/1.8.0/configuration/mongodb.md) のコンテナイメージを取得するリポジトリを `bitnamilegacy/mongodb` へ変更する必要があります。

```diff
  mongo:
-   image: docker.io/bitnami/mongodb:8.0.3
+   image: docker.io/bitnamilegacy/mongodb:8.0.3
```

### 1.5.0 (2025-01-10) から 1.7.0 (2025-05-02) へアップデートするときに必要となる作業

#### bind mounts volume ディレクトリ配下の owner/permission の変更 \{#migrate-bind-mounts-volume}

compose サービスを停止します。

```
$ docker compose down
```

compose.yml の mongo サービスから `user: root` を削除する。

```diff
  mongo:
    container_name: mongo
-   user: root
    image: docker.io/bitnamilegacy/mongodb:8.0.3
```

コンテナ内のアプリケーションを uid=1001 のユーザーが実行するように変更されたため、そのホスト上でのディレクトリやファイルの owner/permission を変更する必要があります。

subuid の設定を確認します。

```
$ cat /etc/subuid
ucidm:100000:65536
```

subuid が 100000 からマッピングする設定の場合はホスト上では uid=101000 (100000 + 1001 - 1) としてマッピングされます。compose.yml を配置している次の3つのディレクトリの owner/permission を変更します。

- mongodb
- agent-data
- server-data

```
$ rootlesskit chown -R 1001:0 mongodb server-data agent-data
```

compose サービスを開始して正常に動作することを確認します。

```
$ docker compose up -d
```