Skip to content

ADR 0001: Tencent Cloud Migration — Scope and Governance

Status

Accepted

Date

2026-07-24

Context

OVES systems are currently distributed across multiple cloud providers and self-hosted infrastructure. A strategic decision has been made to consolidate core services onto the Tencent Cloud ecosystem to reduce operational complexity, leverage Tencent's regional presence in target markets, and align with existing Chinese-market infrastructure partnerships.

This ADR defines the scope, governance model, and ADR framework for the migration effort.

Decision

Scope

The migration covers the following capability areas, listed in priority order:

  1. Compute and container orchestration — Migrate containerized workloads to Tencent Kubernetes Engine (TKE)
  2. Data and storage — Migrate databases, object storage, and backup systems to Tencent Cloud equivalents (CDB, COS, CBS)
  3. Networking and CDN — Migrate DNS, load balancing, CDN, and VPN to Tencent Cloud Edge (CLB, CDN, SSL)
  4. Observability — Migrate monitoring, logging, and alerting to Tencent Cloud Monitor, CLS, and associated services
  5. Identity and security — Adapt IAM, secret management, and access controls to Tencent Cloud CAM
  6. CI/CD and developer tooling — Migrate or bridge CI/CD pipelines to Tencent Cloud DevOps or CODING

Governance

  • All material migration decisions must be recorded as ADRs in this repository.
  • Each ADR must document the Tencent Cloud service mapping (source service → target service → migration approach).
  • ADRs are owned by the infrastructure team and reviewed by the architecture lead.
  • Exceptions to the "Tencent-first" policy (e.g., retained AWS/GCP services) must be justified in a dedicated ADR.

ADR Numbering

  • 0001–0099: Cloud infrastructure and platform decisions
  • 0100–0199: Application and service migration decisions
  • 0200–0299: Security, compliance, and operational decisions

Consequences

Benefits

  • Single governance framework for the entire migration effort
  • Clear decision traceability across teams and time
  • Scope boundaries prevent scope creep

Trade-Offs

  • ADR process adds overhead to fast-moving migration decisions
  • Requires discipline to keep ADRs updated as migration progresses
  • Some decisions may need to be made before full Tencent Cloud feature evaluation is complete