visual asset management system
v2.1.0
Visual Asset Management System（VAMS）バージョン2.x+は、公式認識および承認済みバージョンシリーズです。
VAMの以前の1.xバージョンはすべて利用可能ですが、使用するためにサポートまたは推奨されなくなります。
Visual Asset Management System（VAMS）は、空間コンピューティングで使用される特殊な視覚資産の管理と配布のための専用のAWSネイティブソリューションです。 VAMSは、組織がクラウド内の視覚資産を摂取、保存、管理するための簡素化されたソリューションを提供します。これにより、Webブラウザを使用してユーザーが視覚資産をアップロード、管理、視覚化、変換、および取得することができます。カスタムコードと事前に構築されたまたはサードパーティの両方のアプリケーションの両方を活用する既存のワークフローも、利用可能なオンプレミス容量によって制限されるのではなく、VAMSに移行してAWSクラウドで実行できます。 VAMSはカスタマイズ可能で拡張可能であり、開発チームによる特定のユースケースにさらに調整されるオプションがあります。
顧客価値： VAMSは、拡張や仮想現実（AR/VR）などの空間的コンピューティングイニシアチブに着手する顧客が直面する課題に対処します。以前にローカルシステムでこれらの資産を管理する必要があった組織は、Webベースのアプリケーションからこれを行うことができます。
Amazon Simple Storage Service（Amazon S3）を低コストで高可用性ストレージレイヤーとして活用するVAMSは、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ビューア | ||
| Rhinoceros 3d | 3dm | バイナリ | オンライン3Dビューア | ||
| Filmbox | FBX | 文章 | オンライン3Dビューア | ||
| Filmbox | 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 | |
| ポイントクラウド-LIDARデータ交換 | ラズ | バイナリ | Potree Viewer | ||
| ポイントクラウド-LIDARデータ交換 | ラス | バイナリ | Potree Viewer | ||
| ポイントクラウド-LIDARデータ交換 | E57 | バイナリ | Potree Viewer | ||
| ポリゴンファイル形式 | プライ | バイナリ | Potree Viewer | タイプストアメッシュとポイントクラウド - 現在、PlyのPoint Cloud Viewerのみを表示しています | |
| ポリゴンファイル形式 | プライ | 文章 | Potree Viewer |
利用可能な視聴者は次のとおりです。
注意してください：
除外*注：
./web/src/common/constants/fileFormats.js onlineViewer3DFileFormats定数配列に追加します。次に、 yarn add介してWebフォルダーにリストされている除外されたNPMライブラリを追加します。 警告このソリューションを使用すると、サードパーティのプロバイダーからのサードパーティソフトウェアライブラリおよび生成AI（GAI）モデルと対話できます。ソフトウェアライブラリとサードパーティの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 Daemonが実行されていることを確認してください。
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アカウントをブースストラップする場合は、AWS SDKを使用してGovCloudエンドポイントを使用するために通知する必要があるためexport AWS_REGION=[gov-cloud-region]してください。注：VAMのCloudFormationから必要なAWSコンポーネントを生成できるブースストラップには、最小の心AWS IAMの役割を使用します。
config.json in /infra/configを変更して、展開するVAMS展開パラメーターと機能を設定します。デフォルトの提供されたテンプレートを使用する場合、更新する推奨最小フィールドは、 region 、 adminEmailAddress 、およびbaseStackNameです。構成オプションの詳細については、構成ガイドをご覧ください。
（オプション）環境変数を備えた展開用のCDKスタック名と領域をオーバーライドしますexport AWS_REGION=us-east-1 && export STACK_NAME=dev展開したい領域とクラウドフォーメーションに関連付けたい名前に置き換えますCDKが展開することをスタックします。
（FIPS使用のみ）FIPSで展開する場合、AWSのFIPS環境変数を有効にしますexport AWS_USE_FIPS_ENDPOINT=true and enable app.useFips config.json file in /infra/config
（外部VPCインポートのみ） config.json構成にサブネットを使用して外部VPCをインポートする場合、 cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true vpc id/subnetsコンテキストをインポートし、すべての非展開を展開する場合-VPC依存スタック最初に。 loadContextIgnoreVPCStacksのコンテキスト設定または構成設定でこれを実行できないと、すべてのスタックステップの最終展開が失敗します。追加のトラブルシューティングでVPCインポートについては、構成ガイドを参照してください。注：サブネットごとに必要なIPSの＃については、Configuration Guideの追加ノートセクションを確認します。
cdk deploy --all --require-approval neverアカウントは、インフラストラクチャ構成ファイルで指定された電子メールアドレスを使用して、AWS Cognitoユーザープールで作成されます。一時的なパスワードを備えた[email protected]からメールを期待してください。
10a。コンテナとして展開する前にDockerが実行されていることを確認してください
1.a（default）（cloudfront deployment）{stackname]で提供されているURLに移動します。CDK cdk deploy出力から{stackName].WebAppCloudFrontDistributionDomainName{uuid} 。
1.B（ALB展開機能） cdk deploy出力からwebDistributionUrlで提供されるURLに移動します。
一時的なアカウントのパスワードを確認して、提供したメールアドレスでログインしてください。
（オプション）許可ガイドで新しいVAMSユーザーの作成をフォローして、追加のユーザーを追加する
./infra/config/config.jsonを変更するか、環境変数を新しい値（ export AWS_REGION=us-east-1 && export STACK_NAME=dev ）に変更するか、環境変数を設定して実行することにより、地域を変更してVAMの新しいインスタンスを展開できます。 npm run deploy.dev 。
VAMSにカスタムZationsまたは更新を展開するには、 cdk deploy --all --require-approval never 。 Changesetが作成され、スタックに展開されます。
飛行中の変更に応じて、展開中にVAMが一部または全体のユーザーが利用できない場合があることに注意してください。ユーザーを新しいバージョンに公開する前に、変更ログを注意深く読み、変更をテストしてください。
VAMは、メジャーバージョンの変更、主要なConfiguraitonの更新（KMS CMKキー変更、クラウドフロント - > ALBスイッチなど）の間でアップグレードされること、またはスタックの別の領域への再展開の間で、A/B展開を使用してA/B展開を使用して再展開することが再構成されています。 
パス。 ALB構成オプションを使用する場合、変更されたA/Bスタック展開が必要になることに注意してください。
これは、 VAMSバージョンのアップグレードまたはA/Bの展開に使用しないでください。 。
VAMは、既存のアセットバケットからのコピーを有効にするために、ステージングバケット構成パラメーターで展開できます。
ステージングバケットで展開するには、 app.bucketMigrationStaging.assetBucketName configパラメーターを./infra/config/config.jsonに設定するだけで、既存のバケットをステージングバケツとして登録します。
展開が完了したら、 /assets/uploadAssetWorkflow APIを呼び出して、AssetをVAMS S3バケットにコピーして資産を登録します。
APIドキュメントのuploadassetworkflowを参照して、APIリクエストボディについて調べてください。
VAMSバックエンドでは、環境とユースケースのニーズに基づいて、基本から高度な構成が可能になります。
指示については、構成ガイドを参照してください。
VAMSは、認証に加えて属性ベース/ロールベースのアクセス制御（ABAC/RBAC）許可システムを使用して、さまざまなソリューション機能とデータ要素への細かい粒子アクセスを制御します。
VAMS許可システムの使用方法については、Permissions Guideを参照してください。
VAMSバックエンドは、AWS APIゲートウェイを介してアクセスされるAWSラムダ関数で構成されています。
パイプラインは、編集できるVAMSの機能です
VAMS Frontendは、単一ページのReactJSアプリケーションです。 CloudFrontまたはALBを介して展開できます
VAMS APIとFrontEndは、デフォルトでAWS Cognitoユーザーアカウントを通じて承認されます。
SAMLを使用したFederated認証は、追加の構成で利用できます。指示については、開発者ガイドのSAML認証を参照してください。
| 成分 | フォルダ |
|---|---|
| Webアプリケーション | ウェブ |
| CDK展開 | インフラ |
| APIとバックエンド | バックエンド |
| ユースケースパイプラインバックエンド | BackEndpipelines |
詳細なウォークスルーについては、VAMSワークショップをチェックしてください
VAMがどのように機能するかについて詳しく知るため、およびPipeline＆Workflowの構成に関する指示については、Developer Guide Developer Guideを参照してください。
を参照してください
。
cdk destroy --all Infraフォルダーから。このソリューションのコストは、構成するパイプラインの固定ストレージコストと変動コストとして理解できます。ストレージコストは、VAMSパイプラインを使用して作成した新しいデータを含むVAMにアップロードするデータの量に比例します。
お客様は、このソリューションの実行中に使用されるAWSサービスのコストについて責任を負います。予算の制約内に請求アラームが設定されていることを確認してください。
構成オプション：
ほぼ毎月のコストの崩壊は以下です（一部の無料ティアインクルージョンを除く）：
| サービス | 量 | コスト（コマーシャル） | コスト（govcloud） |
|---|---|---|---|
| VPC（C-0 + C-1/C-2/C-3/C-5、オプション） | 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ドル |
| Amazon APIゲートウェイ | 150000リクエスト | 0.16ドル | 0.19ドル |
| Amazon dynamodb | 750000の書き込み、146250リード、0.30 GBストレージ | $ 1.18 | 2.36ドル |
| AWSラムダ | 12000の招待状、2分の平均。期間、256 MBメモリ | 6ドル | 6ドル |
| AWSステップ関数 | 92400州の移行 | 2.21ドル | 2.65ドル |
| Amazon S3 | 10 GBストレージ、4000のプットリクエスト、4000の取得リクエスト | 0.26ドル | 0.41ドル |
| Amazon Rekognition | 9000画像分析、3つのカスタムラベル推論ユニット | $ 22.32 | n/a |
| Amazon Elastic Containerレジストリ | ECR（地域）40GB | 4ドル | 4ドル |
| Amazon Open Search ServerLess（C-2、デフォルト） | 2xインデックスOCU、2x検索OCU、100GBデータ | 703.20ドル | n/a |
| Amazon Open検索プロビジョニング（C-2、オプション） | 3x Data（R6G.Large.Search）、3x Master（R6G.Large.Search）、240GB EBS | 743.66ドル | 915.52ドル |
| Amazon Location Service（C-4、デフォルト） | 1000のマップタイルが取得されました | $ 40.00 | n/a |
以下は、展開にユースケース固有のパイプライン機能を含めるための追加コストです（C-5、オプション）：
| サービス | 量 | コスト（コマーシャル） | コスト（govcloud） |
|---|---|---|---|
| バッチファーゲート | 10時間の処理 | 3.56ドル | 4.88ドル |
| Amazon S3 | 300 GBのストレージ、30GBの転送 | 9.60ドル | $ 16.34 |
| Amazon CloudWatch | 1GBログ-VPCフローログ/APIゲートウェイ/パイプライン | 3.28ドル | $ 4.12 |
| アマゾンの岩盤 | 1Mトークン - クロードソネット | 18ドル | $ na |
| Amazon Rekognition | 10K画像処理 | 7.50ドル | 9ドル |
AWSインフラストラクチャにシステムを構築すると、セキュリティの責任がお客様とAWSの間で共有されます。 AWSがホストオペレーティングシステム、仮想化レイヤー、サービスが動作する施設の物理的セキュリティを含むコンポーネントを運用、管理、および制御するため、この共有責任モデルは運用上の負担を軽減します。 AWSセキュリティの詳細については、AWSクラウドセキュリティをご覧ください。
VAMは、この共有責任モデルの下で提供されます。顧客使用のカスタマイズは、AppSecレビューを使用して、変更が新しい脆弱性を導入しないことを確認する必要があります。実装するチームは、実装が適切なセキュリティレビューを受けることを確認する責任を負います。
webディレクトリでyarn audit実行します。 yarn audit fix実行して、重要なセキュリティの脆弱性を軽減します。組織のセキュリティチームとのすべての考慮事項を確認して、緩和が必要かどうかを判断してください。
サンプルコード。ソフトウェアライブラリ。コマンドラインツール。概念の証明;テンプレート;または、AWSの顧客契約に基づくAWSコンテンツ、またはお客様とAWSの間の関連する書面による契約（適用者のいずれか）に基づくAWSコンテンツとして提供される他の関連技術（当社の担当者によって提供される前述のいずれかを含む）が提供されます。このAWSコンテンツを生産口座、または生産またはその他の重要なデータで使用しないでください。特定の品質管理の実践と標準に基づいて、生産グレードの使用に適しているように、サンプルコードなどのAWSコンテンツをテスト、保護、および最適化する責任があります。 AWSコンテンツの展開は、Amazon EC2インスタンスの実行やAmazon S3ストレージの使用など、AWS充電可能なリソースを作成または使用するためのAWS料金が発生する場合があります。
貢献方法については、寄稿ファイルを参照してください。
プロジェクトのライセンスについては、ライセンスファイルを参照してください。
Copyright Amazon.com、Inc。またはその関連会社。無断転載を禁じます。
適用法で要求されていないか、書面で合意されていない限り、ライセンスに基づいて配布されたソフトウェアは、明示または黙示のいずれかの保証または条件なしに、「現状のまま」に基づいて配布されます。
