Documentation
Feedback
Guides
API Reference

Guides
VTEX Platform OverviewCloud infrastructure
Cloud infrastructure

Learn how our infrastructure decisions ensure scalability, reliability, and performance for your business.

This guide presents an overview of VTEX's infrastructure architecture, exploring its cloud resources and technical aspects. Read the following sections to understand how our multi-tenancy and cloud-based architecture can benefit your business.

SaaS multi-tenancy

By adopting the Software as a Service (SaaS) model, VTEX eliminates the need to set up and maintain complex local infrastructure, which enables scalability, stability, and simplified access to advanced digital commerce features such as order management, product offerings in marketplaces, and flexible integrations.

A key element of our platform's architecture is multi-tenancy. Tenants refer to individual accounts that have access to the same platform infrastructure while keeping their data and configurations isolated and secure. VTEX's multi-tenant architecture enables us to serve multiple customers on a shared infrastructure, ensuring performance, scalability, and cost-effectiveness.

The multi-tenant architecture diagram below illustrates how VTEX supports multiple accounts on a shared infrastructure:

{"base64":"  ","img":{"width":895,"height":497,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":39472,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/VTEX-Platform-Overview/Cloud-infrastructure/multi-tenant.png"}}

  • Tenants: Tenant 1 and Tenant n represent different accounts using the VTEX platform. Each tenant sends and receives requests and responses to and from the platform.
  • Application Runtime (Kernel): Atomic Requests are individual operations processed by the application runtime. Each tenant's requests are handled as atomic requests, ensuring isolation and security.
  • VTEX IO apps: These applications provide specific features and can be customized for each tenant. The diagram shows that VTEX IO apps can be standard or customized based on the tenant's requirements.
  • Database interaction: The application runtime processes read and write operations to a shared physical database. This ensures that each tenant's data is handled efficiently.
  • Shared physical database: The database schema is shared among tenants but maintains tenant-specific data and metadata to ensure data isolation and security. Each tenant's data and metadata are stored in isolated sections within the shared schema.

Logical separation

With a multi-tenant architecture, tenants don't have exclusive resources, such as physically separate databases, but we guarantee logical separation. Our clients' information is contained in one account, isolated and protected from other accounts. There is no method of accessing data from different accounts since all our services require an explicit account specification and authorized credentials.

Each request belongs to a specific tenant (account) and is processed atomically, which means each request has its own lifecycle. This allows for elastic operation and scalability and improved performance.

Constant evolution and growth

The implementation of new features and updates can take place across the entire platform, ensuring that all tenants can benefit from the latest enhancements.

With a single, shared code base and infrastructure, updates, bug fixes, and maintenance tasks are centralized, reducing the time and effort required to keep the platform running smoothly across all tenants.

Given our demand aggregation capability due to SaaS multi-tenancy architecture, VTEX can handle traffic peaks smoothly. Learn more in the Scalability section.

Microservices

Our core commerce capabilities consist of over 70 shared microservices. Unlike a monolithic solution of tightly integrated capabilities, our microservices are organized into distinct functional modules, such as Checkout, Promotions, Catalog, or Pricing services, each with its own responsibilities and APIs.

