事前に awscli 、 awsebcli 、git コマンドのインストールが必要です。
pip install --user "awscli==1.11.51"
pip install --user "awsebcli==3.9.0"
brew install git
下記のバージョンで動作確認しています。
aws --version
# -> aws-cli/1.11.51
eb --version
# -> EB CLI 3.9.0
git --version
# -> git version 2.11.1
※dockerの最新版をインストールしている場合、awsebcliの最新版と依存ライブラリの衝突がおきるかもしれません。その場合awsebcliのバージョンを下げるなどの対応が必要です。
以下の手順では、下記の変数を使います。必要に応じて変更してください。
# 作成するアプリケーションの名前
export APP_NAME="elastic-beanstalk-workshop"
# 作成する環境の名前
export ENV_NAME="workshop-1"
# 環境に設定する環境変数
export ENVVARS="PASSENGER_APP_ENV=production,RDS_HOSTNAME=db"
# 起動するインスタンスタイプ（もっと小さくても起動できますが、デプロイやプロビジョニングに時間がかかります）
export INSTANCE_TYPE="t2.medium"
# インスタンスに設定されるキーペア
export KEY_PAIR_NAME="jawsdays2017-eb-workshop-keypair"
# 作成するアプリケーションの種類
export PLATFORM="Multi-container Docker 1.12.6 (Generic)"
# アクセスキーのプロファイル名
export PROFILE="private"
# 利用するリージョン
export REGION="ap-northeast-1"
# 作業ディレクトリ
export WORK_DIR="~/path/to/workdir"
利用するIAMユーザに、 AWSElasticBeanstalkFullAccess 権限を付与してください。
アクセスキーを発行し、 awscliに設定します。
aws configure --profile=${PROFILE}
設定を確認します。
aws configure list --profile=${PROFILE}
キーペアを作成して保存します。
aws ec2 create-key-pair \
--profile=${PROFILE} \
--region=${REGION} \
--key-name=${KEY_PAIR_NAME} \
--query=KeyMaterial \
--output=text \
> ~/.ssh/${KEY_PAIR_NAME}.pem
パーミッションを変更します。（Windowsの方は不要かもしれません）
chmod 600 ~/.ssh/${KEY_PAIR_NAME}.pem
（必要であれば）作業ディレクトリ作成し、リポジトリをクローンします。
mkdir -p ${WORK_DIR}
cd ${WORK_DIR}
git clone https://github.com/akirakoyasu/elastic-beanstalk-workshop.git
cd elastic-beanstalk-workshop
アプリケーションを作成します。
eb init ${APP_NAME} \
--profile=${PROFILE} \
--region=${REGION} \
--keyname=${KEY_PAIR_NAME} \
--platform="${PLATFORM}"
環境を作成してデプロイします。
eb create ${ENV_NAME} \
--envvars=${ENVVARS} \
--instance_type=${INSTANCE_TYPE}
上記はデフォルトVPCを利用する設定になっています。
歴史のあるアカウント（"EC2-Classic"）の場合にはデフォルトVPCが存在しない可能性があります。その場合はインスタンスタイプとして m3.medium を指定してみてください。
デフォルトVPCの設定を変更していたり、削除していたりするとうまく動作しない可能性があります。その場合は今まで利用したことのないリージョンを指定してみてください。
作成済みの環境にもう一度デプロイする場合は、下記コマンドを実行します。
eb deploy ${ENV_NAME}
非GUI環境では利用できません。ブラウザでアプリケーションのURLを開きます。
eb open ${ENV_NAME}
インスタンスにSSHログインします。（Windowsの方は環境によって失敗する可能性があります。その場合はSSHクライアントで接続してください）
eb ssh ${ENV_NAME}
（インスタンス内） プロセスを確認してみましょう。
ps auxfwww
（インスタンス内） 各コンテナのログは下記の場所に書き出されるように設定してあります。
ls -l /var/log/containers
（インスタンス内） コンテナ内でbashを起動します。
# web
sudo docker exec -it $(sudo docker ps --filter label=eb.workshop.role=web -q) bash -l
# app
sudo docker exec -it $(sudo docker ps --filter label=eb.workshop.role=app -q) bash -l
# db
sudo docker exec -it $(sudo docker ps --filter label=eb.workshop.role=db -q) bash -l
（インスタンス内） コンテナからログアウトします。
exit
一度デプロイしたアプリケーションはバージョン管理されています。
バージョンの一覧を確認します。
eb appversion
以前のバージョンをデプロイします。
eb deploy --version=${VERSION_LABEL}
環境を破棄します。
eb terminate ${ENV_NAME}
アプリケーションを破棄して、すべてのバージョンを削除します。
eb terminate --all
IAM、インスタンスプロファイル、サービスロールに必要な権限は下記の通りです。
インスタンスプロファイルのデフォルトは aws-elasticbeanstalk-ec2-role 、サービスロールのデフォルトは aws-elasticbeanstalk-service-role となっています。
- IAM policy:
AWSElasticBeanstalkFullAccess
http://docs.aws.amazon.com/ja_jp/elasticbeanstalk/latest/dg/AWSHowTo.iam.managed-policies.html - instance profile: aws-elasticbeanstalk-ec2-role
AWSElasticBeanstalkWebTier + AWSElasticBeanstalkMulticontainerDocker
http://docs.aws.amazon.com/ja_jp/elasticbeanstalk/latest/dg/iam-instanceprofile.html - service role: aws-elasticbeanstalk-service-role
AWSElasticBeanstalkEnhancedHealth + AWSElasticBeanstalkService
http://docs.aws.amazon.com/ja_jp/elasticbeanstalk/latest/dg/iam-servicerole.html
アカウントでリージョン毎にサポートされているEC2のプラットフォームが異なります。歴史のあるアカウントの場合は"EC2-Classic"の場合があります。
aws ec2 scribe-account-attributes --attribute-names=supported-platforms
EC2-Classic or EC2-VPC http://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/using-vpc.html
ローカル環境でDockerを動かして、コンテナを起動させる設定も書いておきました。 下記のバージョンで動作確認しています。
docker --version
# -> Docker version 1.13.1
docker-compose --version
# -> docker-compose version 1.11.1
コンテナを起動します。
docker-compose up -d
コンテナ内でbashを起動します。
docker-compose exec web bash -l
docker-compose exec app bash -l
docker-compose exec db bash -l
コンテナを破棄します。（ボリュームも同時に破棄します）
docker-compose down --volumes
今回のコンテナを構築するにあたって、設定した手順に沿ってタグを打っておきました。
git tag
よろしければ下記アンケートにご回答ください。 https://emotion-tech.net/ZoFqDxfG