visual asset management system下載 - visual asset management system源代碼下載

visual asset management system

其他源碼

v2.1.0

下載

視覺資產管理系統（VAMS）

注意

Visual Asset Management System（VAMS）版本2.x+是官方公認和批准的版本系列。

所有先前的1.x版本的VAM雖然仍然可用，但不再支持或建議使用。

介紹

視覺資產管理系統（VAMS）是一種專門構建的AWS本機解決方案，用於管理和分佈空間計算中使用的專門視覺資產。 VAMS為組織提供了一種簡化的解決方案，以攝入，存儲和管理在雲中的視覺資產，這使任何使用Web瀏覽器的用戶能夠上傳，管理，可視化，轉換和檢索視覺資產。利用自定義代碼和預構建或第三方應用程序的現有工作流程也可以遷移到VAM並在AWS雲中運行，而不是受到可用的本地容量的限制。 VAM是可自定義和可擴展的，可以選擇由開發團隊進一步針對特定用例量身定制。

客戶價值： VAM解決了啟動空間計算計劃的客戶面臨的挑戰，例如增強和虛擬現實（AR/VR）。以前必須在本地系統上管理這些資產的組織現在可以從基於Web的應用程序中這樣做。

VAMS利用Amazon簡單存儲服務（Amazon S3）作為低成本，高可用性存儲層，為3D資產管理提供了專門構建的API。該API提供了一層抽象，可以構建自定義集成。自定義集成允許工作負載和應用程序移至雲中，從而解開對AWS生態系統的整個廣度和深度的訪問。

總體而言，VAMS Super Power來自使用通用AWS服務，開源邏輯以及可擴展到或與其他架構，解決方案和策略結合使用的可擴展性。

用例：已利用VAM早期迭代的樣品用例包括：

使用高可用的S3存儲的3D資產的分銷和管理
使用VAMS管道對3D資產進行修改
使用VAMS Workfrows創建用於3D資產修改的工作流程

屏幕截圖

數據庫視圖元數據工作流程

體系結構概述

VAMS配置體系結構

支持瀏覽器查看的3D資產類型

VAM當前與幾個不同的資產查看器集成在一起，並支持以下格式以交互方式查看3D資產。

姓名	擴大	類型	觀眾	排除圖書館	筆記
波前	OBJ	文字	在線3D查看器
3D Studio	3DS	二進制	在線3D查看器
立體光刻	STL	文字	在線3D查看器
立體光刻	STL	二進制	在線3D查看器
GLTF	GLTF	文字	在線3D查看器
GLTF	GLB	二進制	在線3D查看器
對象文件格式	離開	文字	在線3D查看器
對象文件格式	離開	二進制	在線3D查看器
dotbim	BIM	文字	在線3D查看器
Rhinoceros 3d	3DM	二進制	在線3D查看器
電影盒	FBX	文字	在線3D查看器
電影盒	FBX	二進制	在線3D查看器
科拉達	dae	文字	在線3D查看器
虛擬現實建模語言	WRL	文字	在線3D查看器
3D製造格式	3mf	文字	在線3D查看器
增材製造	AMF	文字	在線3D查看器
（排除*）dotbim	IFC	文字	在線3D查看器*	Web-ifc
（排除*）FREECAD	fcstd	文字	在線3D查看器*	OCCT-IMPORT-JS
（排除*）邊界代表	布雷普	文字	在線3D查看器*	OCCT-IMPORT-JS
（排除*）ISO 10303 CAD	步	文字	在線3D查看器*	OCCT-IMPORT-JS
（排除*）圖形交換	iges	文字	在線3D查看器*	OCCT-IMPORT-JS
點雲 - 激光雷達數據交換	laz	二進制	POTREE查看器
點雲 - 激光雷達數據交換	拉斯	二進制	POTREE查看器
點雲 - 激光雷達數據交換	E57	二進制	POTREE查看器
多邊形文件格式	ply	二進制	POTREE查看器		類型存儲網格和點雲 - 當前僅顯示PLY的點雲查看器
多邊形文件格式	ply	文字	POTREE查看器

可用的觀眾包括：

在線3D查看器
POTREE查看器

請注意：

雖然我們僅限於這些格式來查看資產，但任何文件格式都可以上傳到VAM。
格式有一些限制，這些格式利用了多個文件，例如使用JSON與其他文件的引用。
像Potree Viewer這樣的一些觀眾需要部署其他管道來完全生成和觀看點雲文件。

排除*注：