{"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAACCAIAAADwyuo0AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAJUlEQVR4nAEaAOX/APiezv/O/umcyzkBLACZZ5O5lsCGcZUaDSvOGQ1mwP1NjwAAAABJRU5ErkJggg==","img":{"src":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/VTEX-Platform-Overview/Cloud-infrastructure/microservices.png","width":1171,"height":606,"type":"png"}}

Each microservice has a lifecycle independent from others, including its environment, deployment, and codebase. This allows us to use the most appropriate technologies and design patterns for each case. Teams can deploy services independently, enabling continuous improvement and faster updates. Each microservice is independently scalable to meet increasing demand.

Such choices ensure speed and flexibility in the evolution of platform services, guarantee exclusive resources for each service, and eliminate competition between different operations, thus ensuring greater availability.

Virtual Private Cloud (VPC)

Given our microservices architecture, it is common for an application to need to query others to process a request. To ensure good processing performance while also safeguarding against unwanted external access, the microservices run within the same Virtual Private Cloud (VPC) network — except in cases where an exclusive VPC is a legal or security prerequisite, as is the case with VTEX's Payment Gateway, with PCI certification.

Within the VPC, VTEX IO apps have access control based on policies that only allow access to necessary resources, thus ensuring greater security.

Deployment strategy and change management

New features and fixes are introduced daily, in a smooth and seamless way. Over 12,000 upgrades are rolled out annually without causing disruptions to customer operations. There is an automatic update for all clients for patch and minor updates that do not impact backward compatibility. In case of major feature changes, we ensure transparent communication by providing notifications, documentation and timelines before the release.

Our deployment capacity is made possible by a robust architecture of microservices, each having its own independent life cycle but operating within a unified, automated, Continuous Delivery framework. Our CI/CD pipeline ensures seamless integration, testing, and deployment of code changes, enabling us to deliver features and updates efficiently and with minimal disruption.

Releases primarily focus on adding new features or addressing bugs. Major releases are typically confined to specific platform services. Major versions follow the same development and deployment processes and coexist with the previous version, allowing tenants ample time for adjustment if needed.

General deployments to development and production environments are automated and triggered by reviewed and approved releases from our versioned code repositories. Each microservice contains a protected main branch that can only be modified after the approval of at least two developers, ensuring that peer-reviewing and segregation of duties are part of the process.

After that, a webhook is sent, and a new environment is automatically created without further commands. Finally, the developer defines the autoscaling configuration and the number of instances in the new environment, and the traffic is slowly switched over.

This blue/green deployment strategy ensures that any problems are detected with little production traffic (usually around 1%) by monitoring the system's metrics, and rollbacks are immediate since the previous environment still exists.

REST APIs

Our REST APIs enable you to leverage and extend VTEX core commerce features to integrate with third-party solutions and deliver best-in-class experiences across a multitude of shopper touchpoints (headless mobile applications, chatbots, IoT integrations) and back office touchpoints (ERP, PIM, and WMS integrations).

For developers looking to explore our APIs more deeply, we offer comprehensive API reference documentation that includes usage examples to streamline the process of exploration, understanding, and consumption.

Using our REST APIs with our development platform (VTEX IO) and data service (Master Data), you can expand the VTEX platform to address your unique business needs.

Cloud-native

In our infrastructure, we align with market trends in hosting and computing. VTEX core commerce services utilize advanced cloud solutions, which monitor and control the deployment of new servers. VTEX IO leverages containerization and clustering technologies to manage deployment, maintenance, and scaling processes.

Our cloud-native, multi-tenant SaaS solution allows tenants to run the same version of the platform and benefit from frequent and seamless upgrades as well as high scalability.

Furthermore, our adoption of a microservices architecture facilitates seamless modernization and enhances observability across various computing environments.

Verify our credentials by consulting Amazon's assessment of our company at AWS Partner VTEX. AWS Retail Competency Partners undergo rigorous validation by AWS to ensure they meet AWS best practices for building secure, high-performing, resilient, and efficient cloud infrastructure for industry applications — to give customers increased confidence when making decisions.

Content delivery optimization

In a cloud-native architecture, optimizing content delivery involves leveraging a combination of technologies and strategies to minimize latency, enhance performance, and improve overall user experience. This section explores key components of content delivery logic within our cloud-native framework, including Content Delivery Networks (CDNs), routers, and caching mechanisms.

Check the diagram and the following explanation to learn more about our resilient layered approach to content delivery:

{"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7ljmRAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAMElEQVR4nGN4/vBRQVZOfUXVi0dPGII9vMz0DVVl5AtSMhiKM3M3rVrb3tC0dM58AGrxEeKChJCsAAAAAElFTkSuQmCC","img":{"src":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/VTEX-Platform-Overview/Cloud-infrastructure/cdn.png","width":971,"height":747,"type":"png"}}

  1. VTEX maintains CDN servers across multiple global regions. These servers deliver cached content from the closest location to the user, significantly reducing load times.
  2. In scenarios with no cache in the CDN or during actions like placing an order, requests are directed to the router. The router's region (AWS zones), distributed across multiple regions, enhances our resilience. Other zones are not fallbacks; they operate concurrently, bolstering our resilience. Even in the event of a failure, it is nearly imperceptible to final customers. Each session loads information independently, not relying on a single server from a specific application. In the case of critical scenarios, we are able to maintain performance for active sessions.
  3. There is a caching layer after the router, which relieves the underlying application from reprocessing the same data. When handling numerous requests, only necessary ones reach the application, ensuring availability. These strategies minimize the need to scale applications, ensuring platform resilience and capacity.
  4. Applications run on multiple servers, ensuring redundancy. We operate multiple replicas simultaneously, enhancing reliability.

This strategy ensures the platform swiftly recovers and maintains the capacity to process required tasks, embodying resilience.

CDN

VTEX's Content Delivery Network (CDN) is a distributed network of servers strategically placed across various geographic locations, whose primary function is to deliver web content to users more efficiently and reliably. On VTEX, CDN redundancy ensures the availability and performance of our services.

Our CDN plays a crucial role in caching delivered content, particularly static content, ensuring superior performance for shoppers during their browsing experience. Additionally, the CDN serves as the primary edge protection against Distributed Denial-of-service (DDoS) attacks.

Router

A router performs operations on the platform that are common to all services, such as throttling and distributing requests to internal services. It acts as the single entry point in the VPC. As the traffic orchestrator, the router ensures control in change management, resulting in lower risks with progressive rollouts and quick rollback in case of failures.

Cache

VTEX employs caching across multiple layers, including HTTP, application, and database levels, ensuring greater speed and capacity in processing requests and consequently maintaining the platform's high availability.

Our cache layers follow the best practices and are continuously improved to provide better performance, which is critical for improving conversion rates. These cache layers can be easily invalidated to update data as required. For more information, see Cache documentation.

Scalability

Leveraging cloud technology and microservices enables us to efficiently manage and scale our resources based on demand, thanks to built-in features like autoscaling.

Our multi-tenant architecture ensures elastic scalability, allowing stores to easily adapt to changing business requirements and handle traffic peaks on events like Black Friday. As your operation grows, our platform accommodates increased demand without compromising performance.

{"base64":"  ","img":{"width":810,"height":549,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":119926,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/VTEX-Platform-Overview/Cloud-infrastructure/scalability.jpg"}}

Reliability

We deliver high availability, as defined in our SLA agreement, a document that expresses the service level of the platform's infrastructure and technically clarifies its operational uptime and downtime, as well as all the types of events considered as incidents.

You can monitor the platform's stability in real time and access the full incident and maintenance history at VTEX Status. Learn more about the information available on this page in our guide VTEX Status page.

Additionally, we provision our infrastructure automatically using the Infrastructure as Code (IaC) concept. We autoscale our applications and microservices. For each service, we control Latency and CPU usage to identify if a specific module needs more or fewer servers, keeping safe thresholds so that adjustments can be made proactively. Our infrastructure also supports load-balancing, deploying, and rolling-back versions of our systems so we can provide scalable and stable up-to-date systems to VTEX customers.

VTEX IO leverages containerization and clustering technologies to manage deployment, maintenance, and scaling processes.

VTEX teams constantly execute load tests to ensure the platform is ready to scale with our customers' demands, gaining visibility, and fixing bottlenecks.

Maintenance

All scheduled maintenance activities by VTEX are communicated beforehand through VTEX Status. Maintenance typically occurs once every 60 days and lasts about 2–3 hours during the late evening (EST) and outside of peak sales hours. During this period, customers are not expected to experience downtime.

Security

VTEX counts with a comprehensive cloud monitoring system, covering both internal environments and the edge, in line with the AWS Security Maturity Model. This system offers a range of features, including configuration change alarms and security notifications.

All events within our platform are routed to a Security Information and Event Management (SIEM) infrastructure, where we can correlate events, providing traceability and real-time alerts for our Security team to promptly act on risk mitigation.

See our Security overview for more details.

Threat intelligence

In addition to global platform monitoring, we conduct tenant-level monitoring across the surface web and dark web. This proactive approach allows us to quickly identify and address issues such as unauthorized exposure of keys or cloned pages, preventing potential incidents from escalating.

Active resource monitoring and patch management

Our platform implements active resource monitoring and patch management. This keeps our infrastructure up-to-date with the latest security patches and configurations. By actively monitoring and managing resources, we efficiently address any security gaps or vulnerabilities.

Find more information about our security practices at Security - VTEX.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page