Skip to content

Commit 40b1884

Browse files
author
Eric Cornwell
committed
Readme, added new arch diagram
1 parent 17ded40 commit 40b1884

10 files changed

+11
-13
lines changed

README.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -34,28 +34,26 @@ This guidance will:
3434

3535
### Architecture Diagram
3636

37-
<!-- ![](docs/media/gs-workflow-arch.png "Architecture Diagram") -->
3837
<div align="center">
39-
<img src="assets/gs-workflow-arch-new.jpg" width=70%>
38+
<img src="assets/images/gs-workflow-arch.PNG" width=70%>
4039
<br/>
4140
<i>Figure 1: 3D Reconstruction Toolbox for Gaussian Splats on AWS Reference Architecture </i>
4241
</div>
4342

4443
### Architecture Steps
45-
46-
1. System administrator deploys guidance to AWS account and region using AWS Cloud Development Kit or Terraform.
47-
2. Once guidance is deployed in a specific AWS account and region, an authenticated user uploads the necessary configuration and input media into a dedicated Amazon Simple Storage Service (S3) bucket location. This can be done using a Gradio interface and AWS Software Development Kit (SDK).
48-
3. Optionally, the guidance supports external job submission by uploading a ‘.json’ job configuration file and media into a designated S3 bucket location. This upload process could be manual through the AWS Management Console or could also be an external process depending on the use-case.
49-
4. The job json file upload to the bucket location will trigger an Amazon Simple Notification Service (SNS) message that will invoke an initialization AWS Lambda function.
44+
1. User authenticates to AWS Identity and Access Management (IAM) via AWS Tools and SDKs.
45+
2. The configuration and input media is uploaded to a dedicated Amazon Simple Storage Service (S3) bucket location. This can be done using a Gradio interface and AWS Software Development Kit (SDK).
46+
3. Optionally, the solution supports external job submission by uploading a ‘.json’ job configuration file and media into a designated S3 bucket location.
47+
4. The job json file uploaded to the bucket will trigger an Amazon Simple Notification Service (SNS) message that will invoke an initialization AWS Lambda function.
5048
5. The initialization Lambda function will perform input validation and set appropriate variables for the state machine.
5149
6. The workflow job record will be created in Amazon DynamoDB job table.
5250
7. The initialization Lambda function will invoke an AWS Step Functions State Machine to handle the entire workflow job.
53-
8. If the configuration is successful, an Amazon SageMaker Training Job will be submitted synchronously using the state machine built-in wait until completion mechanism. Otherwise (jump to step 11), the completion Lambda function will handle the error, update the database and notify the user via an SNS email.
54-
9. The Amazon Elastic Container Registry (ECR) container image and S3 model artifacts will be used to spin up a new graphics processing unit (GPU) container. The instance type is determined by the job json configuration.
55-
10. The GPU container will run the entire pipeline.
56-
11. Upon job completion or error, a completion Lambda function will complete the workflow job by updating the job in DynamoDB and notifying the user via email upon completion using SNS.
57-
12. Internal workflow parameters are stored in Parameter Store during guidance deployment to decouple services.
58-
13. Amazon CloudWatch is used to monitor the training logs, surfacing errors to the user.
51+
8. An Amazon SageMaker Training Job will be submitted synchronously using the state machine built-in wait until completion mechanism.
52+
10. The Amazon Elastic Container Registry (ECR) container image and S3 model artifacts will be used to spin up a new graphics processing unit (GPU) container. The instance type is determined by the job json configuration.
53+
11. The GPU container will run the entire pipeline.
54+
12. Upon job completion, a final Lambda function will complete the workflow job by updating the job metadata in DynamoDB and notifying the user via email upon completion using SNS.
55+
13. Internal workflow parameters are stored in Parameter Store during solution deployment to decouple services.
56+
Amazon CloudWatch is used to monitor the training logs, surfacing errors to the user.
5957

6058
### AWS Services in this Guidance
6159

Binary file not shown.

assets/gs-workflow-arch-new.jpg

-827 KB
Binary file not shown.

assets/gs-workflow-arch.png

-144 KB
Binary file not shown.
4.74 MB
Loading
File renamed without changes.
File renamed without changes.

assets/images/gs-deploy-arch.PNG

59.3 KB
Loading

assets/images/gs-workflow-arch.PNG

84.2 KB
Loading

assets/sns-subscription-email.png

-49.9 KB
Binary file not shown.

0 commit comments

Comments
 (0)