Skip to content

Commit 4c295c7

Browse files
authored
Merge pull request aws-samples#325 from aws-samples/cloud9-development
rewrote the AWS CLI instructions
2 parents a9326c1 + 7943c93 commit 4c295c7

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

cloud9-development/readme.adoc

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@
66

77
This tutorial will walk you through the process of creating a Kubernetes development environment using https://aws.amazon.com/cloud9/[AWS Cloud9]. This will provide you with a cloud-based integrated development environment (IDE) that will let you write, run and debug containerized workloads with just a web browser.
88

9-
=== Create Cloud9 Environment
10-
==== Option 1: Cloud9 Console
11-
1. Log into the Cloud9 Console by visiting https://console.aws.amazon.com/cloud9/home/create
9+
=== Create AWS Cloud9 Environment
10+
==== Option 1: AWS Cloud9 Console
11+
1. Log into the AWS Cloud9 Console by visiting https://console.aws.amazon.com/cloud9/home/create
1212

1313
2. Provide a name for your environment. Feel free to use something simple, such as `kubernetes-developmet`. Then click "Next Step".
1414

@@ -29,27 +29,29 @@ Your environment is now ready to be setup for working with Kubernetes and the re
2929

3030
=== Setup Environment
3131

32-
Your Cloud9 environment comes with many useful tools preinstalled, but there are still a few tweaks to these and additional tools you will need to support working with Kubernetes.
32+
Your AWS Cloud9 environment comes with many useful tools preinstalled, but there are still a few tweaks to these and additional tools you will need to support working with Kubernetes.
3333

3434
==== Configure the AWS CLI
3535

36-
Your Cloud9 environment comes with the AWS CLI preinstalled and configured to automatically use the credentials of the currently logged in user. **It is not recommended that you change this.** Instead, it is recommended that the logged in user's account is provided the permissions needed to make the required calls for the rest of this workshop.
36+
Your AWS Cloud9 environment comes with the AWS CLI preinstalled and configured to automatically use the credentials of the currently logged in user.
3737

38-
In the event that you want do not want to use the currently logged in user for these credentials, there are a couple options:
38+
.Please Note
39+
*********************
40+
It is not recommended that you change the default AWS CLI config in your AWS Cloud9 environment. Instead, it is recommended that you provide the logged in user's account the permissions needed to make the required for your project. More information on this can be found by visiting: https://docs.aws.amazon.com/cloud9/latest/user-guide/credentials.html[Calling AWS Services from an Environment in AWS Cloud9]
41+
*********************
3942

40-
1. Instance Profile: You can create an Instance Role with the proper permissions and add that role to the ec2 instance hosting your environment
41-
2. Use the AWC Configure command or environmental variables to permanently store credentials for the AWS CLI.
43+
For the sake of this workshop, we are going to configure the AWS CLI on your AWS Cloud9 environment using the AWS Configure command. For this, use the same credentials you created in the "Create admin user and group" section of the https://github.com/aws-samples/aws-workshop-for-kubernetes/blob/master/prereqs.adoc[Prerequesites] page.
4244

43-
For instructions on these two options, visit https://docs.aws.amazon.com/cloud9/latest/user-guide/credentials.html[Calling AWS Services from an Environment in AWS Cloud9].
45+
$ aws configure
46+
AWS Access Key ID [None]: *****
47+
AWS Secret Access Key [None]: *****
48+
Default region name [None]: eu-central-1
49+
Default output format [None]:
4450

45-
Regardless of your option above, this workshop is designed to be run from the Ireland region (`eu-central-1`). As such, you will need to to ensure any calls made through the CLI specify the Ireland region and not the default region for your Cloud9 environment (which will likely be us-west-2 or us-east-1). To do this, you can:
46-
47-
* Include the `--region=eu-central-1` option in any of the workshops requests.
48-
* Temporarily override the CLI's default region using the following environmental variable: `export AWS_DEFAULT_REGION=eu-central-1`. Please note that this will only persist for the duration of your session.
4951

5052
==== Verify Docker Version
5153

52-
Docker is presinstalled. You can verify the version by running the following:
54+
Docker is preinstalled. You can verify the version by running the following:
5355

5456
docker --version
5557

0 commit comments

Comments
 (0)