Skip to content

Commit 7ca14b6

Browse files
authored
Merge pull request #1 from wangkuiyi/aws-yi
Rephrase the first paragraph
2 parents a1d94d5 + ef50887 commit 7ca14b6

File tree

1 file changed

+44
-27
lines changed

1 file changed

+44
-27
lines changed

doc/howto/usage/cluster/k8s-aws/README.md

Lines changed: 44 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,47 @@
1-
#PaddlePaddle on AWS with Kubernetes
2-
3-
##Prerequisites
4-
5-
First, you need an AWS account, please check out [this](http://docs.aws.amazon.com/lambda/latest/dg/setting-up.html) for how to setup an AWS account.
6-
7-
And then you can create an user by following [this](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) instruction, you shall create an user group with following privileges, and then add the user to that group:
8-
9-
<img src="managed_policy.png" width="800">
10-
11-
Those previleges are:
12-
13-
* AmazonEC2FullAccess
14-
* AmazonS3FullAccess
15-
* AmazonRoute53FullAccess
16-
* AmazonRoute53DomainsFullAccess
17-
* AmazonElasticFileSystemFullAccess
18-
* AmazonVPCFullAccess
19-
* IAMUserSSHKeys
20-
* IAMFullAccess
21-
* NetworkAdministrator
22-
23-
24-
If you located in China, we also recommend creating a tunnel server VM instance with default amazon AMI in the same available zone as your cluster and login to tunnel server for the following steps, otherwise there will be some issues related to account authentication.
25-
26-
27-
##PaddlePaddle on AWS
1+
# PaddlePaddle on AWS with Kubernetes
2+
3+
## Create AWS Account and IAM Account
4+
5+
To use AWS, we need to sign up an AWS account on Amazon's Web site.
6+
An AWS account allows us to login to the AWS Console Web interface to
7+
create IAM users and user groups. Usually, we create a user group with
8+
privileges required to run PaddlePaddle, and we create users for
9+
those who are going to run PaddlePaddle and add these users into the
10+
group. IAM users can identify themselves using password and tokens,
11+
where passwords allows users to log in to the AWS Console, and tokens
12+
make it easy for users to submit and inspect jobs from the command
13+
line.
14+
15+
To sign up an AWS account, please
16+
follow
17+
[this guide](http://docs.aws.amazon.com/lambda/latest/dg/setting-up.html).
18+
To create users and user groups under an AWS account, please
19+
follow
20+
[this guide](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).
21+
22+
Please be aware that this tutorial needs the following privileges in
23+
the user group:
24+
25+
- AmazonEC2FullAccess
26+
- AmazonS3FullAccess
27+
- AmazonRoute53FullAccess
28+
- AmazonRoute53DomainsFullAccess
29+
- AmazonElasticFileSystemFullAccess
30+
- AmazonVPCFullAccess
31+
- IAMUserSSHKeys
32+
- IAMFullAccess
33+
- NetworkAdministrator
34+
35+
36+
By the time we write this tutorial, we noticed that Chinese AWS users
37+
might suffer from authentication problems when running this tutorial.
38+
Our solution is that we create a VM instance with the default Amazon
39+
AMI and in the same zone as our cluster runs, so we can SSH to this VM
40+
instance as a tunneling server and control our cluster and jobs from
41+
it.
42+
43+
44+
## PaddlePaddle on AWS
2845

2946
Here we will show you step by step on how to run PaddlePaddle training on AWS cluster.
3047

0 commit comments

Comments
 (0)