visual asset management system
v2.1.0
الإصدار 2.x+ نظام إدارة الأصول المرئية (VAMS) هو سلسلة الإصدار الرسمي المعترف به والمعتمد.
جميع إصدارات 1.x السابقة من VAMS ، على الرغم من أنها لا تزال متوفرة ، لن يتم دعمها أو الموصى بها للاستخدام.
نظام إدارة الأصول المرئية (VAMS) هو الحل الأصلي المصمم لهذا الغرض لإدارة وتوزيع الأصول البصرية المتخصصة المستخدمة في الحوسبة المكانية. يوفر VAMS حلاً مبسطًا للمؤسسات لاستقبال الأصول البصرية وتخزينها وإدارتها في السحابة ، والتي تمكن أي مستخدم من خلال متصفح ويب لتحميل الأصول المرئية وإدارتها وتصورها وتحويلها واستردادها. يمكن أيضًا ترحيل سير العمل الحالي الذي يستفيد من كل من الكود المخصص والتطبيقات التي تم بناؤها مسبقًا أو تابعة لجهة خارجية إلى VAMS وتشغيلها في سحابة AWS ، بدلاً من أن تكون محدودة من خلال القدرة المحلية المتاحة. VAMS قابلة للتخصيص وقابلة للتوسيع مع خيار تم تصميمه بشكل أكبر إلى حالات الاستخدام المحددة من قبل فرق التطوير.
قيمة العميل: تعالج VAMS التحديات التي يواجهها العملاء الذين يشرعون في مبادرات الحوسبة المكانية ، مثل الواقع المعزز والظاهري (AR/VR). يمكن للمنظمات التي كان عليها سابقًا إدارة هذه الأصول على الأنظمة المحلية القيام بذلك من تطبيق على الويب.
الاستفادة من خدمة التخزين Amazon البسيطة (Amazon S3) كطبقة تخزين منخفضة التكلفة وارتفاع توفر ، توفر VAMS واجهة برمجة تطبيقات مصممة لهذا الغرض لإدارة الأصول ثلاثية الأبعاد. يوفر واجهة برمجة التطبيقات هذه طبقة من التجريد ، مما يسمح ببناء عمليات تكامل مخصصة. تتيح التكامل المخصص نقل أعباء العمل والتطبيقات إلى السحابة ، وإلغاء الوصول إلى اتساع وعمق نظام AWS الكامل.
بشكل عام ، تأتي VAMS Super Power من استخدامها لخدمات AWS المشتركة ، ومنطق المصدر المفتوح ، والتوسيع لإضافته إلى البنية والحلول والاستراتيجيات الأخرى.
حالات الاستخدام: تشمل حالات استخدام العينة التي استفادت من التكرارات المبكرة لـ VAM:
تتكامل VAMS حاليًا مع العديد من مشاهدي الأصول المختلفين ويدعم التنسيقات التالية لعرض الأصول ثلاثية الأبعاد بشكل تفاعلي.
| اسم | امتداد | يكتب | مشاهد | المكتبة المستبعدة | ملحوظات |
|---|---|---|---|---|---|
| واجهة الموجة | OBJ | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| 3D Studio | 3DS | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| تصوير مجسم | STL | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| تصوير مجسم | STL | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| GLTF | GLTF | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| GLTF | GLB | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| تنسيق ملف الكائن | عن | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| تنسيق ملف الكائن | عن | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| dotbim | بيم | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| Rhinoceros 3D | 3DM | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| Filmbox | FBX | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| Filmbox | FBX | ثنائي | عارض ثلاثي الأبعاد على الانترنت | ||
| كولادا | داي | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| لغة نمذجة الواقع الافتراضي | WRL | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| تنسيق التصنيع ثلاثي الأبعاد | 3MF | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| التصنيع المضافة | AMF | نص | عارض ثلاثي الأبعاد على الانترنت | ||
| (مستبعد*) dotbim | IFC | نص | عارض ثلاثي الأبعاد عبر الإنترنت* | ويب IFC | |
| (مستبعد*) Freecad | FCSTD | نص | عارض ثلاثي الأبعاد عبر الإنترنت* | occt-import-js | |
| (مستبعد*) الحدود مندوب | بريب | نص | عارض ثلاثي الأبعاد عبر الإنترنت* | occt-import-js | |
| (مستبعد*) ISO 10303 CAD | خطوة | نص | عارض ثلاثي الأبعاد عبر الإنترنت* | occt-import-js | |
| (مستبعد*) تبادل الرسومات | Iges | نص | عارض ثلاثي الأبعاد عبر الإنترنت* | occt-import-js | |
| Point Cloud - تبادل بيانات Lidar | لاز | ثنائي | عارض Potree | ||
| Point Cloud - تبادل بيانات Lidar | لاس | ثنائي | عارض Potree | ||
| Point Cloud - تبادل بيانات Lidar | E57 | ثنائي | عارض Potree | ||
| تنسيق ملف polygon | رققة | ثنائي | عارض Potree | اكتب المتاجر الشبكات والغيوم النقطية - يظهر VAMs حاليًا عارض السحابة النقطة فقط للرقفية | |
| تنسيق ملف polygon | رققة | نص | عارض Potree |
يشمل المشاهدون المتاحون:
يرجى ملاحظة:
استبعاد* ملاحظات:
onlineViewer3DFileFormats في ./web/src/common/constants/fileFormats.js . ثم أضف مكتبة NPM المستبعدة المدرجة في مجلد الويب من خلال yarn add . تحذير هذا الحل يتيح لك التفاعل مع مكتبات برامج الطرف الثالث ونماذج AI (GAI) التوليدية من مقدمي خدمات الطرف الثالث. يخضع استخدامك لمكتبات البرمجيات ونماذج GAI من طرف ثالث للشروط المقدمة لك من قبل مكتبة البرامج الثالثة ومقدمي طرازات GAI عند الحصول على ترخيصك لاستخدامها (على سبيل المثال ، شروط الخدمة ، اتفاقية الترخيص الخاصة بهم ، والاستخدام المقبول سياسة ، وسياسة الخصوصية).
أنت مسؤول عن التأكد من أن استخدامك لمكتبات برامج الطرف الثالث ونماذج GAI يتوافق مع المصطلحات التي تحكمها ، وأي قوانين أو قواعد أو لوائح أو سياسات أو معايير تنطبق عليك.
أنت أيضًا مسؤول عن إجراء تقييمك المستقل لمكتبات برامج الطرف الثالث ونماذج GAI التي تستخدمها ، بما في ذلك مخرجاتها وكيف يستخدم مقدمي خدمات GAI لجهات خارجية أي بيانات قد يتم نقلها إليها بناءً على النشر الخاص بك إعدادات. لا تقدم AWS أي تعهدات أو ضمانات أو ضمانات فيما يتعلق بمكتبات برامج الطرف الثالث ونماذج GAI ، والتي هي "محتوى طرف ثالث" بموجب اتفاقك مع AWS. يتم تقديم هذا الحل لك كـ "محتوى AWS" بموجب اتفاقك مع AWS.
تتغير قاعدة كود VAMS بشكل متكرر ونوصيك بالخروج من الإصدار المستقر الذي تم إصداره من Github.
بالنسبة للنشرات المباشرة لـ Windows ، قد تكون هناك حاجة إلى بعض التغييرات إلى الإرشادات أدناه في كيفية تحديد متغيرات البيئة في سطر الأوامر.
يمكنك تحديد الإصدارات المستقرة من خلال علامتها. قم بإحضار العلامات 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 Daemon.
yarn install - تأكد من تثبيت الحزم المطلوبة بواسطة تطبيق الويب (تدوين الملاحظة ، لا يؤدي npm install إلى بناء عمل للتطبيق - يرجى استخدام الغزل).
npm run build - إنشاء تطبيق الويب.
cd ../infra && npm install - تثبيت التبعيات المحددة في package.json.
إذا لم تكن قد قمت بالفعل بتمهيد حساب AWS الخاص بك مع CDK. cdk bootstrap aws://101010101010/us-east-1 استبدل بحسابك والمنطقة. إذا كنت تقوم بتشويش حساب GovCloud ، فقم بتشغيل export AWS_REGION=[gov-cloud-region] حيث يجب أن يتم إبلاغ AWS SDK باستخدام نقاط نهاية GovCloud. ملاحظة: استخدم دور AWS IAM الأقل سهرة لـ Boostrapping الذي لا يزال بإمكانه إنشاء مكونات AWS المطلوبة من CloudFormation for VAMs.
قم بتعديل config.json في /infra/config لتعيين معلمات نشر VAMS والميزات التي ترغب في نشرها. الحقول الدنيا الموصى بها للتحديث هي region و adminEmailAddress و baseStackName عند استخدام القالب الافتراضي المقدم. يمكن العثور على مزيد من المعلومات حول خيارات التكوين في دليل التكوين.
(اختياري) تجاوز اسم مكدس CDK ومنطقة النشر مع متغيرات البيئة export AWS_REGION=us-east-1 && export STACK_NAME=dev استبدل المنطقة التي ترغب في نشرها والاسم الذي تريد ربطه مع CloudFormation مكدس أن CDK سوف تنشر.
(تستخدم FIPs فقط) إذا نشرت مع FIPS ، تمكين متغيرات بيئة FIPS لـ AWS CLI export AWS_USE_FIPS_ENDPOINT=true وتمكين app.useFips في ملف تكوين config.json في /infra/config
(استيراد VPC الخارجي فقط) إذا استيراد VPC خارجي مع شبكات فرعية في تكوين config.json ، قم بتشغيل cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true لاستيراد معرف VPC/الشبكة الفرعية ونشر جميع -vpc التابعة المداخن أولا. الفشل في تشغيل هذا من خلال إعداد السياق أو إعداد التكوين لـ loadContextIgnoreVPCStacks سيؤدي إلى فشل النشر النهائي لجميع خطوات المداخن. انظر دليل التكوين لاستيراد VPC على استكشاف الأخطاء وإصلاحها إضافية. ملاحظة: راجع قسم الملاحظات الإضافية لدليل التكوين لـ # من IPs المطلوب لكل شبكة فرعية.
cdk deploy --all --require-approval never -يتم إنشاء حساب في مجموعة مستخدمين AWS Cognito باستخدام عنوان البريد الإلكتروني المحدد في ملف تكوين البنية التحتية. توقع بريدًا إلكترونيًا من [email protected] مع كلمة مرور مؤقتة.
10A. تأكد من أن Docker يعمل قبل النشر كحاوية ، ستحتاج إلى بناء
1.A (الافتراضي) (نشر CloudFront) انتقل إلى عنوان URL المقدم في {stackName].WebAppCloudFrontDistributionDomainName{uuid} من إخراج cdk deploy .
1.B (ميزة نشر ALB) انتقل إلى عنوان URL المتوفر في webDistributionUrl من إخراج cdk deploy .
تحقق من البريد الإلكتروني للحصول على كلمة مرور الحساب المؤقت لتسجيل الدخول بعنوان البريد الإلكتروني الذي قدمته.
(اختياري) اتبع إنشاء مستخدم VAMS جديد في دليل الإذن لإضافة مستخدمين إضافيين
يمكنك تغيير المنطقة ونشر مثيل جديد من VAMs عن طريق تغيير ./infra/config/config.json أو تعيين متغيرات البيئة على قيم جديدة ( export AWS_REGION=us-east-1 && export STACK_NAME=dev ) ثم التشغيل npm run deploy.dev مرة أخرى.
لنشر المخصصات أو التحديثات على VAMS ، يمكنك تحديث المكدس عن طريق تشغيل cdk deploy --all --require-approval never . يتم إنشاء تغييرات ونشرها في مكدتك.
يرجى ملاحظة ، بناءً على التغييرات التي يتم إجراؤها في الطيران ، قد لا تكون VAMs متاحة للمستخدمين جزئيًا أو كليًا أثناء النشر. يرجى قراءة سجل التغيير بعناية واختبار التغييرات قبل تعريض المستخدمين لإصدارات جديدة.
من الممكن أن يتم ترقية VAMs بين تغييرات الإصدار الرئيسي ، وتحديثات التكوين الرئيسية (تغييرات مفتاح KMS CMK ، أو سحابة -> مفاتيح ALB ، وما إلى ذلك) ، أو إعادة نشر المداخن إلى منطقة مختلفة لاستخدام نشر A/B باستخدام 
طريق. لاحظ أنه عند استخدام خيار تكوين ALL ، ستكون هناك حاجة إلى نشر مكدس A/B المعدل.
لاحظ أنه لا ينبغي استخدام هذا لترقيات إصدار VAMS أو عمليات نشر A/B التي يجب أن تتبع الإرشادات في .
يمكن نشر VAMs مع معلمة تكوين دلو التدريج لتمكين النسخ من دلو الأصول الحالي.
للنشر مع دلو التدريج ، فقط قم بتعيين app.bucketMigrationStaging.assetBucketName معلمة التكوين في ./infra/config/config.json على نشر CDK الخاص بك وسوف يسجل VAMS دلوك الحالي كدلو التدريجي.
بمجرد اكتمال النشر ، يمكنك استدعاء /assets/uploadAssetWorkflow API لبدء نسخ الأصول إلى دلو VAMS S3 وتسجيل الأصول.
يرجى الرجوع إلى uploadassetworkflow في مستندات API لمعرفة جسم طلب API.
يسمح الواجهة الخلفية لـ VAMS بالتكوين الأساسي إلى المتقدم بناءً على البيئة وحاجة الاستخدام.
انظر دليل التكوين للحصول على التعليمات.
يستخدم VAMS نظام إذن التحكم في الوصول (ABAC/RBAC) المستند إلى السمات على رأس المصادقة للتحكم في الوصول الدقيق للوصول إلى وظائف الحلول وعناصر البيانات المختلفة.
انظر دليل الأذونات لكيفية استخدام نظام إذن VAMS.
تتكون الواجهة الخلفية VAMS من وظائف AWS Lambda التي يتم الوصول إليها من خلال بوابة API AWS.
تعتبر خطوط الأنابيب ميزة في VAMs تسمح لك بالتحرير 
VAMS Frontend هو تطبيق ReactJS صفحة واحدة. يمكن نشره عبر CloudFront أو Alb
يتم تفويض VAMS API والواجهة الأمامية من خلال حسابات مستخدمي AWS Cognito افتراضيًا.
المصادقة الاتحادية مع SAML متوفرة مع تكوين إضافي. انظر مصادقة SAML في دليل المطور للحصول على التعليمات.
| عنصر | مجلد |
|---|---|
| تطبيق الويب | الويب |
| نشر CDK | ظهور |
| API والخلفية | الخلفية |
| استخدام خط أنابيب الاستخدام | backendpipleines |
الخروج من ورشة VAMS لتجول مفصل
لمعرفة المزيد حول كيفية عمل VAMS وللتعليمات المتعلقة بتكوين خطوط الأنابيب وسير العمل ، راجع دليل مطور دليل المطورين.
الرجوع إلى 
.
cdk destroy --all من مجلد Infra.يمكن فهم تكاليف هذا الحل على أنها تكاليف تخزين ثابتة وتكاليف متغيرة لخطوط الأنابيب التي تقوم بتكوينها. تتناسب تكلفة التخزين مع كمية البيانات التي تقوم بتحميلها إلى VAMs بما في ذلك البيانات الجديدة التي تقوم بإنشائها باستخدام خطوط أنابيب VAMS.
أنت مسؤول عن تكلفة خدمات 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 ، افتراضي) | الأول 1 تيرابايت - مدرج في الطبقة الحرة | 0.00 دولار | ن/أ |
| Amazon Alb (C-1 ، اختياري) | 1 ALB ، 1 تيرابايت معالجتها | 24.43 دولار | 52.56 دولار |
| Amazon API Gateway | 150000 طلب | 0.16 دولار | 0.19 دولار |
| Amazon DynamoDB | 750000 يكتب ، 146250 قراءة ، تخزين 0.30 جيجا بايت | 1.18 دولار | 2.36 دولار |
| AWS Lambda | 12000 دعوة ، 2 دقيقة متوسط. المدة ، ذاكرة 256 ميغابايت | 6 دولارات | 6 دولارات |
| وظائف الخطوة AWS | 92400 تحولات الدولة | 2.21 دولار | 2.65 دولار |
| Amazon S3 | تخزين 10 غيغابايت ، 4000 طلب ، 4000 الحصول على طلبات | 0.26 دولار | 0.41 دولار |
| Amazon Rekognition | 9000 تحليل الصور ، 3 وحدات استنتاج التسمية المخصصة | 22.32 دولار | ن/أ |
| سجل حاويات أمازون مرن | ECR (في المنطقة) 40 جيجابايت | 4 دولارات | 4 دولارات |
| Amazon Open Search Serverless (C-2 ، افتراضي) | 2x Index OCU ، 2x Search OCU ، بيانات 100 جيجابايت | 703.20 دولار | ن/أ |
| Amazon Open Search Soviceed (C-2 ، اختياري) | بيانات 3x (r6g.large.search) ، 3x Master (r6g.large.search) ، 240 جيجابايت EBs | 743.66 دولار | 915.52 دولار |
| خدمة موقع أمازون (C-4 ، افتراضي) | تم استرداد 1000 بلاط خريطة | 40.00 دولار | ن/أ |
فيما يلي التكاليف الإضافية لإدراج ميزات خطوط أنابيب محددة لحالة الاستخدام في النشر (C-5 ، اختياري):
| خدمة | كمية | التكلفة (التجارية) | التكلفة (GovCloud) |
|---|---|---|---|
| دفعة فارغيت | 10 ساعات من المعالجة | 3.56 دولار | 4.88 دولار |
| Amazon S3 | تخزين 300 جيجابايت ، نقل 30 جيجابايت | 9.60 دولار | 16.34 دولار |
| Amazon CloudWatch | سجلات 1 جيجابايت - خط أنابيب/خط أنابيب بوابة/خط أنابيب | 3.28 دولار | 4.12 دولار |
| Amazon Bedrock | 1M الرموز - كلود سونيت | 18 دولار | $ na |
| Amazon Rekognition | 10K معالجة الصور | 7.50 دولار | 9 دولارات |
عندما تقوم ببناء أنظمة على البنية التحتية لـ AWS ، تتم مشاركة مسؤوليات الأمن بينك وبين AWS. هذا نموذج المسؤولية المشتركة يقلل من عبء التشغيل الخاص بك لأن AWS تعمل ، وتدير ، والتحكم في المكونات بما في ذلك نظام التشغيل المضيف ، وطبقة المحاكاة الافتراضية ، والأمان المادي للمرافق التي تعمل فيها الخدمات. لمزيد من المعلومات حول AWS Security ، تفضل بزيارة AWS Cloud Security.
يتم توفير VAMS ضمن نموذج المسؤولية المشتركة هذا. يجب أن يمر أي تخصيص لاستخدام العملاء من خلال مراجعة AppSec لتأكيد التعديلات التي لا تقدم نقاط الضعف الجديدة. يتحمل أي فريق تنفيذ مسؤولية ضمان أن تنفيذها قد مر بمراجعة أمنية مناسبة.
yarn audit في دليل web قبل نشر الواجهة الأمامية لضمان تحديث جميع الحزم. قم بتشغيل yarn audit fix للتخفيف من ثغرات الأمن الحرجة.يرجى مراجعة جميع الاعتبارات مع فرق أمان المؤسسات الخاصة بك لتحديد ما إذا كانت التخفيفات مطلوبة.
رمز العينة ؛ مكتبات البرمجيات ؛ أدوات سطر الأوامر ؛ أدلة المفهوم ؛ قوالب أو غيرها من التكنولوجيا ذات الصلة (بما في ذلك أي من ما سبق المقدمة من قبل موظفينا) يتم توفيرها لك كمحتوى AWS بموجب اتفاقية عميل AWS ، أو الاتفاقية المكتوبة ذات الصلة بينك وبين AWS (أيهما ينطبق). يجب ألا تستخدم محتوى AWS هذا في حسابات الإنتاج الخاصة بك ، أو على الإنتاج أو البيانات الهامة الأخرى. أنت مسؤول عن اختبار محتوى AWS وتأمينه وتحسينه ، مثل رمز العينة ، حسب الاقتضاء لاستخدام درجة الإنتاج بناءً على ممارسات ومعايير مراقبة الجودة المحددة. قد يتحمل نشر محتوى AWS رسوم AWS لإنشاء أو استخدام موارد AWS ، مثل تشغيل مثيلات Amazon EC2 أو استخدام تخزين Amazon S3.
راجع الملف المساهم حول كيفية المساهمة.
راجع ملف الترخيص لترخيص مشروعنا.
حقوق الطبع والنشر Amazon.com ، Inc. أو الشركات التابعة لها. جميع الحقوق محفوظة.
ما لم يكن مطلوبًا بموجب القانون المعمول به أو الموافقة على الكتابة ، يتم توزيع البرامج الموزعة بموجب الترخيص على أساس "كما هي" ، دون ضمانات أو شروط من أي نوع ، إما صريحة أو ضمنية.
