From 036d2d99a2335975ddac57cae2186f66d5b94acd Mon Sep 17 00:00:00 2001 From: Troy Fontaine Date: Tue, 15 Mar 2016 18:10:04 -0500 Subject: [PATCH] Updated docs for AWS Signed-off-by: Troy Fontaine --- docs/drivers/aws.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/drivers/aws.md b/docs/drivers/aws.md index 1658b740a8..fd0b147697 100644 --- a/docs/drivers/aws.md +++ b/docs/drivers/aws.md @@ -26,9 +26,9 @@ One way to configure credentials is to use the standard credential file for Amaz aws_access_key_id = AKID1234567890 aws_secret_access_key = MY-SECRET-KEY -You can learn more about the credentials file from this [blog post](http://blogs.aws.amazon.com/security/post/Tx3D6U6WSFGOK2H/A-New-and-Standardized-Way-to-Manage-Credentials-in-the-AWS-SDKs). +On Mac OS or various flavors of Linux you can install the AWS Command Line Interface (aws cli) in the terminal and use the `aws configure` command which guide you through the creation of the credentials file. For more information about getting started, visit the [AWS CLI documentation](http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration). -This is the simplest case, you can then create a new machine with: +This is the simplest method, you can then create a new machine with: $ docker-machine create --driver amazonec2 aws01 @@ -152,6 +152,14 @@ To create a machine with a non-default vpc-id: This example assumes the VPC ID was found in the `a` availability zone. Use the`--amazonec2-zone` flag to specify a zone other than the `a` zone. For example, `--amazonec2-zone c` signifies `us-east1-c`. +## VPC Connectivity +Machine uses ssh to complete the set up of instances in EC2 and requires the ability to access the instance directly. + +If you use the flag `--amazonec2-private-address-only`, you will need to ensure that you have some method of accessing the new instance from within the internal network of the VPC (e.g. a corporate VPN to the VPC, a VPN instance inside the VPC or using Docker-machine from an instance within your VPC). + +## VPC Set up +Configuration of VPCs is beyond the scope of this guide, however the first step in troubleshooting is ensuring if you are using private subnets that you follow best practices and have some form of NAT available so that the set up process can access the internet to complete set up. + ## Custom AMI and SSH username The default SSH username for the default AMIs is `ubuntu`.