在線3D查看器需要更多的限制性許可OpenCascade子圖書館才能查看這些文件類型。由於VAMS攜帶LGPL庫的限制，它們被排除在外。
- 如果組織希望實現./web/src/common/constants/fileFormats.js onlineViewer3DFileFormats添加排除的文件類型。然後，通過yarn add添加Web文件夾中列出的不包括NPM庫。

安裝

警告該解決方案使您可以與第三方提供商的第三方軟件庫和生成AI（GAI）模型進行交互。您對軟件庫和第三方GAI模型的使用受第三方軟件庫和GAI模型提供商提供的條款的約束（例如，您的服務條款，許可協議，例如，他們的服務條款，許可協議，可接受的使用政策和隱私政策）。

您有責任確保使用第三方軟件庫和GAI模型遵守有關它們的術語以及適用於您的任何法律，規則，法規，策略或標準。

您還負責對使用的第三方軟件庫和GAI模型進行獨立評估，包括其輸出以及第三方軟件庫Gai模型提供商如何使用任何可能基於您的部署傳輸給它們的數據配置。 AWS對第三方軟件庫和GAI模型沒有任何陳述，保證或保證，這些模型是與AWS協議下的“第三方內容”。根據您與AWS協議，將此解決方案作為“ AWS內容”提供給您。

要求

Python 3.10
詩歌（用於管理VAMS後端中的Python依賴性）
Docker
節點> = 18.7
紗> = 1.22.19
節點版管理器（NVM）
AWS CLI
AWS CDK CLI
以上概述的最小訪問級別的程序訪問AWS帳戶。

首次部署VAM

構建和部署步驟（Windows/Linux/Mac）

VAMS代碼庫經常更改，我們建議您查看GitHub穩定版本的版本。

對於Windows Direct部署，可能需要對以下說明進行一些更改，以指定命令行中的環境變量。

您可以通過其標籤識別穩定的發行版。獲取標籤git fetch --all --tags ，然後git checkout tags/TAG或git checkout -b TAG tags/TAG其中標籤是實際所需的標籤。通過運行git tag --list或發行版頁面上）找到標籤列表。

注意：如果您是在HTTPS SSL代理後面運行的，該代理需要網絡節點具有自定義SSL證書，請前往開發人員指南中的CDK SSL部署以了解更多信息。

cd ./web && nvm use - 確保您的節點版本與項目匹配。確保Docker守護程序正在運行。
yarn install - 確保安裝Web應用程序所需的軟件包（請注意， npm install不會導致應用程序的工作構建 - 請使用YARN）。
npm run build - 構建Web應用程序。
cd ../infra && npm install - package.json中定義的依賴項。
如果您尚未使用CDK引導您的AWS帳戶。 cdk bootstrap aws://101010101010/us-east-1用您的帳戶和區域替換。如果您正在瀏覽一個GovCloud帳戶，請運行export AWS_REGION=[gov-cloud-region] ，因為需要告知AWS SDK使用GovCloud端點。注意：使用最小的AWS IAM角色進行boostappaging，該角色仍然可以從VAM的Cloudformation中生成所需的AWS組件。
修改/infra/config的config.json以設置您要部署的VAMS部署參數和功能。使用默認提供的模板時，建議更新的最小字段是region ， adminEmailAddress和baseStackName 。有關配置選項的更多信息，請參見“配置指南”。
export AWS_REGION=us-east-1 && export STACK_NAME=dev可選）重要堆疊CDK將部署。
（FIPS僅使用）如果使用FIP部署，請啟用AWS CLI export AWS_USE_FIPS_ENDPOINT=true app.useFips在/infra/config In in config.json配置文件中
（僅外部VPC導入）如果在config.json配置中將外部VPC導入外部VPC，請運行cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true以導入VPC ID/Subnets上下文- VPC依賴性堆棧首先。無法使用loadContextIgnoreVPCStacks的上下文設置或配置設置運行此操作，這將導致所有堆棧步驟的最終部署失敗。有關其他故障排除的VPC導入的VPC，請參見配置指南。注意：查看“配置指南”的附加說明部分，每件子網所需的IPS＃。
cdk deploy --all --require-approval never - 使用基礎結構配置文件中指定的電子郵件地址在AWS Cognito用戶池中創建帳戶。希望通過臨時密碼從[email protected]發出電子郵件。
10a。確保在部署作為容器之前正在運行Docker，需要建造

部署成功

1.a（默認）（雲額部署）導航到{stackName].WebAppCloudFrontDistributionDomainName{uuid}從cdk deploy輸出。

1.B（ALB部署功能）導航到cdk deploy輸出中webDistributionUrl提供的URL。

