---
lang: ja-jp
breaks: true
---
# COCO Annotator を Docker（Windows上）で使用する方法 2025-01-28

> Getting Started
> https://github.com/jsbroks/coco-annotator/wiki/Getting-Started

## COCO AnnotatorをDocker（Windows上）で使用する方法は以下の通りです:

### 1. 準備:
- Dockerがインストールされていることを確認します。
- Git for Windowsをインストールします。

### 2. COCO Annotatorのインストール:
- コマンドプロンプトを開き、任意のディレクトリに移動します。
- 以下のコマンドを実行してリポジトリをクローンします:

     git clone https://github.com/jsbroks/coco-annotator

- クローンしたディレクトリに移動します:

     cd coco-annotator

### 3. Docker Composeの実行:
- 以下のコマンドを実行してコンテナを起動します:

     docker-compose up

- 初回実行時はイメージのダウンロードと構築に時間がかかります。

### 4. アプリケーションへのアクセス:
- ブラウザを開き、`http://localhost:5000` にアクセスします。
- http://localhost:5000
- 初回アクセス時は、ユーザー名とパスワードを登録してログインします。

### 5. 使用開始:
- ログイン後、データセットの作成やアノテーションの作業を開始できます。
- 公式に利用方法が記載されています。
https://github.com/jsbroks/coco-annotator/wiki/Usage

### 6. 使用終了：
- 以下のコマンドを実行してコンテナを終了します:

     docker-compose down

### 注意点:
- Windows環境でmakeコマンドが必要な場合は、別途インストールが必要です。
- ポート5000が他のアプリケーションで使用されている場合は、docker-compose.ymlファイルでポート番号を変更する必要があります。

これらの手順に従うことで、WindowsでDocker上でCOCO Annotatorを使用できます。

## データセットを保存する場所を任意の場所に変更する方法

### `docker-compose.yml` を修正する。

services:
  webserver:
・・・
    volumes:
      - "./../xxxxxxxx/datasets:/datasets"
      - "./models:/models"
・・・
  workers:
・・・
    volumes:
      - "./../xxxxxxxx/datasets:/datasets"
・・・

:::info
Web UIよりデータセットの作成を行うと、`./../xxxxxxxx/datasets:/datasets`～ に作成したデータセット名でディレクトリが作成される。
:::

## `git clone` で落としてきたソースモジュールからDockerを起動する方法

docker-compose -f docker-compose.dev.yml up

* アプリケーションのURLは以下

    http://localhost:8080/

* 停止する場合は以下

    docker-compose -f docker-compose.dev.yml down

## COCO Annotator のデータベースをバックアップする方法

* コンテナから直接mongodbデータをダンプ

    # コンテナから直接mongodbデータをダンプ
    docker exec -it annotator_mongodb mongodump --out /data/db/backup

    # ホストにコピー 
    docker cp annotator_mongodb:/data/db/backup ./mongodb_backup

* MongoDBバックアップを復元

    # 1. ホストのバックアップをコンテナにコピー
    docker cp ./mongodb_backup annotator_mongodb:/data/db/backup_to_restore

    # 2. コンテナで復元を実行
    docker exec -it annotator_mongodb mongorestore /data/db/backup_to_restore

    # 3. アプリケーションの再起動
    docker-compose -f docker-compose.dev.yml restart    

* トラブルシューティング

    # MongoDBログの確認
    docker logs annotator_mongodb

    # データベースの接続確認
    docker exec -it annotator_mongodb mongo

:::warning
注意事項
* 復元前にアプリケーションを停止することを推奨
* 既存データは上書きされる
* バックアップデータの整合性を確認
* 復元後アプリケーションの動作確認が必要
:::

###### tags: `アノテーションツール` `COCO Annotator` `Docker`