Couchbase Mobile アプリケーション開発：DockerによるSync Gateway環境構築

はじめに

Sync Gatewayのテスト・検証環境を構築するため、以下のソフトウェア/バージョンをDockerを使って構築する手順を紹介します。

• Couchbase Server Enterprise v6.5.x
• Sync Gateway Enterprise v2.8.x

Dockerネットワーク作成確認

Dockerコンテナーで環境を構築している場合は、Couchbase Serverも同じDockerネットワークで実行されている必要があります。

まだDockerネットワークが作成されていない場合は、作成します。ここでは、「workshop」という名前を用います。

$ docker network create -d bridge  workshop

利用するローカルDockerネットワークが存在していることを確認する場合は、次のコマンドを実行します。

$ docker network ls

Couchbase Server

Dockerイメージ取得

最初にDockerHubからDockerイメージを取得します。ターミナルから、以下を実行します。

$ docker pull couchbase/server-sandbox:6.5.0

Dockerコンテナ起動

次の方法でDockerコンテナを起動します。

$ docker run -d --name cb-server --network workshop -p 8091-8094:8091-8094 -p 11210:11210 couchbase/server-sandbox:6.5.0

Docker実行確認

次のコマンドを使用して、Dockerイメージが実行されていることを確認します。

$ docker ps

Dockerプロセスが開始されていても、サーバーが起動するまでに数秒かかる場合があります。

起動ログ確認

次のコマンドを実行すると、Couchbase Serverの起動ログを表示できます。

$ docker logs cb-server

実行確認：Web管理コンソールアクセス

• Couchbase　ServerのWeb管理コンソールを開きます。URLは、次の通りです：　　http://localhost:8091
• ユーザー名を「Administrator」、パスワードを「password」としてコンソールにログインします

Sync Gateway

Dockerイメージ取得

Docker　CloudからDockerイメージを取得します。

$ docker pull couchbase/sync-gateway:2.8.0-enterprise

Sync Gateway構成ファイルの編集

Sync Gatewayから、Couchbase　Serverに接続するために、サーバーのアドレスを指定する必要があります。

Couchbase Server Dockerコンテナを起動したときに設定した名前（例えば「cb-server」）により、既存の設定ファイルの値（例：「localhost」）を置き換えて構成ファイルを保存します。

"server": "couchbase://cb-server"

Dockerコンテナの起動

Sync Gateway構成ファイルを指定してSync Gatewayを起動します。

Sync Gateway構成ファイルを指定して、以下のようにコマンドを実行します。

ここでは、Sync Gateway構成ファイル（例：sync_gateway.json）が直下に含まれているフォルダ/ディレクトリからの実行例を示します。

Windowsでの実行方法

docker run -p 4984-4985:4984-4985 --network workshop --name sync-gateway -d -v %cd%/sync_gateway.json:/etc/sync_gateway/sync_gateway.json couchbase/sync-gateway:2.8.0-enterprise -adminInterface :4985 /etc/sync_gateway/sync_gateway.json

Windows以外のプラットフォームでの実行方法

$ cd c:\path\to\mobile-travel-sample\
$ docker run -p 4984-4985:4984-4985 --network workshop --name sync-gateway -d -v `pwd`/sync_gateway.json:/etc/sync_gateway/sync_gateway.json couchbase/sync-gateway:2.8.0-enterprise -adminInterface :4985 /etc/sync_gateway/sync_gateway.json

Dockerプロセス確認

ターミナルウィンドウで次のコマンドを使用して、「sync-gateway」という名前のDockerコンテナが実行されていることを確認します。

$ docker ps

起動ログ確認

次のコマンドを実行すると、いつでもログを表示できます。

$ docker logs sync-gateway

起動確認

ブラウザで下記のURLにアクセスします

以下のようなJSON応答が返されることを確認します

{"couchdb":"Welcome","vendor":{"name":"Couchbase Sync Gateway","version":"2.8"},"version":"Couchbase Sync Gateway/2.8.0(271;bf3ddf6) EE"}

参考情報