檢查電子郵件中以獲取臨時帳戶密碼，以登錄您提供的電子郵件地址。
（可選）遵循在權限指南中創建新VAMS用戶以添加其他用戶

單個帳戶中具有不同或同一區域的多個部署

您可以通過更改./infra/config/config.json或將環境變量設置為新值來更改區域並部署VAM的新實例（ export AWS_REGION=us-east-1 && export STACK_NAME=dev ），然後運行npm run deploy.dev 。

部署VAMS更新

要將自定義或更新到VAM中，您可以通過運行cdk deploy --all --require-approval never stack更新堆棧。創建更改集並將其部署到您的堆棧中。

請注意，根據飛行中的更改，在部署期間，用戶可能無法部分或整體使用VAM。請仔細閱讀更改日誌並測試更改，然後將用戶暴露於新版本。

建議將VAM升級在主要版本更改，主要配置更新（kmms cmk鍵更改，雲範圍 - > alb switches等）或堆棧的重新部署到其他區域，以使用A/B部署使用A/B部署 VAMS部署數據遷移小路。請注意，使用ALB配置選項時，將需要修改的A/B堆棧部署。

您想在VAMS中註冊的S3中已經有資產？

請注意，這不應用於VAMS版本升級或A/B部署，該升級應遵循 VAMS部署數據遷移。

可以使用分期存儲桶配置參數部署VAM，以從現有資產存儲桶中啟用複制。

要使用分期存儲桶部署，只需將app.bucketMigrationStaging.assetBucketName config參數設置為./infra/config/config.json in CDK部署，而VAMS將註冊您現有的存儲桶作為分期存儲桶。

部署完成後，您可以調用/assets/uploadAssetWorkflow API，以開始將資產複製到VAMS S3存儲桶中並註冊資產。

請參閱API文檔中的uploadAssetworkflow，以了解有關API請求主體的信息。

配置選項

VAMS Backend允許基於環境和用例需求基本到高級配置。

有關說明，請參見配置指南。

權限選項

VAMS在身份驗證之上使用基於屬性的基於屬性/基於角色的訪問控制（ABAC/RBAC）許可系統，以控制對各種解決方案功能和數據元素的細粒度訪問。

有關如何使用VAMS權限系統的權限指南。

建築組件

後端

VAMS後端由AWS lambda函數組成，這些功能可通過AWS API網關訪問。

各個組件的建築圖

資產管理

Asset_Management

管道創建

管道是VAM中的功能，可讓您編輯 pipelines_creation

工作流執行

前端WebApp

VAMS Frontend是一個單頁ReactJS應用程序。它可以通過CloudFront或Alb部署

網絡應用網絡雲

網絡應用網絡ALB

安全

VAMS API和FRONTEND默認情況下通過AWS Cognito用戶帳戶授權。

具有SAML的聯合身份驗證可提供其他配置。請參閱《開發人員指南》中的SAML身份驗證。

代碼佈局

成分	文件夾
Web應用程序	網絡
CDK部署	下屬
API和後端	後端
用例後端	後端攻擊

演示和講習班

查看VAMS研討會，以獲取詳細的演練

開發人員

要了解有關VAM的工作原理以及有關配置管道和工作流程的說明的更多信息，請參閱開發人員指南開發人員指南。

寫自己的VAMS管道

參考在開發人員指南中編寫自己的管道部分。

解除安裝

運行cdk destroy --all來自Infra文件夾。
CDK可能不會刪除某些資源（例如S3存儲桶和DynamoDB表，管道堆棧）。您可以使用AWS CLI或AWS控制台刪除它們。

費用

該解決方案的成本可以理解為您配置的管道的固定存儲成本和可變成本。存儲成本與您上傳到VAM的數據數量成正比，包括使用VAMS管道創建的新數據。

您負責運行此解決方案時使用的AWS服務的成本。確保您在預算的限制內設置了計費警報。

配置選項：

C-0：基於以下配置需求（可選）的可變端點部署VPC。導入帶有端點的現有VPC/子網的選項。
C-1：用雲方（默認）或alb部署靜態網頁。 Alb需要2個AZ的VPC
C-2：使用無服務器（默認），已配置或沒有開放搜索部署Opensearch。配置需要3個AZ的VPC
C-3：在VPC中部署所有lambdas（可選）。需要使用1 AZ的VPC
C-4：與位置服務部署（默認）。
C-5：部署特定用途管道[即Potreeviewer管道，Genai Metadata Generation]（可選）。需要1個AZ的VPC。

大約每月的成本細分低於（不包括一些免費層包含物）：

