Introduction¶

The OCTO Cloud-Native Platform is a reference implementation of enterprise applications running on Oracle Cloud Infrastructure (OCI). It demonstrates how to integrate OCI's observability, security, database, and AI services with cloud-native applications deployed on Oracle Kubernetes Engine (OKE).

Goals¶

1. Showcase OCI observability services — APM, Logging, Monitoring, Log Analytics, DB Management, Operations Insights — as modular add-ons that can be activated independently
2. Demonstrate cloud-native patterns — FastAPI + Go microservices, shared Oracle ATP database, IDCS SSO, distributed tracing, circuit breakers
3. Provide a framework architecture — add new features without breaking existing capabilities; each module is independent
4. Enable AI-driven operations — integration with OCI Coordinator's Remediation Agent v2 for automated detection → diagnosis → remediation
5. Serve as a reference implementation — tenancy-portable OKE manifests, security best practices, comprehensive test coverage, and a clear split between public storefront and internal operations control planes

Architecture Summary¶

Two application services share a single Oracle ATP database:

Both services integrate with the full OCI observability stack through modular add-ons that activate via environment variables or console configuration — no code changes required.

Current Runtime Model¶

• Shop frontend: https://shop.octodemo.cloud
• CRM frontend: https://crm.octodemo.cloud
• Shared database: Oracle ATP
• Catalog source of truth: CRM
• Browser-visible CRM links: public URL only
• Backend CRM calls from shop: may use the internal cluster-local CRM service URL

This split matters operationally: the shop renders customer-facing catalog and checkout experiences, while the CRM is where operators edit customers, orders, invoices, storefronts, and product inventory.

OCI Services¶

The platform integrates with the following OCI services. Each service is an independent add-on — the application runs with or without any given service.

Core Compute & Networking¶

Database¶

Observability¶

Security¶

AI & GenAI¶

Integration & Automation¶

Platform Services Map¶

flowchart TD
    subgraph Apps ["Application Services"]
        Shop["OCTO Drone Shop"]
        CRM["Enterprise CRM Portal"]
    end

    subgraph Compute ["Compute & Networking"]
        OKE["OKE"]
        OCIR["OCIR"]
        LB["Load Balancer"]
    end

    subgraph Data ["Database"]
        ATP["ATP"]
        DBMgmt["DB Management"]
        OPSI["Ops Insights"]
    end

    subgraph Obs ["Observability"]
        APM["APM"]
        RUM["APM RUM"]
        Logging["Logging"]
        LogAn["Log Analytics"]
        Monitoring["Monitoring"]
        Stack["Stack Monitoring"]
    end

    subgraph Sec ["Security"]
        IDCS["Identity Domains"]
        WAF["WAF"]
        CG["Cloud Guard"]
        SZ["Security Zones"]
        Vault["Vault"]
        VSS["VSS"]
    end

    subgraph AI ["AI Services"]
        GenAI["Generative AI"]
    end

    LB --> WAF --> Shop
    LB --> CRM
    Shop --> OKE
    CRM --> OKE
    Shop --> ATP
    CRM --> ATP
    ATP --> DBMgmt
    ATP --> OPSI
    Shop -.-> APM
    CRM -.-> APM
    APM --> RUM
    Shop -.-> Logging
    CRM -.-> Logging
    Logging --> LogAn
    Shop -.-> Monitoring
    OKE -.-> Stack
    IDCS --> Shop
    IDCS --> CRM
    CG --> Shop
    CG --> CRM
    VSS --> OKE
    Shop --> GenAI
    Vault --> Shop

Platform Components¶

Deployment Options¶

Next Steps¶

• Getting Started — Prerequisites and deployment guide
• Architecture — System design, data model, framework approach
• OCI Observability Add-Ons — 8-level progressive enablement guide
• Cross-Service Integration — How Drone Shop and CRM share ATP

Reference Implementations¶