Amazon Web Services¶

認証ファイルの設定¶

[default]
aws_access_key_id = AKID1234567890
aws_secret_access_key = MY-SECRET-KEY

$ docker-machine create --driver amazonec2 aws01

$ docker-machine create --driver amazonec2 --amazonec2-access-key AKI******* --amazonec2-secret-key 8T93C*******  aws01

$ export AWS_ACCESS_KEY_ID=AKID1234567890
$ export AWS_SECRET_ACCESS_KEY=MY-SECRET-KEY
$ docker-machine create --driver amazonec2 aws01

オプション¶

• --amazonec2-access-key : 必須 自分の Amazon Web Services API 用のアクセス・キー緒です。
• --amazonec2-secret-key : 必須 自分の Amazon Web Services API 用のシークレット・アクセスキーです。
• --amazonec2-session-token : 自分の Amazon Web Services API 用のセッション・トークンです。
• --amazonec2-ami : インスタンスに使用する AMI ID です。
• --amazonec2-region : インスタンスを起動するリージョンです。
• --amazonec2-vpc-id : 必須** 起動したインスタンスを置く VPC ID です。
• --amazonec2-zone : インスタンスを置く AWS ゾーンです（例： a, b, c, d, e のいずれか）。
• --amazonec2-subnet-id : AWS VPC サブネット ID です。
• --amazonec2-security-group : AWS VPC セキュリティ・グループ名です。
• --amazonec2-tags : AWS タグをキーバリューのペアで指定します（カンマ区切りです。例： key1,value1,key2,value2）。
• --amazonec2-instance-type: 実行するインスタンス・タイプです。
• --amazonec2-device-name: 実行するデバイス名です。
• --amazonec2-root-size : インスタンスのルート・ディスク容量（単位：GB）。
• --amazonec2-volume-type: インスタンスにアタッチする Amazon EBS の種類を指定。
• --amazonec2-iam-instance-profile : インスタンスのプロフィールに使われる AWS IAM ロール名。
• --amazonec2-ssh-user : SSH ログイン・ユーザ名です。ここには AMI が使うデフォルトの SSH ユーザを一致する必要があります。
• --amazonec2-request-spot-instance : スポット・インスタンスを使用。
• --amazonec2-spot-price : スポット・インスタンスの bid 価格（単位：ドル）。 --amazonec2-request-spot-instance フラグが必要です。
• --amazonec2-use-private-addressce : docker-machine の通信にプライベート IP アドレスを使います。ですがパブリックな IP アドレスも作成されます。
• --amazonec2-private-address-only : プライベート・アドレスのみ使います。
• --amazonec2-monitoring : CloudWatch モニタリングを有効化します。
• --amazonec2-user-ebs-optimized-instance : EBS 最適化インスタンスを作成します。インスタンス・タイプが対応している必要があります。
• --amazonec2-ssh-keypath : インスタンス用のプライベート・キーに使うファイルのパスを指定します。対応する公開鍵の拡張子は .pub になっている必要があります。

環境変数とデフォルト値は以下の通りです。

デフォルト AMI¶

デフォルトでは、Amazon EC2 ドライバは Ubuntu 15.10 LTS の daily イメージを使います。

セキュリティ・グループ¶

セキュリティ・グループが作成され、ホストに関連付けられるのでご注意ください。セキュリティ・グループは以下のインバウンド通信を許可します。

• ssh (22/tcp)
• docker (2376/tcp)
• swarm (3376/tcp) ノードが Swarm マスタの場合のみです

これポート以外にポートを開くには、 --amazonec2-security-group フラグを使って自分でセキュリティ・グループを指定し、ポートが開かれたか確認します。特定のアプリケーションが必要とするポートを開きたい場合は、AWS コンソールで設定を調整ください。

VPC ID¶

コマンドを実行する前に、自分のデフォルト VPC を確認します。時々、デフォルトの VPC がなかったり、あるいはデフォルトの VPC を使いたくない場合があるでしょう。VPC を指定するには --amazonec2-vpc-id フラグを使います。

VPC ID を確認するには：

1. AWS コンソールにログインします。
2. Services -> VPC -> VPC -> 自分の VPC に移動します。
3. VPC 列から使用する VPC ID を選びます。
4. Services -> VPC -> Subnets に移動します。 Availability Zones 列を確認し、ゾーン a が存在しているのと、自分の VPC ID と一致していることを確認します。

例えば、 us-east-1-a にはアベイラビリティ・ゾーン a が存在しています。もし a ゾーンが表示されなければ、マシンを作成するために、新しいサブネットを作成するか別のゾーンを指定します。

マシン・インスタンスを作成するには、 --driver amazonec2 と３つの必須パラメータを指定します。

$ docker-machine create --driver amazonec2 --amazonec2-access-key AKI******* --amazonec2-secret-key 8T93C********* --amazonec2-vpc-id vpc-****** aws01

この例では、 VPC ID が a アベイラビリティ・ゾーンに存在しているものと想定されます。 a ゾーン以外を指定するには、 --amazonec2-zone フラグを使います。例えば、 --amazonec2-zone c は us-east1-c を表しています。

カスタム AMI と SSH ユーザ名¶

デフォルト AMI 用のデフォルト SSH ユーザ名は ubuntu です。

カスタム AMI が異なった SSH ユーザ名を使っている場合、この SSH ユーザ名の設定を変更する必要があります。

--amazonec2-ami で指定した AMI が必要とする SSH ユーザ名を --amazonec2-ssh-user で指定します。