Visual Asset Management System (VAMS) version 2.X+ is the official recognized and approved version series.
All previous 1.X versions of VAMS, although still available, will no longer be supported or recommended for use.
Visual Asset Management System (VAMS) is a purpose-built, AWS native solution for the management and distribution of specialized visual assets used in spatial computing. VAMS offers a simplified solution for organizations to ingest, store, and manage visual assets in the cloud, which empowers any user with a web browser to upload, manage, visualize, transform, and retrieve visual assets. Existing workflows that leverage both custom code and pre-built or third-party applications can also be migrated to VAMS and ran in the AWS cloud, as opposed to being limited by the on-premise capacity available. VAMS is customizable and expandable with option of being further tailored to specific use-cases by development teams.
Customer Value: VAMS addresses challenges faced by customers embarking on Spatial Computing initiatives, such as Augmented and Virtual Reality (AR/VR). Organizations that previously had to manage these assets on local systems can now do so from a web-based application.
Leveraging Amazon Simple Storage Service (Amazon S3) as a low-cost, high availability storage layer, VAMS provides a purpose-built API for 3D asset management. This API provides a layer of abstraction, allowing custom integrations to be built. Custom integrations allow workloads and applications to be moved to the cloud, unlocking access to the entire breadth and depth of the AWS ecosystem.
Overall, VAMS super power comes from its use of common AWS services, open source logic, and extensibility to add to or combine with other architectures, solutions, and strategies.
Use Cases: Sample use cases that have leveraged early iterations of VAMS include:
VAMS currently integrates with several different asset viewers and supports the following formats for viewing assets interactively.
Name | Extension | Type | Viewer | Excluded Library |
---|---|---|---|---|
Wavefront | obj | text | Online 3D Viewer | |
3D Studio | 3ds | binary | Online 3D Viewer | |
Stereolithography | stl | text | Online 3D Viewer | |
Stereolithography | stl | binary | Online 3D Viewer | |
Polygon File Format | ply | text | Online 3D Viewer | |
Polygon File Format | ply | binary | Online 3D Viewer | |
glTF | gltf | text | Online 3D Viewer | |
glTF | glb | binary | Online 3D Viewer | |
Object File Format | off | text | Online 3D Viewer | |
Object File Format | off | binary | Online 3D Viewer | |
Dotbim | bim | text | Online 3D Viewer | |
Rhinoceros 3D | 3dm | binary | Online 3D Viewer | |
Filmbox | fbx | text | Online 3D Viewer | |
Filmbox | fbx | binary | Online 3D Viewer | |
Collada | dae | text | Online 3D Viewer | |
Virtual Reality Modeling Language | wrl | text | Online 3D Viewer | |
3D Manufacturing Format | 3mf | text | Online 3D Viewer | |
Additive Manufacturing | amf | text | Online 3D Viewer | |
(Excluded*) Dotbim | ifc | text | Online 3D Viewer* | web-ifc |
(Excluded*) FreeCad | fcstd | text | Online 3D Viewer* | occt-import-js |
(Excluded*) Boundary Rep | brep | text | Online 3D Viewer* | occt-import-js |
(Excluded*) ISO 10303 CAD | step | text | Online 3D Viewer* | occt-import-js |
(Excluded*) Graphics Exchange | iges | text | Online 3D Viewer* | occt-import-js |
Point Cloud - LiDAR Data Exchange | laz | binary | Potree Viewer | |
Point Cloud - LiDAR Data Exchange | las | binary | Potree Viewer | |
Point Cloud - LiDAR Data Exchange | e57 | binary | Potree Viewer |
Viewers available include:
Please take note:
Exclusion* notes:
onlineViewer3DFileFormats
constants array in ./web/src/common/constants/fileFormats.js
. Then add the listed excluded npm library in the web folder through yarn add
.VAMS Codebase is changing frequently and we recommend you checkout the stable released version from github.
For windows direct deployments, some changes may be needed to the below instructions in how to specify environment variables at the command line.
You can identify stable releases by their tag. Fetch the tags git fetch --all --tags
and then git checkout tags/TAG
or git checkout -b TAG tags/TAG
where TAG is the actual desired tag. A list of tags is found by running git tag --list
or on the releases page.
Note: If you are running behind a HTTPS SSL proxy that requires network nodes to have a custom SSL certificate, head to the CDK SSL Deploy in the developer guide to learn more.
cd ./web && nvm use
- make sure you're node version matches the project. Make sure Docker daemon is running.
yarn install
- make sure you install the packages required by the web app (Take note, npm install
does not result in a working build of the application - please use yarn).
npm run build
- build the web app.
cd ../infra && npm install
- installs dependencies defined in package.json.
If you haven't already bootstrapped your aws account with CDK. cdk bootstrap aws://101010101010/us-east-1
- replace with your account and region. If you are boostrapping a GovCloud account, run export AWS_REGION=[gov-cloud-region]
as the AWS SDK needs to be informed to use GovCloud endpoints. Note: Use the least-permissive AWS IAM role for boostrapping that can still generate the needed AWS components from CloudFormation for VAMS.
Modify the config.json
in /infra/config
to set the VAMS deployment parameters and features you would like to deploy. Recommended minimum fields to update are region
, adminEmailAddress
, and baseStackName
when using the default provided template. More information about the configuration options can be found in the Configuration Guide.
(Optional) Override the the CDK stack name and region for deployment with environment variables export AWS_REGION=us-east-1 && export STACK_NAME=dev
- replace with the region you would like to deploy to and the name you want to associate with the cloudformation stack that the CDK will deploy.
(FIPS Use Only) If deploying with FIPS, enable FIPS environment variables for AWS CLI export AWS_USE_FIPS_ENDPOINT=true
and enable app.useFips
in the config.json
configuration file in /infra/config
(External VPC Import Only) If importing an external VPC with subnets in the config.json
configuration, run cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true
to import the VPC ID/Subnets context and deploy all non-VPC dependant stacks first. Failing to run this with the context setting or configuration setting of loadContextIgnoreVPCStacks
will cause the final deployment of all stacks steps to fail. See configuration guide for VPC import on additional troubleshooting. Note: Review the Configuration Guide's Additional Notes section for # of IPs needed per subnet.
cdk deploy --all --require-approval never
- An account is created in an AWS Cognito User Pool using the email address specified in the infrastructure config file. Expect an email from no-reply@verificationemail.com with a temporary password.
10a. Ensure that docker is running before deploying as a container will need to be built
1.a (Default)(Cloudfront Deployment) Navigate to URL provided in {stackName].WebAppCloudFrontDistributionDomainName{uuid}
from cdk deploy
output.
1.b (ALB Deployment Feature) Navigate to URL provided in webDistributionUrl
from cdk deploy
output.
Check email for temporary account password to log in with the email address you provided.
(Optional) Follow Create New VAMS User in permission guide to add additional users
You can change the region and deploy a new instance of VAMS by changing the ./infra/config/config.json
or setting the environment variables to new values (export AWS_REGION=us-east-1 && export STACK_NAME=dev
) and then running npm run deploy.dev
again.
To deploy customzations or updates to VAMS, you can update the stack by running cdk deploy --all --require-approval never
. A changeset is created and deployed to your stack.
Please note, depending on what changes are in flight, VAMS may not be available to users in part or in whole during the deployment. Please read the change log carefully and test changes before exposing your users to new versions.
It is reccommended that VAMS be upgraded between major version changes, major configuraiton updates (KMS CMK key changes, Cloudfront -> ALB switches, etc.), or re-deployments of stacks to a different region to use an A/B deployment using the path. Note that when using the ALB configuration option that a modified A/B stack deployment will be needed.
NOTE This should not be used for VAMS version upgrades or A/B deployments which should follow the instructions in .
VAMS can be deployed with a staging bucket config parameter to enable copying from an existing asset bucket.
To deploy with staging bucket, just set the app.bucketMigrationStaging.assetBucketName
config parameter in ./infra/config/config.json
to your cdk deployment and VAMS will register your existing bucket as a staging bucket.
Once the deployment is complete, you can invoke the /assets/uploadAssetWorkflow
API to start copying the assets into the VAMS S3 bucket and registering the assets.
Please refer to the uploadAssetWorkflow in the API docs to find out about the API request body.
VAMS backend allows for basic to advanced configuration based on the environment and use-case need.
See Configuration Guide for instructions.
VAMS uses a Attribute-based/Role-Based Access Control (ABAC/RBAC) permission system on top of authentication to control fine grained access to various solution functionalities and data elements.
See Permissions Guide for how to use the VAMS permission system.
VAMS Backend is composed of AWS Lambda functions that are accessed through an AWS API Gateway.
Pipelines are a feature in VAMS that allow you to edit
VAMS Frontend is a single page ReactJS application. It can be deployed via CloudFront or ALB
VAMS API and frontend are authorized through AWS Cognito user accounts by default.
Federated authentication with SAML is available with additional configuration. See SAML Authentication in the developer guide for instructions.
component | folder |
---|---|
web application | web |
cdk deployment | infra |
api and backend | backend |
pipeline backend | backendVisualizerPipelines |
Checkout the VAMS workshop for detailed walkthrough
To know more about how VAMS works and for instructions on configuring pipeline & workflow, refer to the Developer Guide developer guide.
Refer to the Writing your own pipelines section in the Developer Guide.
VAMS is provided under a shared responsibility model. Any customization for customer use must go through an AppSec review to confirm the modifications don't introduce new vulnerabilities. Any team implementing takes on the responsibility of ensuring their implementation has gone through a proper security review.
yarn audit
in the web
directory prior to deploying front-end to ensure all packages are up-to-date. Run yarn audit fix
to mitigate critical security vulnerabilities.Please review all considerations with your organizations' security teams to determine if mitigations are required.
cdk destroy --all
from infra folder.See the CONTRIBUTING file for how to contribute.
The costs of this solution can be understood as fixed storage costs and variable costs of the pipelines that you configure. Storage cost is proportional to the amount of data you upload to VAMS including new data you create using VAMS pipelines.
You are responsible for the cost of the AWS services used while running this solution. Ensure that you have billing alarms set within the constraints of your budget.
Configuration Options:
An approximate monthly cost breakdown is below (excluding some free tier inclusions):
Service | Quantity | Cost (Commercial) | Cost (GovCloud) |
---|---|---|---|
VPC (C-0 + C-1/C-2/C-3/C-5,Optional) | 1-11x Endpoints per AZ (up to 3 AZ) - based on config options | $<240.91 | $<311.13 |
Amazon Cloudfront (C-1,Default) | First 1TB - Included in free tier | $0.00 | N/A |
Amazon ALB (C-1,Optional) | 1 ALB, 1TB Processed | $24.43 | $52.56 |
Amazon API Gateway | 150000 requests | $0.16 | $0.19 |
Amazon DynamoDB | 750000 writes, 146250 reads, 0.30 GB storage | $1.18 | $2.36 |
AWS Lambda | 12000 invocations, 2-minute avg. duration, 256 MB memory | $6 | $6 |
AWS Step Functions | 92400 state transitions | $2.21 | $2.65 |
Amazon S3 | 10 GB storage, 4000 PUT requests, 4000 GET requests | $0.26 | $0.41 |
Amazon Rekognition | 9000 Image analysis, 3 Custom Label inference units | $22.32 | N/A |
Amazon Elastic Container Registry | ECR (In region) 40GB | $4 | $4 |
Amazon Open Search Serverless (C-2,Default) | 2x Index OCU, 2x Search OCU, 100GB Data | $703.20 | N/A |
Amazon Open Search Provisioned (C-2,Optional) | 3x Data (r6g.large.search), 3x Master (r6g.large.search), 240GB EBS | $743.66 | $915.52 |
Amazon Location Service (C-4,Default) | 1000 Map tiles Retrieved | $40.00 | N/A |
Below are the additional costs for including the point cloud visualizer pipeline feature in your deployment (C-5, Optional):
Service | Quantity | Cost (Commercial) | Cost (GovCloud) |
---|---|---|---|
Batch Fargate | 10 hours of processing | $3.56 | $4.88 |
Amazon S3 | 300 GB storage, 30GB transfer out | $9.60 | $16.34 |
Amazon Cloudwatch | 1GB logs - VPC Flowlogs/API Gateway/Pipeline | $3.28 | $4.12 |
See the LICENSE file for our project's licensing.
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.