visual asset management system
v2.1.0
Visual Asset Management System (VAMS) version 2.x + est la série de versions officielle reconnue et approuvée.
Toutes les versions 1.x précédentes de VAM, bien que toujours disponibles, ne seront plus prises en charge ou recommandées pour une utilisation.
Le système de gestion des actifs visuels (VAMS) est une solution native AWS spécialement conçue pour la gestion et la distribution d'actifs visuels spécialisés utilisés dans l'informatique spatiale. VAMS propose une solution simplifiée pour que les organisations ingérent, stockent et gèrent des actifs visuels dans le cloud, qui permet à tout utilisateur un navigateur Web de télécharger, gérer, visualiser, transformer et récupérer des actifs visuels. Les workflows existants qui tirent parti du code personnalisé et des applications pré-construites ou tierces peuvent également être migrés vers les VAM et exécutés dans le cloud AWS, au lieu d'être limité par la capacité sur site disponible. VAMS est personnalisable et extensible avec l'option d'être plus adapté à des cas d'utilisation spécifiques par les équipes de développement.
Valeur client: VAMS relève des défis auxquels sont confrontés les clients qui se lancent dans des initiatives informatiques spatiales, telles que la réalité augmentée et virtuelle (AR / VR). Les organisations qui devaient auparavant gérer ces actifs sur les systèmes locaux peuvent désormais le faire à partir d'une application Web.
Tirant le service de stockage Amazon Simple (Amazon S3) en tant que couche de stockage à haute disponibilité à faible coût, VAMS fournit une API spécialement conçue pour la gestion des actifs 3D. Cette API fournit une couche d'abstraction, permettant de construire des intégrations personnalisées. Les intégrations personnalisées permettent de déplacer les charges de travail et les applications vers le cloud, déverrouillant l'accès à toute l'étendue et la profondeur de l'écosystème AWS.
Dans l'ensemble, VAMS Super Power provient de son utilisation des services AWS communs, de la logique open source et de l'extensibilité pour ajouter ou se combiner avec d'autres architectures, solutions et stratégies.
Cas d'utilisation: Les échantillons de cas d'utilisation qui ont mis à profit les itérations précoces des VAM comprennent:
VAMS s'intègre actuellement à plusieurs téléspectateurs d'actifs différents et prend en charge les formats suivants pour afficher les actifs 3D de manière interactive.
| Nom | Extension | Taper | Téléspectateur | Bibliothèque exclue | Notes |
|---|---|---|---|---|---|
| Front de vague | obj | texte | Visionneur en ligne 3D | ||
| Studio 3D | 3DS | binaire | Visionneur en ligne 3D | ||
| Stéréolithographie | STL | texte | Visionneur en ligne 3D | ||
| Stéréolithographie | STL | binaire | Visionneur en ligne 3D | ||
| gltf | gltf | texte | Visionneur en ligne 3D | ||
| gltf | glb | binaire | Visionneur en ligne 3D | ||
| Format de fichier d'objet | désactivé | texte | Visionneur en ligne 3D | ||
| Format de fichier d'objet | désactivé | binaire | Visionneur en ligne 3D | ||
| Dotbim | bim | texte | Visionneur en ligne 3D | ||
| Rhinocéros 3D | 3dm | binaire | Visionneur en ligne 3D | ||
| Boîte de film | fbx | texte | Visionneur en ligne 3D | ||
| Boîte de film | fbx | binaire | Visionneur en ligne 3D | ||
| Collada | dae | texte | Visionneur en ligne 3D | ||
| Langue de modélisation de la réalité virtuelle | wrl | texte | Visionneur en ligne 3D | ||
| Format de fabrication 3D | 3mf | texte | Visionneur en ligne 3D | ||
| Fabrication additive | AMF | texte | Visionneur en ligne 3D | ||
| (Exclu *) dotbim | IFC | texte | Visionneuse 3D en ligne * | web-ifc | |
| (Exclu *) Freecad | fcstd | texte | Visionneuse 3D en ligne * | oct-import-js | |
| (Exclu *) Représentant des limites | bizarre | texte | Visionneuse 3D en ligne * | oct-import-js | |
| (Exclu *) ISO 10303 CAD | étape | texte | Visionneuse 3D en ligne * | oct-import-js | |
| (Exclu *) Exchange graphique | igies | texte | Visionneuse 3D en ligne * | oct-import-js | |
| Cloud de points - Échange de données Lidar | laz | binaire | Visionneuse de poreille | ||
| Cloud de points - Échange de données Lidar | Las | binaire | Visionneuse de poreille | ||
| Cloud de points - Échange de données Lidar | E57 | binaire | Visionneuse de poreille | ||
| Format de fichier polygone | pli | binaire | Visionneuse de poreille | Type Stores Meshs and Point Clouds - VAMS affiche actuellement uniquement la visionneuse de nuages de points pour PLY | |
| Format de fichier polygone | pli | texte | Visionneuse de poreille |
Les téléspectateurs disponibles comprennent:
Veuillez prendre note:
Exclusion * Remarques:
onlineViewer3DFileFormats dans ./web/src/common/constants/fileFormats.js . Ensuite, ajoutez la bibliothèque NPM exclue répertoriée dans le dossier Web via yarn add . AVERTISSEMENT Cette solution vous permet d'interagir avec des bibliothèques de logiciels tierces et des modèles générateurs d'IA (GAI) des fournisseurs tiers. Votre utilisation des bibliothèques de logiciels et des modèles GAI tiers est régie par les termes qui vous sont fournis par la bibliothèque de logiciels tiers et les fournisseurs de modèles GAI lorsque vous avez acquis votre licence pour les utiliser (par exemple, leurs conditions d'utilisation, leur contrat de licence , politique d'utilisation acceptable et politique de confidentialité).
Vous êtes responsable de vous assurer que votre utilisation des bibliothèques de logiciels tierces et des modèles GAI respecte les termes qui les régissent, et toutes les lois, règles, réglementations, politiques ou normes qui s'appliquent à vous.
Vous êtes également chargé de faire votre propre évaluation indépendante des bibliothèques de logiciels tierces et des modèles GAI que vous utilisez, y compris leurs sorties et comment les bibliothèques de logiciels tierces GAI utilisent toutes les données qui pourraient leur être transmises en fonction de votre déploiement configuration. AWS ne fait aucune représentation, garantie ou garantie concernant les bibliothèques de logiciels tierces et les modèles GAI, qui sont un «contenu tiers» en vertu de votre accord avec AWS. Cette solution vous est proposée en tant que «contenu AWS» en vertu de votre accord avec AWS.
VAMS CodeBase change fréquemment et nous vous recommandons de vérifier la version publiée stable de GitHub.
Pour les déploiements Windows directs, certaines modifications peuvent être nécessaires aux instructions ci-dessous sur la façon de spécifier les variables d'environnement sur la ligne de commande.
Vous pouvez identifier des versions stables par leur balise. Reprochez les balises git fetch --all --tags , puis git checkout tags/TAG ou git checkout -b TAG tags/TAG où est la balise réelle souhaitée. Une liste de balises est trouvée en exécutant git tag --list ou sur la page des versions.
Remarque: Si vous utilisez un proxy SSL HTTPS qui nécessite que les nœuds réseau disposent d'un certificat SSL personnalisé, rendez-vous au déploiement CDK SSL dans le Guide du développeur pour en savoir plus.
cd ./web && nvm use - Assurez-vous que votre version nœud correspond au projet. Assurez-vous que Docker Daemon est en cours d'exécution.
yarn install - Assurez-vous d'installer les packages requis par l'application Web (prenez note, npm install ne se traduit pas par une génération de travail de l'application - veuillez utiliser le fil).
npm run build - Build l'application Web.
cd ../infra && npm install - Installe les dépendances définies dans package.json.
Si vous n'avez pas déjà amorti votre compte AWS avec CDK. cdk bootstrap aws://101010101010/us-east-1 - Remplacez par votre compte et votre région. Si vous obligez un compte GovCloud, exécutez export AWS_REGION=[gov-cloud-region] car le SDK AWS doit être informé pour utiliser les points de terminaison GovCloud. Remarque: Utilisez le rôle AWS IAM le moins permissif pour le boostrapping qui peut toujours générer les composants AWS nécessaires de CloudFormation pour VAMS.
Modifiez le config.json dans /infra/config pour définir les paramètres et fonctionnalités de déploiement VAM que vous souhaitez déployer. Les champs minimaux recommandés à mettre à jour sont region , adminEmailAddress et baseStackName lors de l'utilisation du modèle fourni par défaut. Plus d'informations sur les options de configuration peuvent être trouvées dans le guide de configuration.
(Facultatif) remplacer le nom et la région de la pile CDK pour le déploiement avec des variables d'environnement export AWS_REGION=us-east-1 && export STACK_NAME=dev - Remplacez par la région que vous souhaitez déployer et le nom que vous souhaitez associer à la CloudFormation empiler que le CDK déploiera.
(FIPS utilise uniquement) Si le déploiement avec FIPS, activez les variables d'environnement FIPS pour AWS CLI export AWS_USE_FIPS_ENDPOINT=true et activer app.useFips dans le fichier de configuration config.json dans /infra/config
(Importation VPC externe uniquement) Si l'importation d'un VPC externe avec des sous-réseaux dans la configuration config.json , exécutez cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true -VPC dépend des piles d'abord. Le défaut de l'exécuter avec le paramètre de contexte ou le paramètre de configuration de loadContextIgnoreVPCStacks entraînera l'échec du déploiement final de toutes les étapes de piles. Voir Guide de configuration pour l'importation de VPC sur le dépannage supplémentaire. Remarque: passez en revue la section Notes supplémentaires du Guide de configuration pour le # d'IPS nécessaire par sous-réseau.
cdk deploy --all --require-approval never - Un compte est créé dans un pool d'utilisateurs AWS Cognito utilisant l'adresse e-mail spécifiée dans le fichier de configuration de l'infrastructure. Attendez-vous à un e-mail de [email protected] avec un mot de passe temporaire.
10A. Assurez-vous que Docker s'exécute avant le déploiement en tant que conteneur devra être construit
1.A (default) (CloudFront Deployment) Naviguez vers l'URL fournie dans {stackName].WebAppCloudFrontDistributionDomainName{uuid} à partir de la sortie cdk deploy .
1.B (fonction de déploiement ALB) accédez à l'URL fournie dans webDistributionUrl à partir de la sortie cdk deploy .
Vérifiez le mot de passe du compte temporaire pour vous connecter avec l'adresse e-mail que vous avez fournie.
(Facultatif) Suivre Créer un nouvel utilisateur VAMS dans le guide d'autorisation pour ajouter des utilisateurs supplémentaires
Vous pouvez modifier la région et déployer une nouvelle instance de VAMS en modifiant le ./infra/config/config.json ou en définissant les variables d'environnement sur de nouvelles valeurs ( export AWS_REGION=us-east-1 && export STACK_NAME=dev ) npm run deploy.dev à nouveau.
Pour déployer des coutumes ou des mises à jour de VAMS, vous pouvez mettre à jour la pile en exécutant cdk deploy --all --require-approval never . Un ensemble de modifications est créé et déployé sur votre pile.
Veuillez noter que, selon les modifications en vol, les VAM peuvent ne pas être disponibles pour les utilisateurs en partie ou dans son ensemble pendant le déploiement. Veuillez lire attentivement le journal de modification et tester les modifications avant d'exposer vos utilisateurs à de nouvelles versions.
Il est recommandé que les VAM soient mis à niveau entre les modifications de version majeure, les principales mises à jour de configuraiton (modifications de clé KMS CMK, CloudFront -> ALB commutateurs, etc.), ou redéployer des piles dans une autre région pour utiliser un déploiement A / B à l'aide du 
chemin. Notez que lors de l'utilisation de l'option de configuration ALB, un déploiement de pile A / B modifié sera nécessaire.
Remarque Cela ne doit pas être utilisé pour les mises à niveau de la version VAMS ou les déploiements A / B qui doivent suivre les instructions dans .
Les VAM peuvent être déployés avec un paramètre de configuration de seau de mise en scène pour activer la copie à partir d'un seau d'actif existant.
Pour déployer avec un seau de mise en scène, définissez simplement le paramètre de configuration app.bucketMigrationStaging.assetBucketName dans ./infra/config/config.json à votre déploiement CDK et VAMS enregistrera votre godet existant en tant que godet de mise en scène.
Une fois le déploiement terminé, vous pouvez invoquer l'API /assets/uploadAssetWorkflow pour commencer à copier les actifs dans le seau VAMS S3 et à enregistrer les actifs.
Veuillez vous référer à la FOLOLOTALASTWORKFLOW dans les documents API pour en savoir plus sur le corps de la demande de l'API.
Le backend VAMS permet une configuration de base à avancée en fonction de l'environnement et du besoin d'utilisation des cas.
Voir Guide de configuration pour les instructions.
VAMS utilise un système d'autorisation de contrôle d'accès basé sur des attributs / basés sur les rôles (ABAC / RBAC) en plus d'authentification pour contrôler l'accès à grain fin à diverses fonctionnalités de solution et éléments de données.
Voir Guide des autorisations pour utiliser le système d'autorisation VAMS.
Le backend VAMS est composé de fonctions AWS Lambda accessibles via une passerelle API AWS.
Les pipelines sont une fonctionnalité dans les VAM qui vous permettent de modifier 
VAMS Frontend est une application ReactJS à une seule page. Il peut être déployé via CloudFront ou Alb
L'API VAMS et Frontend sont autorisées par défaut via AWS Cognito User Comptes.
L'authentification fédérée avec SAML est disponible avec une configuration supplémentaire. Voir l'authentification SAML dans le Guide du développeur pour les instructions.
| composant | dossier |
|---|---|
| application Web | web |
| Déploiement de CDK | infra |
| API et backend | backend |
| Backend du pipeline à caser | backendpipelines |
Découvrez l'atelier VAMS pour une procédure détaillée
Pour en savoir plus sur le fonctionnement des VAMS et pour les instructions sur la configuration de Pipeline & Workflow, reportez-vous au Guide du développeur Guide du développeur.
Reportez-vous au 
.
cdk destroy --all du dossier infra.Les coûts de cette solution peuvent être compris comme des coûts de stockage fixes et des coûts variables des pipelines que vous configurez. Le coût de stockage est proportionnel à la quantité de données que vous téléchargez vers VAMS, y compris les nouvelles données que vous créez à l'aide de pipelines VAMS.
Vous êtes responsable du coût des services AWS utilisés lors de l'exécution de cette solution. Assurez-vous que vous avez des alarmes de facturation définies dans les contraintes de votre budget.
Options de configuration:
Une ventilation mensuelle approximative est ci-dessous (à l'exclusion de certaines inclusions de niveau gratuit):
| Service | Quantité | Coût (commercial) | Coût (GovCloud) |
|---|---|---|---|
| VPC (C-0 + C-1 / C-2 / C-3 / C-5, facultatif) | 1-11x points de terminaison par AZ (jusqu'à 3 AZ) - en fonction des options de configuration | $ <240,91 | $ <311,13 |
| Amazon CloudFront (C-1, par défaut) | Premier 1 To - inclus dans le niveau libre | 0,00 $ | N / A |
| Amazon Alb (C-1, facultatif) | 1 alb, 1 To traité | 24,43 $ | 52,56 $ |
| Passerelle API Amazon | 150000 demandes | 0,16 $ | 0,19 $ |
| Amazon DynamoDB | 750000 écrites, 146250 lectures, 0,30 Go de stockage | 1,18 $ | 2,36 $ |
| AWS Lambda | 12000 invocations, 2 minutes AVG. durée, 256 Mo de mémoire | 6 $ | 6 $ |
| Fonctions de pas AWS | 92400 transitions d'état | 2,21 $ | 2,65 $ |
| Amazon S3 | 10 Go de stockage, 4000 demandes de put, 4000 demandes Get | 0,26 $ | 0,41 $ |
| Amazon Rekognition | 9000 Analyse d'image, 3 unités d'inférence sur l'étiquette personnalisée | 22,32 $ | N / A |
| Registre des conteneurs élastiques Amazon | ECR (dans la région) 40 Go | 4 $ | 4 $ |
| Amazon Open Search Serverless (C-2, par défaut) | 2x index OCU, 2x Search OCU, 100 Go de données | 703,20 $ | N / A |
| Amazon Open Search Provisioned (C-2, Facultatif) | 3x données (r6g.large.search), 3x Master (r6g.large.search), 240 Go EBS | 743,66 $ | 915,52 $ |
| Amazon Location Service (C-4, par défaut) | 1000 carreaux de carte récupérés | 40,00 $ | N / A |
Vous trouverez ci-dessous les coûts supplémentaires pour inclure des fonctionnalités de pipeline spécifiques à des cas d'utilisation dans votre déploiement (C-5, facultatif):
| Service | Quantité | Coût (commercial) | Coût (GovCloud) |
|---|---|---|---|
| Lot fargate | 10 heures de traitement | 3,56 $ | 4,88 $ |
| Amazon S3 | Rangement de 300 Go, transfert de 30 Go | 9,60 $ | 16,34 $ |
| Amazon CloudWatch | 1 Go de journaux - VPC Flowlogs / passerelle API / pipeline | 3,28 $ | 4,12 $ |
| Bouilloire Amazon | Tokens 1m - Claude Sonnet | 18 $ | $ Na |
| Amazon Rekognition | Traitement d'image 10k | 7,50 $ | 9 $ |
Lorsque vous créez des systèmes sur l'infrastructure AWS, les responsabilités de sécurité sont partagées entre vous et AWS. Ce modèle de responsabilité partagée réduit votre charge opérationnelle car AWS exploite, gère et contrôle les composants, y compris le système d'exploitation hôte, la couche de virtualisation et la sécurité physique des installations dans lesquelles les services fonctionnent. Pour plus d'informations sur la sécurité AWS, visitez AWS Cloud Security.
VAMS est fourni dans ce modèle de responsabilité partagée. Toute personnalisation pour l'utilisation du client doit passer par une revue AppSec pour confirmer que les modifications n'introduisent pas de nouvelles vulnérabilités. Toute mise en œuvre de l'équipe assume la responsabilité de garantir que sa mise en œuvre a subi un examen de sécurité approprié.
yarn audit dans le répertoire web avant de déployer le frontal pour s'assurer que tous les packages sont à jour. Exécutez yarn audit fix pour atténuer les vulnérabilités de sécurité critiques.Veuillez consulter toutes les considérations avec les équipes de sécurité de vos organisations pour déterminer si des atténuations sont nécessaires.
L'exemple de code; bibliothèques de logiciels; outils de ligne de commande; preuves de concept; modèles; ou d'autres technologies connexes (y compris l'un des précédents qui sont fournis par notre personnel) vous est fourni en tant que contenu AWS en vertu de l'accord client AWS, ou l'accord écrit pertinent entre vous et AWS (selon le cas). Vous ne devez pas utiliser ce contenu AWS dans vos comptes de production ou sur la production ou d'autres données critiques. Vous êtes responsable des tests, de la sécurisation et de l'optimisation du contenu AWS, tels que un exemple de code, le cas échéant pour l'utilisation de la note de production en fonction de vos pratiques et normes de contrôle de la qualité spécifiques. Le déploiement du contenu AWS peut entraîner des frais AWS pour créer ou utiliser des ressources CHEAGables AWS, telles que l'exécution des instances Amazon EC2 ou l'utilisation du stockage Amazon S3.
Voir le fichier contributif pour contribuer.
Voir le fichier de licence pour les licences de notre projet.
Copyright Amazon.com, Inc. ou ses affiliés. Tous droits réservés.
Sauf exiger la loi applicable ou convenu par écrit, les logiciels distribués en vertu de la licence sont distribués sur une base «tel quel», sans garantie ou conditions d'aucune sorte, expresse ou implicite.
