visual asset management system
v2.1.0
VAMS (Visual Asset Management System) 버전 2.X+는 공식 인식 및 승인 된 버전 시리즈입니다.
이전 1.X 버전의 VAM은 여전히 사용 가능하지만 더 이상 사용되거나 권장되지 않습니다.
VAMS (Visual Asset Management System) 는 공간 컴퓨팅에 사용되는 특수 시각 자산의 관리 및 배포를위한 목적으로 지어진 AWS 기본 솔루션입니다. VAMS는 조직이 클라우드의 시각 자산을 수집, 저장 및 관리 할 수있는 단순화 된 솔루션을 제공하여 웹 브라우저를 사용하여 모든 사용자가 시각 자산을 업로드, 관리, 시각화, 변환 및 검색 할 수 있도록합니다. 사용자 정의 코드와 사전 구축 또는 타사 응용 프로그램을 모두 활용하는 기존 워크 플로우도 VAMS로 마이그레이션하고 사용 가능한 온 프레미스 용량에 의해 제한되지 않고 AWS 클라우드에서 실행될 수 있습니다. VAMS는 개발 팀의 특정 사용 사례에 더욱 맞춤화되는 옵션으로 사용자 정의 가능하며 확장 가능합니다.
고객 가치 : VAMS는 증강 및 가상 현실 (AR/VR)과 같은 공간 컴퓨팅 이니셔티브에 착수하는 고객이 직면 한 문제를 해결합니다. 이전에 로컬 시스템에서 이러한 자산을 관리해야했던 조직은 이제 웹 기반 애플리케이션에서 그렇게 할 수 있습니다.
VAMS는 Amazon Simple Storage Service (Amazon S3)를 저비용 고 가용성 스토리지 계층으로 활용하여 3D 자산 관리를위한 목적으로 건축 된 API를 제공합니다. 이 API는 추상화 계층을 제공하여 사용자 정의 통합을 구축 할 수 있습니다. 맞춤형 통합을 통해 워크로드 및 애플리케이션은 클라우드로 이동하여 AWS 생태계의 폭과 깊이에 대한 액세스를 잠금 해제 할 수 있습니다.
전반적으로 VAMS Super Power는 일반적인 AWS 서비스, 오픈 소스 논리 및 확장성을 사용하여 다른 아키텍처, 솔루션 및 전략에 추가하거나 결합하여 발생합니다.
사용 사례 : VAM의 조기 반복을 활용 한 샘플 사용 사례는 다음과 같습니다.
VAMS는 현재 여러 자산 시청자와 통합되며 대화식으로 3D 자산을 볼 수있는 다음 형식을 지원합니다.
| 이름 | 확대 | 유형 | 뷰어 | 제외 된 도서관 | 메모 |
|---|---|---|---|---|---|
| 파면 | obj | 텍스트 | 온라인 3D 뷰어 | ||
| 3D 스튜디오 | 3DS | 이진 | 온라인 3D 뷰어 | ||
| 스테레오 리소그래피 | STL | 텍스트 | 온라인 3D 뷰어 | ||
| 스테레오 리소그래피 | STL | 이진 | 온라인 3D 뷰어 | ||
| gltf | gltf | 텍스트 | 온라인 3D 뷰어 | ||
| gltf | GLB | 이진 | 온라인 3D 뷰어 | ||
| 객체 파일 형식 | 끄다 | 텍스트 | 온라인 3D 뷰어 | ||
| 객체 파일 형식 | 끄다 | 이진 | 온라인 3D 뷰어 | ||
| 도트 비 | bim | 텍스트 | 온라인 3D 뷰어 | ||
| 코뿔소 3d | 3dm | 이진 | 온라인 3D 뷰어 | ||
| 필름 박스 | FBX | 텍스트 | 온라인 3D 뷰어 | ||
| 필름 박스 | FBX | 이진 | 온라인 3D 뷰어 | ||
| 콜라다 | 대 | 텍스트 | 온라인 3D 뷰어 | ||
| 가상 현실 모델링 언어 | WRL | 텍스트 | 온라인 3D 뷰어 | ||
| 3D 제조 형식 | 3MF | 텍스트 | 온라인 3D 뷰어 | ||
| 첨가제 제조 | AMF | 텍스트 | 온라인 3D 뷰어 | ||
| (제외*) dotbim | IFC | 텍스트 | 온라인 3D 뷰어* | 웹 -IFC | |
| (제외*) Freecad | fcstd | 텍스트 | 온라인 3D 뷰어* | Occt-Import-JS | |
| (제외*) 경계 담당자 | BREP | 텍스트 | 온라인 3D 뷰어* | Occt-Import-JS | |
| (제외*) ISO 10303 CAD | 단계 | 텍스트 | 온라인 3D 뷰어* | Occt-Import-JS | |
| (제외*) 그래픽 교환 | Iges | 텍스트 | 온라인 3D 뷰어* | Occt-Import-JS | |
| 포인트 클라우드 - LIDAR 데이터 교환 | 라즈 | 이진 | Potree Viewer | ||
| 포인트 클라우드 - LIDAR 데이터 교환 | 라스 | 이진 | Potree Viewer | ||
| 포인트 클라우드 - LIDAR 데이터 교환 | E57 | 이진 | Potree Viewer | ||
| 다각형 파일 형식 | 주름 | 이진 | Potree Viewer | 유형 매장 메시 및 포인트 구름 - VAMS는 현재 Ply에 대한 포인트 클라우드 뷰어 만 보여줍니다. | |
| 다각형 파일 형식 | 주름 | 텍스트 | Potree Viewer |
사용 가능한 시청자는 다음과 같습니다.
참고하십시오 :
제외* 노트 :
onlineViewer3DFileFormats viewer3dfileformats 상수에 추가하십시오 ./web/src/common/constants/fileFormats.js . 그런 다음 yarn add 통해 웹 폴더에 제외 된 NPM 라이브러리를 추가하십시오. 경고이 솔루션을 사용하면 타사 소프트웨어 라이브러리 및 제 3 자 제공 업체의 GAI (Generative AI) 모델과 상호 작용할 수 있습니다. 소프트웨어 라이브러리 및 타사 GAI 모델의 사용은 라이센스를 사용하여 라이센스를 취득했을 때 타사 소프트웨어 라이브러리 및 GAI 모델 제공 업체가 제공하는 약관 (예 : 서비스 약관, 라이센스 계약 허용 가능한 사용 정책 및 개인 정보 보호 정책).
귀하는 귀하의 타사 소프트웨어 라이브러리 및 GAI 모델을 사용하는 것이이를 관리하는 용어 및 귀하에게 적용되는 법률, 규칙, 규정, 정책 또는 표준을 준수하도록하는 책임이 있습니다.
또한 출력 및 타사 소프트웨어 라이브러리 GAI 모델 제공 업체가 배포를 기반으로 전송 될 수있는 데이터를 사용하는 방법을 포함하여 사용하는 타사 소프트웨어 라이브러리 및 GAI 모델에 대한 독립적 인 평가를 담당합니다. 구성. AWS는 AWS와의 계약에 따라 "타사 컨텐츠"인 타사 소프트웨어 라이브러리 및 GAI 모델에 관한 어떠한 진술, 보증 또는 보증을하지 않습니다. 이 솔루션은 AWS와의 계약에 따라 "AWS 컨텐츠"로 제공됩니다.
VAMS Codebase는 자주 변경되고 있으며 Github에서 안정적인 릴리스 버전을 확인하는 것이 좋습니다.
Windows 직접 배포의 경우 명령 줄에서 환경 변수를 지정하는 방법에 대한 아래 지침에 대한 일부 변경이 필요할 수 있습니다.
태그로 안정적인 릴리스를 식별 할 수 있습니다. 태그를 가져 오십시오 git fetch --all --tags 를 가져온 다음 git checkout tags/TAG 또는 git checkout -b TAG tags/TAG 가 실제 원하는 태그 인 태그가 있습니다. 태그 목록은 git tag --list 또는 릴리스 페이지에서 실행하여 찾을 수 있습니다.
참고 : 네트워크 노드에 사용자 정의 SSL 인증서가 있어야하는 HTTPS SSL 프록시 뒤에서 실행중인 경우 개발자 안내서에 CDK SSL 배포로 이동하여 자세한 내용을 알아보십시오.
cd ./web && nvm use - 노드 버전이 프로젝트와 일치하는지 확인하십시오. Docker Deomon이 실행 중인지 확인하십시오.
yarn install - 웹 앱에서 필요한 패키지를 설치하십시오 ( npm install 응용 프로그램의 작동 빌드가 발생하지 않습니다 - 원사를 사용하십시오).
npm run build - 웹 앱 빌드.
cd ../infra && npm install - package.json에 정의 된 종속성을 설치합니다.
CDK로 AWS 계정을 아직 부트 스트랩하지 않은 경우 cdk bootstrap aws://101010101010/us-east-1 계정 및 지역으로 교체하십시오. GovCloud 계정을 부수하는 경우 AWS SDK에 GovCloud 엔드 포인트를 사용하려면 export AWS_REGION=[gov-cloud-region] 실행하십시오. 참고 : VAMS 용 CloudFormation에서 필요한 AWS 구성 요소를 여전히 생성 할 수있는 부스트 랩핑에 가장 적합하지 않은 AWS IAM 역할을 사용하십시오.
config.json in /infra/config 수정하여 배포하려는 VAMS 배포 매개 변수 및 기능을 설정하십시오. 기본 제공 템플릿을 사용하는 경우 업데이트 할 권장 최소 필드는 region , adminEmailAddress 및 baseStackName 입니다. 구성 옵션에 대한 자세한 내용은 구성 안내서를 참조하십시오.
(선택 사항) 환경 변수로 배포 할 수 있도록 CDK 스택 이름과 지역을 대체하십시오 export AWS_REGION=us-east-1 && export STACK_NAME=dev 배포하려는 영역으로 교체하고 Cloudformation과 연결하려는 이름을 교체하십시오. CDK가 배포 할 것을 쌓습니다.
(FIPS 사용 만 사용) FIPS로 배포하는 경우 AWS CLI에 대한 FIPS 환경 변수를 활성화하여 export AWS_USE_FIPS_ENDPOINT=true 및 ENABLE config.json CONFIGURATION IN /infra/config 에서 app.useFips 활성화합니다.
(외부 VPC 가져 오기 전용) config.json configuration에서 서브넷이있는 외부 VPC를 가져 오는 경우 cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true 모든 비를 배포합니다. -vpc 종속 스택을 먼저. 컨텍스트 설정 또는 구성 설정으로 loadContextIgnoreVPCStacks 의 구성 설정으로 실행하지 않으면 모든 스택 단계의 최종 배포가 실패합니다. 추가 문제 해결에 대한 VPC 가져 오기 구성 안내서를 참조하십시오. 참고 : 서브넷 당 필요한 IPS에 대한 구성 안내서의 추가 메모 섹션을 검토하십시오.
cdk deploy --all --require-approval never -인프라 구성 파일에 지정된 이메일 주소를 사용하여 AWS Cognito 사용자 풀에서 계정이 생성됩니다. 임시 비밀번호로 [email protected]의 이메일을 기대하십시오.
10A. 컨테이너로 배포하기 전에 Docker가 실행 중인지 확인하십시오.
1.A (기본값) (CloudFront Deployment) cdk deploy 출력에서 {stackName].WebAppCloudFrontDistributionDomainName{uuid} 에 제공된 URL로 이동합니다.
1.B (ALB 배포 기능) cdk deploy 출력에서 webDistributionUrl 에서 제공된 URL로 이동합니다.
제공 한 이메일 주소로 로그인하려면 임시 계정 비밀번호 이메일을 확인하십시오.
(선택 사항) 추가 사용자를 추가하려면 권한 안내서에서 새 VAM 사용자 만들기를 따르십시오.
./infra/config/config.json 을 변경하거나 환경 변수를 새로운 값으로 설정하여 영역을 변경하고 새로운 VAM 인스턴스를 배포 할 수 있습니다 ( export AWS_REGION=us-east-1 && export STACK_NAME=dev ). npm run deploy.dev 다시.
VAM에 사용자 정의 또는 업데이트를 배포하려면 cdk deploy --all --require-approval never 실행하여 스택을 업데이트 할 수 있습니다. 변경 사항이 생성되어 스택에 배포됩니다.
비행중인 변경 사항에 따라 배포 중에 VAM을 일부 또는 전체적으로 사용할 수 없습니다. 사용자를 새로운 버전에 노출시키기 전에 변경 로그를주의 깊게 읽고 변경 사항을 테스트하십시오.
주요 버전 변경, 주요 Configuraiton 업데이트 (KMS CMK 키 변경, CloudFront-> Alb Switches 등)간에 VAM이 업그레이드되거나 다른 영역으로 스택을 재배치하여 A/B 배포를 사용하여 A/B 배포를 사용하는 것이 권장됩니다. 
길. ALB 구성 옵션을 사용하면 수정 된 A/B 스택 배포가 필요합니다.
참고 VAMS 버전 업그레이드 또는 지침을 따라야하는 A/B 배포에 사용해서는 안됩니다. .
VAM은 기존 자산 버킷에서 복사 할 수 있도록 준비 버킷 구성 매개 변수로 배포 할 수 있습니다.
스테이징 버킷으로 배포하려면 app.bucketMigrationStaging.assetBucketName config 매개 변수를 ./infra/config/config.json 에 CDK 배포에 설정하면 기존 버킷을 준비 버킷으로 등록합니다.
배포가 완료되면 /assets/uploadAssetWorkflow API를 호출하여 자산을 VAMS S3 버킷에 복사하고 자산 등록을 시작할 수 있습니다.
API 요청 본문에 대해 알아 보려면 API 문서의 UPLOADASSETWORKFLOW를 참조하십시오.
VAMS 백엔드를 사용하면 환경 및 사용 요구에 따라 기본 대 고급 구성을 허용합니다.
지침은 구성 안내서를 참조하십시오.
VAMS는 다양한 솔루션 기능 및 데이터 요소에 대한 미세한 액세스를 제어하기 위해 인증 위에 ABAC/RBAC (Attribute Based/Real Based Access Control) 권한 시스템을 사용합니다.
VAMS 권한 시스템 사용 방법은 권한 안내서를 참조하십시오.
VAMS 백엔드는 AWS API 게이트웨이를 통해 액세스하는 AWS Lambda 기능으로 구성됩니다.
파이프 라인은 VAM의 기능으로 편집 할 수 있습니다. 
VAMS 프론트 엔드는 단일 페이지 REACTJS 응용 프로그램입니다. Cloudfront 또는 Alb를 통해 배포 할 수 있습니다
VAMS API 및 Frontend는 기본적으로 AWS Cognito 사용자 계정을 통해 승인됩니다.
SAML을 사용한 연합 인증은 추가 구성으로 제공됩니다. 지침은 개발자 안내서의 SAML 인증을 참조하십시오.
| 요소 | 접는 사람 |
|---|---|
| 웹 응용 프로그램 | 편물 |
| CDK 배포 | 인프라 |
| API 및 백엔드 | 백엔드 |
| 사용 파이프 라인 백엔드 | 백엔드 파이프 라인 |
자세한 연습을 위해 VAMS 워크숍을 확인하십시오
VAMS의 작동 방식과 파이프 라인 및 워크 플로 구성에 대한 지침에 대한 자세한 내용은 개발자 안내서 개발자 안내서를 참조하십시오.
참조 
.
cdk destroy --all 실행하십시오.이 솔루션의 비용은 고정 스토리지 비용과 구성하는 파이프 라인의 가변 비용으로 이해할 수 있습니다. 스토리지 비용은 VAMS 파이프 라인을 사용하여 작성한 새 데이터를 포함하여 VAM에 업로드 한 데이터의 양에 비례합니다.
이 솔루션을 실행하는 동안 사용되는 AWS 서비스 비용에 대한 책임이 있습니다. 예산의 제약 내에 청구 경보가 설정되어 있는지 확인하십시오.
구성 옵션 :
대략적인 월별 비용 고장은 다음과 같습니다 (일부 무료 계층 포함 제외).
| 서비스 | 수량 | 비용 (상업) | 비용 (govcloud) |
|---|---|---|---|
| VPC (C-0 + C-1/C-2/C-3/C-5, 선택 사항) | AZ 당 1-11x 엔드 포인트 (최대 3 AZ) - 구성 옵션을 기반으로 | $ <240.91 | $ <311.13 |
| Amazon Cloudfront (C-1, 기본값) | 첫 번째 1TB- 프리 티어에 포함됩니다 | $ 0.00 | N/A |
| Amazon Alb (C-1, 선택 사항) | 1 Alb, 1TB 가공 | $ 24.43 | $ 52.56 |
| 아마존 API 게이트웨이 | 150000 요청 | $ 0.16 | $ 0.19 |
| 아마존 다이나 모드 | 750000은 146250 Reads, 0.30 GB 스토리지를 쓰고 있습니다 | $ 1.18 | $ 2.36 |
| AWS Lambda | 12000 개의 호출, 2 분 AVG. 기간, 256MB 메모리 | $ 6 | $ 6 |
| AWS 단계 기능 | 92400 상태 전환 | $ 2.21 | $ 2.65 |
| 아마존 S3 | 10GB 스토리지, 4000 PUT 요청, 4000 GET 요청 | $ 0.26 | $ 0.41 |
| 아마존 재 인식 | 9000 이미지 분석, 3 개의 사용자 정의 레이블 추론 단위 | $ 22.32 | N/A |
| 아마존 탄성 컨테이너 레지스트리 | ECR (지역) 40GB | $ 4 | $ 4 |
| Amazon Open Search Serverless (C-2, Default) | 2x Index OCU, 2x 검색 OCU, 100GB 데이터 | $ 703.20 | N/A |
| Amazon Open Search Provisioned (C-2, 선택 사항) | 3x 데이터 (R6g.large.search), 3x 마스터 (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 | 300GB 스토리지, 30GB 전송 | $ 9.60 | $ 16.34 |
| 아마존 클라우드 워치 | 1GB 로그 -VPC FlowLogs/API 게이트웨이/파이프 라인 | $ 3.28 | $ 4.12 |
| 아마존 기반암 | 1m 토큰 - 클로드 소네트 | $ 18 | $ na |
| 아마존 재 인식 | 10K 이미지 처리 | $ 7.50 | $ 9 |
AWS 인프라에 대한 시스템을 구축하면 보안 책임이 귀하와 AWS간에 공유됩니다. 이 공유 책임 모델은 호스트 운영 체제, 가상화 계층 및 서비스 운영 시설의 물리적 보안을 포함한 구성 요소를 운영, 관리 및 제어하기 때문에 운영 부담을 줄입니다. AWS 보안에 대한 자세한 내용은 AWS Cloud Security를 방문하십시오.
VAMS는이 공유 책임 모델에 따라 제공됩니다. 고객 사용을위한 모든 사용자 정의는 APPSEC 검토를 통해 수정 사항이 새로운 취약점을 소개하지 않는지 확인해야합니다. 모든 팀 구현은 구현이 적절한 보안 검토를 거치도록 책임을집니다.
web 디렉토리에서 yarn audit 실행하십시오. yarn audit fix 실행하여 중요한 보안 취약점을 완화하십시오.조직의 보안 팀과의 모든 고려 사항을 검토하여 완화가 필요한지 확인하십시오.
샘플 코드; 소프트웨어 라이브러리; 명령 줄 도구; 개념의 증거; 템플릿; 또는 기타 관련 기술 (직원이 제공하는 전술 한 전술 한 포함)은 AWS 고객 계약에 따라 AWS 컨텐츠 또는 귀하와 AWS 간의 관련 서면 계약 (적용)에 따라 귀하에게 제공됩니다. 이 AWS 컨텐츠는 생산 계정 또는 생산 또는 기타 중요한 데이터에 사용해서는 안됩니다. 귀하는 특정 품질 관리 관행 및 표준을 기반으로 생산 등급 사용에 적합한 샘플 코드와 같은 AWS 컨텐츠 테스트, 보안 및 최적화를 담당합니다. AWS 컨텐츠를 배포하면 Amazon EC2 인스턴스 실행 또는 Amazon S3 스토리지 사용과 같은 AWS 충전 가능한 리소스 생성 또는 사용에 대한 AWS 요금이 부과 될 수 있습니다.
기여 방법은 기여 파일을 참조하십시오.
프로젝트 라이센스에 대한 라이센스 파일을 참조하십시오.
Copyright Amazon.com, Inc. 또는 그 계열사. 모든 권리 보유.
해당 법률에 의해 요구되거나 서면에 동의하지 않는 한, 라이센스에 따라 배포 된 소프트웨어는 명시 적 또는 묵시적 보증 또는 조건없이 "그대로"기준으로 배포됩니다.
