[JAWS-UG CLI] VPC #10 IGWの作成、アタッチ

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


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

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


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

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

- AWS CLI 1.11.14

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

結果(例):

      aws-cli/1.11.19 Python/2.7.10 Darwin/15.6.0 botocore/1.4.76

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

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


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

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

結果:

      VPC


0. 準備
=======


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

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


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

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

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

結果(例):

            Name                    Value             Type    Location
            ----                    -----             ----    --------
         profile       ec2as_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. VPCの指定
--------------

既存のVPCに割り当てられているCIDRブロックを確認します。

```bash:コマンド:
aws ec2 describe-vpcs \
        --query 'Vpcs[].CidrBlock'
```

結果(例):

      [
        "172.31.0.0/16",
        "10.192.0.0/16"
      ]

ここでは、10.192.0.0/16を範囲とするVPCを選択します。

```bash:変数の設定:
VPC_CIDR='10.192.0.0/16'
```

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

## 1.1. VPC IDの取得

VPC IDを取得します。

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

結果(例):

      vpc-xxxxxxxx




1.2. IGWの確認
--------------

まだアタッチされていないIGWが存在しないことを確認します。

```bash:コマンド:
aws ec2 describe-internet-gateways \
        --query 'InternetGateways[?Attachments == `[]`]'
```

結果(例):

      []


2. IGWの作成
============

```bash:コマンド:
aws ec2 create-internet-gateway 
```

結果(例):

      {
        "InternetGateway": {
          "Tags": [],
          "InternetGatewayId": "igw-xxxxxxxx",
          "Attachments": []
        }
      }

```bash:コマンド:
aws ec2 describe-internet-gateways \
        --query 'InternetGateways[?Attachments == `[]`]'
```

結果(例):

      {
        "InternetGateway": {
          "Tags": [],
          "InternetGatewayId": "igw-xxxxxxxx",
          "Attachments": []
        }
      }


3. IGWのアタッチ
================


3.1. IGW IDの取得
-----------------

```bash:コマンド:
VPC_IGW_ID=$( \
        aws ec2 describe-internet-gateways \
          --query 'InternetGateways[?Attachments == `[]`].InternetGatewayId' \
          --output text \
) \
        && echo ${VPC_IGW_ID}
```

結果(例):

      igw-xxxxxxxx


3.2. IGWのアタッチ
------------------

VPCにIGWをアタッチします。

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

        VPC_IGW_ID: ${VPC_IGW_ID}
        VPC_ID:     ${VPC_ID}

ETX
```

```bash:コマンド:
aws ec2 attach-internet-gateway \
        --internet-gateway-id ${VPC_IGW_ID} \
        --vpc-id ${VPC_ID}
```

結果(例):

      (戻り値なし)

```bash:変数の設定:
ARRAY_VPC_IGW_IDS="${VPC_IGW_ID}" \
        && echo ${ARRAY_VPC_IGW_IDS}
```

```bash:コマンド:
aws ec2 describe-internet-gateways \
        --internet-gateway-ids ${ARRAY_VPC_IGW_IDS}
```

結果(例):

      {
        "InternetGateway": {
          "Tags": [],
          "InternetGatewayId": "igw-xxxxxxxx",
          "Attachments": [
              {
                  "State": "available",
                  "VpcId": "vpc-xxxxxxxx"
              }
          ]
        }
      }


完了
====