You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+38-30Lines changed: 38 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,64 +31,72 @@ The Taurus DockerFile and bash script run at start of the test to download the t
31
31
A NodeJS Lambda function used as a CloudFormation custom resource for configuring Amazon S3 bucket notifications and to send anonymous metrics.
32
32
33
33
**source/results-parser**<br/>
34
-
A NodeJS Lambda function used to write the xml output from the docker images to Amazon DynamoDB and generate the final results for each test.
34
+
A NodeJS Lambda function used to write the xml output from the docker images to Amazon DynamoDB and generate the final results for each test.
35
35
36
36
**source/task-runner**<br/>
37
-
A NodeJS Lambda function that Runs The Amaazon ECS task definition for each test.
37
+
A NodeJS Lambda function that runs the Amaazon ECS task definition for each test.
38
38
39
+
**source/task-status-checker**<br/>
40
+
A NodeJS Lambda function that checks if the Amaazon ECS tasks are running or not.
39
41
40
42
## Creating a custom build
41
-
The solution can be deployed through the CloudFormation template available on the solution home page: [Distributed Load Testing](https://aws.amazon.com/).
43
+
The solution can be deployed through the CloudFormation template available on the solution home page: [Distributed Load Testing](https://aws.amazon.com/solutions/implementations/distributed-load-testing-on-aws/).
42
44
To make changes to the solution, download or clone this repo, update the source code and then run the deployment/build-s3-dist.sh script to deploy the updated Lambda code to an Amazon S3 bucket in your account.
43
45
44
46
### Prerequisites:
45
47
*[AWS Command Line Interface](https://aws.amazon.com/cli/)
46
-
* Node.js 10.x or later
48
+
* Node.js 12.x or later
47
49
48
-
### 1. Running unit tests for customization
49
-
Run unit tests to make sure added customization passes the tests:
50
+
### 1. Clone the Distributed Load Testing on AWS solution repository
51
+
Clone the ```distributed-load-testing-on-aws``` GitHub repositroy, then make the desired code changes.
Run unit tests to make sure added customization passes the tests:
59
+
```bash
51
60
cd ./deployment
52
61
chmod +x ./run-unit-tests.sh
53
62
./run-unit-tests.sh
54
63
```
55
64
56
-
### 2. Create an Amazon S3 Bucket
57
-
The CloudFormation template is configured to pull the Lambda deployment packages from Amazon S3 bucket in the region the template is being launched in. Create a bucket in the desired region with the region name appended to the name of the bucket. eg: for us-east-1 create a bucket named: ```my-bucket-us-east-1```
65
+
### 3. Declare environment variables
66
+
```bash
67
+
export REGION=aws-region-code # the AWS region to launch the solution (e.g. us-east-1)
68
+
export DIST_OUTPUT_BUCKET=my-bucket-name # bucket where customized code will reside
69
+
export SOLUTION_NAME=my-solution-name
70
+
export VERSION=my-version # version number for the customized code
58
71
```
59
-
aws s3 mb s3://my-bucket-us-east-1
72
+
73
+
### 4. Create an Amazon S3 Bucket
74
+
The CloudFormation template is configured to pull the Lambda deployment packages from Amazon S3 bucket in the region the template is being launched in. Create a bucket in the desired region with the region name appended to the name of the bucket. eg: for us-east-1 create a bucket named: ```my-bucket-us-east-1```
> **Notes**: The _build-s3-dist_ script expects the bucket name as one of its parameters, and this value should not include the region suffix. In addition to that, the version parameter will be used to tag the npm packages, and therefore should be in the [Semantic Versioning format](https://semver.org/spec/v2.0.0.html).
70
87
88
+
### 6. Upload deployment assets to your Amazon S3 bucket
71
89
Deploy the distributable to the Amazon S3 bucket in your account:
* Get the link of the video-on-demand-on-aws.template uploaded to your Amazon S3 bucket.
78
-
* Deploy the Video on Demand to your account by launching a new AWS CloudFormation stack using the link of the video-on-demand-on-aws.template.
95
+
### 7. Launch the CloudFormation template.
96
+
* Get the link of the `distributed-load-testing-on-aws.template` uploaded to your Amazon S3 bucket.
97
+
* Deploy the Distributed Load Testing on AWS solution to your account by launching a new AWS CloudFormation stack using the link of the `distributed-load-testing-on-aws.template`.
79
98
80
99
***
81
100
82
-
Copyright 2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
83
-
84
-
Licensed under the Apache License, Version 2.0 (the "License");
85
-
you may not use this file except in compliance with the License.
86
-
You may obtain a copy of the License at
87
-
88
-
http://www.apache.org/licenses/LICENSE-2.0
89
-
90
-
Unless required by applicable law or agreed to in writing, software
91
-
distributed under the License is distributed on an "AS IS" BASIS,
92
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
93
-
See the License for the specific language governing permissions and
94
-
limitations under the License.
101
+
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.<br />
0 commit comments