[JAWS-UG CLI] ELB:#2 インスタンスの追加



前提条件
========


ELBへの権限
-----------

ELBに対してフル権限があること。


EC2への権限
-----------

EC2に対してフル権限があること。


AWS CLIのバージョン
-------------------

以下のバージョンで動作確認済

* AWS CLI 1.10.63

```bash:コマンド:
aws --version
```

```text:結果(例):
      aws-cli/1.10.63 Python/2.7.11 Darwin/15.6.0 botocore/1.4.53
```

バージョンが古い場合は最新版に更新しましょう。

```bash:コマンド:
sudo -H pip install -U awscli
```


AWSアカウントの属性
-------------------

AWSアカウントがEC2-Classicに対応していないこと。

```bash:コマンド:
AWS_SUPPORT_PLATFORMS=$( \
         aws ec2 describe-account-attributes \
           --query 'AccountAttributes[?AttributeName == `supported-platforms`].AttributeValues[].AttributeValue' \
           --output text \
) && echo ${AWS_SUPPORT_PLATFORMS}
```

```text:結果:
      VPC
```

'VPC'の他に'EC2'が表示される場合、別のアカウントを作成もしくは利用して
ください。


デフォルトVPCの存在
-------------------

デフォルトVPCが存在すること。

```bash:コマンド:
VPC_ID=$( \
        aws ec2 describe-vpcs \
          --filters Name=isDefault,Values=true \
          --query 'Vpcs[].VpcId' \
          --output text \
) \
        && echo ${VPC_ID}
```

```text:結果(例):
      vpc-xxxxxxxx
```


0. 準備
=======


0.1. リージョンの決定
---------------------

```bash:変数の設定:
AWS_DEFAULT_REGION='ap-northeast-1'
```


0.2. 変数の確認:
----------------

プロファイルが想定のものになっていることを確認します。

```bash:変数の確認:
aws configure list
```

```text:結果(例):
            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       ec2elb_full-prjZ-mbp13        env    AWS_DEFAULT_PROFILE
      access_key     ****************XXXX shared-credentials-file
      secret_key     ****************XXXX shared-credentials-file
          region        ap-northeast-1        env    AWS_DEFAULT_REGION
```


0.3. ロードバランサ名の指定
---------------------------

```bash:変数の設定:
ELB_LB_NAME='lb-handson-20160912'
```


1. 事前作業
===========


1.1. 登録するインスタンスの指定
-------------------------------

稼動しているEC2インスタンスを確認します。

```bash:変数の設定:
EC2_INSTANCE_STATUS='running'
```

```bash:コマンド:
aws ec2 describe-instances \
        --filters Name=instance-state-name,Values=${EC2_INSTANCE_STATUS} Name=vpc-id,Values=${VPC_ID} \
        --query 'Reservations[].Instances[].InstanceId'
```

```text:結果(例):
      [
        i-xxxxxxxx
      ]
```

ロードバランサに登録するインスタンスを指定します。

```bash:変数の設定:
ARRAY_EC2_INSTANCES='< 登録するインスタンス 例:i-xxxxxxxx >'
```


2. インスタンスの登録
=====================

```bash:変数の確認:
cat << ETX

        ELB_LB_NAME:         ${ELB_LB_NAME}
        ARRAY_EC2_INSTANCES: ${ARRAY_EC2_INSTANCES}

ETX
```

```bash:コマンド:
aws elb register-instances-with-load-balancer \
        --load-balancer-name ${ELB_LB_NAME} \
        --instances ${ARRAY_EC2_INSTANCES}
```

```text:結果(例):
      {
        "Instances": [
          {
              "InstanceId": "i-xxxxxxxx"
          }
        ]
      }
```

確認します。

```bash:コマンド:
aws elb describe-load-balancers \
        --load-balancer-names ${ELB_LB_NAME} \
        --query 'LoadBalancerDescriptions[].Instances[].InstanceId'
```

```text:結果(例):
      [
        "i-xxxxxxxx"
      ]
```


3. 事後作業
===========


3.1. ヘルスチェック
-------------------

```bash:コマンド:
aws elb describe-instance-health \
        --load-balancer-name ${ELB_LB_NAME}
```

```text:結果(例):
      {
        "InstanceStates": [
          {
              "InstanceId": "i-xxxxxxxx",
              "ReasonCode": "N/A",
              "State": "InService",
              "Description": "N/A"
          }
        ]
      }
```


3.2. アクセス確認
-----------------

バランサのDNS名にブラウザでアクセスします。

nginxの画面が表示されればOKです。

```bash:コマンド:
ELB_DNS_NAME=$( \
        aws elb describe-load-balancers \
          --load-balancer-names ${ELB_LB_NAME} \
          --query 'LoadBalancerDescriptions[].DNSName' \
          --output text \
) \
        && echo ${ELB_DNS_NAME}
```

```text:結果(例):
      lb-handson-20160912-xxxxxxxxx.ap-northeast-1.elb.amazonaws.com
```


完了
====