はじめに

HandywedgeをDockerで利用するためにDockerコンテナのイメージを提供しています。

Dockerコンテナは2種類提供しており、Dockerコンテナのみで稼働させることのできるデータベースまでを含んだコンテナと、データベースは別の環境にありアプリケーションのみDockerコンテナで稼働させるためのデータベースを含まないイメージとなります。

また、データベースを含まないイメージを利用してAmazon ECSにて稼働させることもできます。

マイクロサービス

Handywedgeではアプリケーションコンテナとの連携はもちろん、単体でも利用可能なREST APIによるマイクロサービスのコンテナを提供しています。

提供しているマイクロサービスについては開発ガイドのアプリケーション共通サービスを参照してください。

Handywedge with Docker

Dockerインストール

docker import

Handywedgeのイメージファイルをインポートします。

サンプルアプリケーションはポート8080で開きます。

以下、handywedgeはリポジトリ名、masterはタグ名です。

docker import -c "CMD /usr/sbin/init" -c "ENV LANG=ja_JP.UTF-8" https://docker.handywedge.com/images/handywedge.tgz handywedge:master

docker run

docker runコマンドで、インポートしたイメージを元にDockerコンテナを起動します。

docker run --privileged -d -i -p 8080:8080 --name handywedge handywedge:master

アプリケーションを開く

docker exec

docker execでDockerコンテナに追加のプロセスを実行します。下記のコマンドでコンテナのbashを起動します。

docker exec -it handywedge /bin/bash

docker build

Dockerfleはここからダウンロードできます。

Dockerfileのあるディレクトリで作業してください。またはDockerfileのパスを記述してください。

docker build --rm -t handywedge:master ./

Handywedge with Docker(without database)

Dockerインストール

docker import/load

Handywedgeのイメージファイルおよびデータベースのイメージファイルをインポートします。

サンプルアプリケーションはポート8080で開きます。

以下、handywedge/without_dbはリポジトリ名、masterはタグ名です。

docker import -c "CMD /usr/sbin/init" -c "ENV LANG=ja_JP.UTF-8" https://docker.handywedge.com/images/without_db/handywedge.tgz handywedge/without_db:master

curl https://docker.handywedge.com/images/without_db/handywedge-postgres.tgz | docker load

docker network

docker networkコマンドで明示的にHandywedge用のdockerネットワークを作成し、本体コンテナとデータベースコンテナの通信がしやすいように設定します。

docker network create --subnet 172.20.0.0/16 handywedge-network

docker run

docker runコマンドで、インポートしたイメージを元にDockerコンテナを起動します。

docker run --net handywedge-network --ip 172.20.0.2 -d -i --name handywedge-postgres handywedge/without_db:postgres

docker run --net handywedge-network --ip 172.20.1.2 --privileged -d -i -p 8080:8080 --name handywedge handywedge/without_db:master

アプリケーションを開く

docker exec

docker execでDockerコンテナに追加のプロセスを実行します。下記のコマンドでコンテナのbashを起動します。

docker exec -it handywedge /bin/bash

docker build

Dockerfleはここからダウンロードできます。

データベースのDockerfleはここからダウンロードできます。

Dockerfileのあるディレクトリで作業してください。またはDockerfileのパスを記述してください。

docker build --rm -t handywedge/witout_db:master ./

docker build --rm -t handywedge/witout_db:postgres ./

Handywedge with Amazon ECS

AWSセットアップ

HandywedgeのイメージをAmazon ECSで利用するための手順を簡単にご紹介します。

Amazon ECSの詳細およびAWSを利用する環境がない場合はAWS開発者ガイドを参照してください。

イメージファイルの準備

Amazon ECRにイメージを登録するためにHandywedgeのイメージファイルをインポートします。

docker import -c "CMD /usr/sbin/init" -c "ENV LANG=ja_JP.UTF-8" https://docker.handywedge.com/images/without_db/handywedge.tgz handywedge/without_db:master

docker runコマンドで、インポートしたイメージを元にDockerコンテナを起動します。起動後、docker execでコンテナのbashを起動しデータベースの接続設定を行います。

docker run --privileged -d -i --name handywedge handywedge/without_db:master

docker exec -it handywedge /bin/bash

docker stopコマンドでコンテナを停止し、接続情報を書き換えた状態のコンテナをdocker commitコマンドでイメージを作成します。

docker stop handywedge

docker commit handywedge handywedge/without_db:ecs

開始までの流れ

イメージの準備ができたらこれ以降の詳細についてはAWS開発者ガイドを参照してください。

ここでは簡単な流れを説明します。

1. Amazon ECRにリポジトリを作成します。
2. 手順に従いイメージにタグを付けpushします。
3. クラスターを作成します。
4. タスクを定義します。※コンテナ追加時に特権付与します
5. タスクをEC2起動タイプで実行します。

マイクロサービス

Amazon S3バイナリーストア

HandywedgeのAmazon S3バイナリーストアのイメージの使い方を説明します。詳細については開発ガイドのアプリケーション共通サービスを参照してください。

Amazon S3バイナリーストアを利用するためには接続するための認証情報が必要になります。

docker load

HandywedgeのAmazon S3バイナリーストアイメージファイルをインポートします。

curl https://docker.handywedge.com/images/binarystore/aws/handywedge-binarystore-aws.tgz | docker load

docker run

docker runコマンドで、インポートしたイメージを元にDockerコンテナを起動します。

docker run -d -i -p 8082:8080 -e LOG_LEVEL=info -e AWS_ACCESS_KEY_ID=XXXXX -e AWS_SECRET_KEY=XXXXX --name handywedge-binarystore handywedge/binarystore/aws:master