服務	數量	成本（商業）	費用（GovCloud）
VPC（C-0 + C-1/C-2/C-3/C-5，可選）	每個AZ（最多3 AZ）1-11x端點 - 基於配置選項	$ <240.91	$ <311.13
Amazon CloudFront（C-1，默認）	第一個1TB-包含在自由層中	$ 0.00	N/A。
亞馬遜ALB（C-1，可選）	1 Alb，1TB處理	$ 24.43	$ 52.56
亞馬遜API網關	150000請求	$ 0.16	$ 0.19
Amazon DynamoDB	750000寫作，146250讀，0.30 GB存儲	$ 1.18	$ 2.36
AWS Lambda	12000個調用，2分鐘的AVG。持續時間，256 MB內存	$ 6	$ 6
AWS步驟功能	92400州過渡	$ 2.21	$ 2.65
亞馬遜S3	10 GB存儲，4000個PUT請求，4000 GET請求	$ 0.26	$ 0.41
亞馬遜重新認知	9000圖像分析，3個自定義標籤推理單元	$ 22.32	N/A。
亞馬遜彈性容器註冊表	ECR（在地區）40GB	$ 4	$ 4
Amazon Open Search無服務器（C-2，默認）	2x索引OCU，2X搜索OCU，100GB數據	$ 703.20	N/A。
亞馬遜開放搜索配置（C-2，可選）	3X數據（R6G.Large.Search），3X Master（R6G.Large.Search），240GB EBS	$ 743.66	$ 915.52
亞馬遜位置服務（C-4，默認）	檢索1000個地圖瓷磚	$ 40.00	N/A。

以下是部署中包括用例特定管道功能的額外費用（C-5，可選）：

服務	數量	成本（商業）	費用（GovCloud）
批處理	10個小時的處理	$ 3.56	$ 4.88
亞馬遜S3	300 GB存儲，30GB轉移	$ 9.60	$ 16.34
Amazon CloudWatch	1GB日誌-VPC Flowlogs/API網關/管道	$ 3.28	$ 4.12
亞馬遜基岩	1M令牌 - 克勞德十四行詩	$ 18	$ na
亞馬遜重新認知	10K圖像處理	$ 7.50	$ 9

安全

當您在AWS基礎架構上構建系統時，您和AWS之間會共享安全責任。由於AWS運行，管理和控制組件，包括主機操作系統，虛擬化層以及服務運營的設施的物理安全，因此這種共同責任模型會減輕您的運營負擔。有關AWS安全性的更多信息，請訪問AWS Cloud Security。

VAM是在此共同責任模型下提供的。任何用於客戶使用的自定義化都必須進行APPSEC審核，以確認修改不會引入新的漏洞。任何實施團隊都承擔確保實施的責任，已經進行了適當的安全審查。

部署前端之前，請在web目錄中運行yarn audit以確保所有軟件包都是最新的。運行yarn audit fix以減輕關鍵的安全漏洞。
部署到客戶帳戶時，為部署創建IAM角色，以限制根據客戶內部安全策略所需的最低特權訪問權限。

安全考慮

運行CDK Bootstrap具有部署CDK和VAMS環境組件所需的最小私人AWS IAM角色。
當前，VAMS UI網頁不支持HTTPonly或安全的Cookie來存儲用戶身份驗證數據。
目前正在應用內容安全策略（CSP），但是當從應用程序負載均衡器（ALB）配置選項中部署時，CSP是通過HTML主體而不是通過標頭髮送的，這是由於當前的AWS Alvs AlbEner重新編寫的限制。
使用CloudFront Configuration選項安裝AWS管理的TLS CERTRIFICATE，並生成唯一的CloudFront域URL。考慮修改您自己的TLS證書和域的雲層分散。
身份驗證訪問，ID和文件預先定義的URL代幣超時設置為1小時，默認情況下，根據最佳PRACITCE安全指南。諮詢您的組織的安全團隊，並根據解決任何應用超時問題進行調整，以說明解決任何應用程序超時問題。

請與您的組織的安全團隊一起查看所有註意事項，以確定是否需要緩解。

內容安全法律免責聲明

示例代碼；軟件庫；命令行工具；概念證明；模板；或其他相關技術（包括我們人員提供的任何上述技術），作為AWS客戶協議下的AWS內容或您與AWS之間的相關書面協議（以適用的為準）作為AWS內容提供。您不應在生產帳戶，生產或其他關鍵數據中使用此AWS內容。您有責任根據您的特定質量控制實踐和標準來測試，保護和優化AWS內容，例如示例代碼，以適合生產等級。部署AWS內容可能會因創建或使用AWS收費資源（例如運行Amazon EC2實例或使用Amazon S3存儲）而產生AWS費用。