visual asset management system
v2.1.0
Visual Asset Management System (VAMS) Versión 2.x+ es la serie de versiones oficial reconocida y aprobada.
Todas las versiones de 1.x anteriores de VAMS, aunque aún están disponibles, ya no serán compatibles o recomendadas para su uso.
Visual Asset Management System (VAMS) es una solución nativa de AWS especialmente diseñada para la gestión y distribución de activos visuales especializados utilizados en la computación espacial. VAMS ofrece una solución simplificada para que las organizaciones ingieran, almacenen y administren activos visuales en la nube, lo que permite a cualquier usuario un navegador web que cargue, administre, visualice, transforme y recupere los activos visuales. Los flujos de trabajo existentes que aprovechan el código personalizado y las aplicaciones previas a la construcción o de terceros también se pueden migrar a VAM y se ejecutan en la nube de AWS, en lugar de estar limitados por la capacidad local disponible. VAMS es personalizable y expandible con la opción de estar más adaptado a casos de uso específicos por parte de los equipos de desarrollo.
Valor del cliente: VAMS aborda los desafíos que enfrentan los clientes que se embarcan en iniciativas de computación espacial, como la realidad aumentada y virtual (AR/VR). Las organizaciones que previamente tenían que administrar estos activos en los sistemas locales ahora pueden hacerlo desde una aplicación basada en la web.
Aprovechando el servicio de almacenamiento simple de Amazon (Amazon S3) como una capa de almacenamiento de alta disponibilidad de bajo costo, VAMS proporciona una API especialmente diseñada para la gestión de activos 3D. Esta API proporciona una capa de abstracción, lo que permite construir integraciones personalizadas. Las integraciones personalizadas permiten que las cargas de trabajo y las aplicaciones se trasladen a la nube, desbloqueando el acceso a toda la amplitud y profundidad del ecosistema AWS.
En general, VAMS Super Power proviene del uso de servicios comunes de AWS, lógica de código abierto y extensibilidad para agregar o combinar con otras arquitecturas, soluciones y estrategias.
Casos de uso: los casos de uso de muestras que han aprovechado las primeras iteraciones de VAM incluyen:
VAMS actualmente se integra con varios espectadores de activos diferentes y admite los siguientes formatos para ver los activos 3D de manera interactiva.
| Nombre | Extensión | Tipo | Espectador | Biblioteca excluida | Notas |
|---|---|---|---|---|---|
| Orilla de la onda | obj | texto | Visor 3D en línea | ||
| Estudio 3D | 3DS | binario | Visor 3D en línea | ||
| Estereolitografía | stl | texto | Visor 3D en línea | ||
| Estereolitografía | stl | binario | Visor 3D en línea | ||
| GLTF | GLTF | texto | Visor 3D en línea | ||
| GLTF | GLB | binario | Visor 3D en línea | ||
| Formato de archivo de objeto | apagado | texto | Visor 3D en línea | ||
| Formato de archivo de objeto | apagado | binario | Visor 3D en línea | ||
| Dotbim | bim | texto | Visor 3D en línea | ||
| Rinoceronte 3D | 3DM | binario | Visor 3D en línea | ||
| Caja de cine | fbx | texto | Visor 3D en línea | ||
| Caja de cine | fbx | binario | Visor 3D en línea | ||
| Colada | dae | texto | Visor 3D en línea | ||
| Lenguaje de modelado de realidad virtual | WRL | texto | Visor 3D en línea | ||
| Formato de fabricación 3D | 3MF | texto | Visor 3D en línea | ||
| Fabricación aditiva | amf | texto | Visor 3D en línea | ||
| (Excluido*) Dotbim | IFC | texto | Visor 3D en línea* | web-IFC | |
| (Excluido*) Freecad | FCSTD | texto | Visor 3D en línea* | OCCT-Import-JS | |
| (Excluido*) Representante de límites | brepero | texto | Visor 3D en línea* | OCCT-Import-JS | |
| (Excluido*) ISO 10303 CAD | paso | texto | Visor 3D en línea* | OCCT-Import-JS | |
| (Excluido*) Exchange de gráficos | IGES | texto | Visor 3D en línea* | OCCT-Import-JS | |
| Cloud de puntos: intercambio de datos LIDAR | laz | binario | Potree espectador | ||
| Cloud de puntos: intercambio de datos LIDAR | lás | binario | Potree espectador | ||
| Cloud de puntos: intercambio de datos LIDAR | E57 | binario | Potree espectador | ||
| Formato de archivo de polígono | capa | binario | Potree espectador | MEDILLAS DE TIENDAS TIPOS MEDILES Y CLOUDS DE PUNTOS: VAMS actualmente mostrando solo Visor de nubes de puntos para capas | |
| Formato de archivo de polígono | capa | texto | Potree espectador |
Los espectadores disponibles incluyen:
Tome nota:
Exclusión* Notas:
onlineViewer3DFileFormats en ./web/src/common/constants/fileFormats.js . Luego agregue la biblioteca NPM excluida en la lista en la carpeta web a través de yarn add . Advertencia Esta solución le permite interactuar con bibliotecas de software de terceros y modelos generativos de IA (GAI) de proveedores de terceros. Su uso de las bibliotecas de software y los modelos GAI de terceros se rigen por los términos que le proporcionan la biblioteca de software de terceros y los proveedores de modelos GAI cuando adquirió su licencia para usarlos (por ejemplo, sus términos de servicio, acuerdo de licencia , Política de uso aceptable y Política de privacidad).
Usted es responsable de garantizar que su uso de las bibliotecas de software de terceros y los modelos GAI cumplan con los términos que los rigen, y cualquier ley, reglas, regulaciones, políticas o estándares que se apliquen a usted.
También es responsable de realizar su propia evaluación independiente de las bibliotecas de software de terceros y los modelos GAI que usa, incluidas sus resultados y cómo las bibliotecas de software de terceros los proveedores de modelos GAI usan cualquier dato que pueda transmitirse a ellos en función de su implementación. configuración. AWS no hace ninguna representación, garantía o garantía con respecto a las bibliotecas de software de terceros y los modelos GAI, que son "contenido de terceros" bajo su acuerdo con AWS. Esta solución se le ofrece como "contenido de AWS" bajo su acuerdo con AWS.
VAMS CodeBase está cambiando con frecuencia y le recomendamos que consulte la versión estable lanzada desde GitHub.
Para las implementaciones directas de Windows, se pueden necesitar algunos cambios en las siguientes instrucciones en cómo especificar las variables de entorno en la línea de comando.
Puede identificar lanzamientos estables por su etiqueta. Obtenga las etiquetas git fetch --all --tags y luego git checkout tags/TAG o git checkout -b TAG tags/TAG donde la etiqueta es la etiqueta real deseada. Se encuentra una lista de etiquetas ejecutando git tag --list o en la página de versiones.
Nota: Si se está ejecutando detrás de un proxy SSL HTTPS que requiere que los nodos de red tengan un certificado SSL personalizado, diríjase a la implementación de CDK SSL en la Guía del desarrollador para obtener más información.
cd ./web && nvm use - Asegúrese de que su versión de nodo coincida con el proyecto. Asegúrese de que Docker Daemon esté funcionando.
yarn install : asegúrese de instalar los paquetes requeridos por la aplicación web (tome nota, npm install no resulta en una compilación que funcione de la aplicación; use el hilo).
npm run build - Cree la aplicación web.
cd ../infra && npm install : instala dependencias definidas en paquete.json.
Si aún no ha arrancado su cuenta de AWS con CDK. cdk bootstrap aws://101010101010/us-east-1 : reemplace con su cuenta y región. Si está llevando a cabo una cuenta de GovCloud, ejecute export AWS_REGION=[gov-cloud-region] ya que el AWS SDK necesita ser informado para usar puntos finales de GovCloud. Nota: Use el papel de AWS IAM menos permisivo para boostrapping que aún puede generar los componentes de AWS necesarios a partir de CloudFormation para VAM.
Modifique el config.json in /infra/config para establecer los parámetros y características de implementación de VAMS que desea implementar. Los campos mínimos recomendados para actualizar son region , adminEmailAddress y baseStackName cuando se usan la plantilla proporcionada por defecto. Puede encontrar más información sobre las opciones de configuración en la guía de configuración.
(Opcional) anule el nombre y la región de la pila CDK para la implementación con variables de entorno export AWS_REGION=us-east-1 && export STACK_NAME=dev -Reemplace con la región en la que desea implementar y el nombre que desea asociar con CloudFormation pila que el CDK implementará.
(FIPS use solo) si se implementa con FIPS, habilite las variables de entorno FIPS para AWS CLI export AWS_USE_FIPS_ENDPOINT=true y habilitar app.useFips en el archivo de configuración config.json en /infra/config
(VPC externo solo importar) Si importa una VPC externa con subredes en la configuración config.json , ejecute cdk deploy --all --require-approval never --context loadContextIgnoreVPCStacks=true para importar el contexto de ID/subredes VPC e implementar todos los no no -Las pilas dependientes de VPC primero. No ejecutar esto con la configuración de contexto o la configuración de la configuración de loadContextIgnoreVPCStacks hará que la implementación final de todos los pasos de pilas falle. Consulte la Guía de configuración para la importación VPC en solución de problemas adicionales. Nota: Revise la sección de notas adicionales de la guía de configuración para el # de IPS necesarios por subred.
cdk deploy --all --require-approval never -Se crea una cuenta en un grupo de usuarios de AWS Cognito utilizando la dirección de correo electrónico especificada en el archivo de configuración de infraestructura. Espere un correo electrónico de [email protected] con una contraseña temporal.
10a. Asegúrese de que Docker se esté ejecutando antes de implementarlo como un contenedor deberá construirse
1.a (predeterminado) (implementación de CloudFront) Navegue a la URL proporcionada en {stackName].WebAppCloudFrontDistributionDomainName{uuid} desde la salida cdk deploy .
1.B (función de implementación de Alb) navegue a la URL proporcionada en webDistributionUrl desde la salida cdk deploy .
Consulte el correo electrónico para obtener una contraseña de cuenta temporal para iniciar sesión con la dirección de correo electrónico que proporcionó.
(Opcional) Siga la Guía de permisos del usuario de Crear nuevo VAMS para agregar usuarios adicionales
Puede cambiar la región e implementar una nueva instancia de VAMS cambiando el ./infra/config/config.json o estableciendo las variables de entorno en nuevos valores ( export AWS_REGION=us-east-1 && export STACK_NAME=dev ) y luego ejecutar npm run deploy.dev nuevamente.
Para implementar personalizaciones o actualizaciones en VAMS, puede actualizar la pila ejecutando cdk deploy --all --require-approval never . Se crea e implementa un conjunto de cambios en su pila.
Tenga en cuenta que dependiendo de qué cambios hay en vuelo, los VAM pueden no estar disponibles para los usuarios en parte o en su totalidad durante la implementación. Lea el registro de cambios cuidadosamente y pruebe los cambios antes de exponer a sus usuarios a nuevas versiones.
Se recomienda que los VAM se actualicen entre los cambios principales de la versión, las principales actualizaciones de configuración (KMS CMK Cambios de clave, CloudFront -> Alb Switches, etc.) o redeployments de pilas a una región diferente para usar una implementación A/B utilizando el 
camino. Tenga en cuenta que al usar la opción de configuración de Alb, se necesitará una implementación de pila A/B modificada.
Tenga en cuenta que esto no debe usarse para actualizaciones de la versión VAMS o implementaciones de A/B que deben seguir las instrucciones en .
Los VAM se pueden implementar con un parámetro de configuración de cubo de escenario para habilitar la copia de un cubo de activos existente.
Para implementar con el cubo de puesta en escena, simplemente configure la app.bucketMigrationStaging.assetBucketName CONFIG de parámetro en ./infra/config/config.json a su implementación de CDK y VAMS registrará su cubo existente como un cubo de escenario.
Una vez que se completa la implementación, puede invocar la API /assets/uploadAssetWorkflow para comenzar a copiar los activos en el cubo VAMS S3 y registrar los activos.
Consulte el FloadAssetWorkflow en los documentos de la API para conocer el cuerpo de solicitud de API.
VAMS Backend permite la configuración básica a avanzada basada en el entorno y la necesidad de caso de uso.
Consulte la guía de configuración para obtener instrucciones.
VAMS utiliza un sistema de permiso de control de acceso basado en atributos/basado en roles (ABAC/RBAC) además de la autenticación para controlar el acceso de grano fino a diversas funcionalidades de solución y elementos de datos.
Consulte la Guía de permisos sobre cómo usar el sistema de permiso VAMS.
VAMS Backend está compuesto por funciones de AWS Lambda a las que se accede a través de una puerta de enlace AWS API.
Las tuberías son una característica en VAM que le permiten editar 
VAMS Frontend es una aplicación reactjs de una sola página. Se puede implementar a través de CloudFront o Alb
VAMS API y Frontend están autorizados a través de cuentas de usuario de AWS Cognito de forma predeterminada.
La autenticación federada con SAML está disponible con configuración adicional. Consulte la autenticación SAML en la Guía del desarrollador para obtener instrucciones.
| componente | carpeta |
|---|---|
| aplicación web | web |
| implementación de CDK | infra |
| API y backend | backend |
| Uso Backend de la tubería de casos | backendpipelines |
Consulte el taller de VAMS para obtener un tutorial detallado
Para saber más sobre cómo funciona VAMS y para obtener instrucciones sobre la configuración de la tubería y el flujo de trabajo, consulte la Guía del desarrollador de la Guía del desarrollador.
Consulte el 
.
cdk destroy --all desde la carpeta Infra.Los costos de esta solución pueden entenderse como costos de almacenamiento fijos y costos variables de las tuberías que configura. El costo de almacenamiento es proporcional a la cantidad de datos que carga en VAM, incluidos los nuevos datos que crea utilizando las tuberías VAMS.
Usted es responsable del costo de los servicios de AWS utilizados al ejecutar esta solución. Asegúrese de tener alarmas de facturación establecidas dentro de las limitaciones de su presupuesto.
Opciones de configuración:
Un desglose de costos mensual aproximado está a continuación (excluyendo algunas inclusiones de nivel gratuito):
| Servicio | Cantidad | Costo (comercial) | Costo (Govcloud) |
|---|---|---|---|
| VPC (C-0 + C-1/C-2/C-3/C-5, opcional) | 1-11x puntos finales por AZ (hasta 3 AZ) - Según las opciones de configuración | $ <240.91 | $ <311.13 |
| Amazon CloudFront (C-1, predeterminado) | Primer 1 TB - incluido en nivel libre | $ 0.00 | N / A |
| Amazon Alb (C-1, opcional) | 1 Alb, 1 TB procesado | $ 24.43 | $ 52.56 |
| Puerta de entrada de la API de Amazon | 150000 solicitudes | $ 0.16 | $ 0.19 |
| Amazon Dynamodb | 750000 escribe, 146250 lecturas, almacenamiento de 0.30 GB | $ 1.18 | $ 2.36 |
| AWS Lambda | 12000 invocaciones, AVG de 2 minutos. duración, memoria de 256 mb | $ 6 | $ 6 |
| Funciones del paso de AWS | 92400 transiciones estatales | $ 2.21 | $ 2.65 |
| Amazon S3 | Almacenamiento de 10 GB, 4000 solicitudes, 4000 obtengan solicitudes | $ 0.26 | $ 0.41 |
| Amazon Rekognition | Análisis de imagen 9000, 3 unidades de inferencia de etiquetas personalizadas | $ 22.32 | N / A |
| Registro de contenedores elásticos de Amazon | ECR (en región) 40 GB | $ 4 | $ 4 |
| Amazon Open Search Servidor (C-2, predeterminado) | 2x índice OCU, 2x Search OCU, 100 GB de datos | $ 703.20 | N / A |
| Amazon Open Search Provisado (C-2, opcional) | 3x datos (r6g.large.search), 3x maestro (r6g.large.search), 240GB EBS | $ 743.66 | $ 915.52 |
| Servicio de ubicación de Amazon (C-4, predeterminado) | 1000 mapas de mapa recuperados | $ 40.00 | N / A |
A continuación se presentan los costos adicionales para incluir funciones de tuberías específicas de casos de uso en su implementación (C-5, opcional):
| Servicio | Cantidad | Costo (comercial) | Costo (Govcloud) |
|---|---|---|---|
| Fargate por lotes | 10 horas de procesamiento | $ 3.56 | $ 4.88 |
| Amazon S3 | Almacenamiento de 300 GB, transferencia de 30 GB | $ 9.60 | $ 16.34 |
| Amazon CloudWatch | Registros de 1 GB - VPC FlowLogs/API Gateway/Pipeline | $ 3.28 | $ 4.12 |
| Roca madre de Amazon | 1M Tokens - Sonnet Claude | $ 18 | $ Na |
| Amazon Rekognition | Procesamiento de imágenes de 10k | $ 7.50 | $ 9 |
Cuando crea sistemas en la infraestructura de AWS, las responsabilidades de seguridad se comparten entre usted y AWS. Este modelo de responsabilidad compartida reduce su carga operativa porque AWS opera, administra y controla los componentes, incluido el sistema operativo del host, la capa de virtualización y la seguridad física de las instalaciones en las que operan los servicios. Para obtener más información sobre la seguridad de AWS, visite AWS Cloud Security.
VAMS se proporciona bajo este modelo de responsabilidad compartida. Cualquier personalización para el uso del cliente debe pasar por una revisión de APPSEC para confirmar que las modificaciones no introducen nuevas vulnerabilidades. Cualquier equipo de implementación asume la responsabilidad de garantizar que su implementación haya pasado por una revisión de seguridad adecuada.
yarn audit en el directorio web antes de implementar front-end para garantizar que todos los paquetes estén actualizados. Ejecute yarn audit fix para mitigar las vulnerabilidades de seguridad críticas.Revise todas las consideraciones con los equipos de seguridad de sus organizaciones para determinar si se requieren mitigaciones.
El código de muestra; Bibliotecas de software; Herramientas de línea de comando; pruebas de concepto; plantillas; u otra tecnología relacionada (incluida cualquiera de los anteriores que proporcionan nuestro personal) se le proporciona como contenido de AWS bajo el Acuerdo del Cliente de AWS, o el Acuerdo escrito relevante entre usted y AWS (lo que se aplique). No debe usar este contenido de AWS en sus cuentas de producción, o en producción u otros datos críticos. Usted es responsable de probar, asegurar y optimizar el contenido de AWS, como el código de muestra, según corresponda para el uso de calificaciones de producción en función de sus prácticas y estándares específicos de control de calidad. La implementación de contenido de AWS puede incurrir en cargos de AWS para crear o usar recursos cargables de AWS, como ejecutar instancias de Amazon EC2 o usar el almacenamiento de Amazon S3.
Vea el archivo contribuyente sobre cómo contribuir.
Vea el archivo de licencia para la licencia de nuestro proyecto.
Copyright Amazon.com, Inc. o sus afiliados. Reservados todos los derechos.
A menos que la ley aplicable sea requerida o acordado por escrito, el software distribuido bajo la licencia se distribuye de manera "como es", sin garantías o condiciones de ningún tipo, ya sea expresas o implícitas.
