```
_✅ All assets are now staged on your S3 bucket. You or any user can use S3 links for deployments._
## File structure
Network Orchestration for AWS Transit Gateway solution consists of:
- Solution templates to provision needed AWS resources
- Lambda microservices to implement solution functional logics
- custom_resource: Handle cfn custom resource CRUD
- state_machine: Handle solution's core state machine
- tgw_peering: Handle solution transit gateway peering functionality
- UI to deploy solution UI components
|-.github
|-architecture.png [ architecture diagram ]
|-deployment/
|-manifest-generator [ generates manifest files for solution ui ]
|-network-orchestration-hub.template [ hub template ]
|-network-orchestration-hub-service-linked-roles.template [ hub template, deploys service linked roles]
|-network-orchestration-spoke.template [ spoke template]
|-network-orchestration-spoke-service-linked-roles.template [ spoke template, deploys only service linked roles ]
|-network-orchestration-organization-role.template [ role template, deploys in management account ]
|-build-s3-dist.sh [ script to build solution microservices ]
|-source/
|-cognito-trigger [ manage new user creation in the cognito user pool ]
|-lambda/ [ solution microservices ]
|-custom_resource [ CloudFormation Custom Resources ]
|-tgw_peering_attachment [ Manage Transit Gateway Peering Attachments]
|-tgw_vpc_attachment [ Manage VPC to Transit Gateway Attachments ]
|-ui [ solution ui components ]
|-run-unit-test.sh [ script to run unit tests ]
|-additional_files [ CODE_OF_CONDUCT, NOTICE, LICENSE, sonar-project.properties etc.]
## License
See license [here](./LICENSE.txt).
## Anonymized data collection
This solution includes an option to send anonymized operational metrics to AWS. We use this data to better understand how customers use this solution and related services and products. For more information, including how to disable this capability, please see the [implementation guide](https://docs.aws.amazon.com/solutions/latest/serverless-transit-network-orchestrator/anonymized-data-collection.html).
---
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Licensed under the Apache License Version 2.0 (the "License"). You may not use this file except in compliance with the License. A copy of the License is located at:
http://www.apache.org/licenses/LICENSE-2.0
or in the ["license"](./LICENSE.txt) file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions and limitations under the License.
## Installing pre-packaged solution template
- Deploy in the account you want to act as the hub: [network-orchestration-hub.template](https://solutions-reference.s3.amazonaws.com/serverless-transit-network-orchestrator/latest/network-orchestration-hub.template)
- Deploy in spoke accounts: [network-orchestration-spoke.template](https://solutions-reference.s3.amazonaws.com/serverless-transit-network-orchestrator/latest/network-orchestration-spoke.template)
- Deploy in AWS Organizations management account: [network-orchestration-organization-role.template](https://solutions-reference.s3.amazonaws.com/serverless-transit-network-orchestrator/latest/network-orchestration-organization-role.template)
_Note: All templates need to be deployed in the same preferred Region._
***
## Customization
Use the following steps if you want to customize the solution or extend the solution with newer capabilities.
### Setup
- Python Prerequisite: python=3.9 | pip3=21.3.1
- Javascript Prerequisite: node=v16.4.50 | npm=8.19.2
Clone the repository and make desired code changes.
```
git clone aws-solutions/network-orchestration-for-aws-transit-gateway
```
_Note: The following steps have been tested under the preceding pre-requisites._
### Unit Test
Run unit tests to ensure that your added customization passes the tests.
```
cd ./source
chmod +x ./run-unit-tests.sh
./run-unit-tests.sh
cd ..
```
_✅ Ensure that all unit tests pass. Review the generated coverage report._
### Build
Use the following steps to build your customized distributable.
_Note: For PROFILE_NAME, substitute the name of an AWS CLI profile that contains appropriate credentials for deploying in your preferred Region._
- Create an Amazon Simple Storage Service (Amazon S3) bucket with the format 'MY-BUCKET-