# oracle-devrel/oci-devops-examples architecture

> Architecture diagram of the GitHub repository oracle-devrel/oci-devops-examples, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/oracle-devrel/oci-devops-examples
- Repository: https://github.com/oracle-devrel/oci-devops-examples

## Overview

##### Project Type and Purpose
This is a collection of examples demonstrating Oracle Cloud Infrastructure (CI/CD) DevOps services, organized into different categories of functionality. The project serves as a reference implementation repository.

##### Main Components

A. Top-Level Organization Layer:
- Pipeline Examples
- Build Examples
- Deployment Examples
- Code Repository Examples
- Configuration Examples

B. Service Integration Layer:
- OCI DevOps Services:
- Build Service
- Deployment Service
- Source Code Management
- Project Management

C. Technology Stack Layer:
- Container Technologies:
- Docker (multiple Dockerfile examples)
- OCI Container Instances
- Programming Languages:
- Java (with GraalVM)
- Python
- Node.js
- Rust
- Golang
- Frameworks:
- Micronaut
- CI/CD Tools:
- SonarQube
- GitHub Actions

**┌─────────────────────────────────────── OCI DevOps Examples ───────────────────────────────────────┐**

- ┌─────────────┐    ┌─────────────┐    ┌──────────────┐    ┌────────────┐    ┌──────────────┐   │
- Pipeline  │    │    Build    │    │  Deployment  │    │    Code    │    │    Config    │   │
- Examples   │    │  Examples   │    │   Examples   │    │ Repository │    │   Examples   │   │
- ┬──────┘    └──────┬──────┘    └──────┬──────┘    └─────┬──────┘    └──────┬──────┘   │

- ┼───────────────────┼──────────────────┼───────────────────┘          │

- ┌────────┴───────────────────┴──────────────────┴────────┐                    │
- OCI DevOps Services                    │                    │
- ┌─────────────┐ ┌──────────────┐ ┌────────────────┐  │                    │
- Build Service│ │Deploy Service│ │Source Control  │  │                    │
- ┘ └──────────────┘ └────────────────┘  │                    │
- ┬────────────────────────┘                     │

- ┌─────────────────────────────┴────────────────────────┐                     │
- Technology Implementation                │                     │
- ┌─────────────┐ ┌──────────────┐ ┌────────────────┐│                     │
- Containers  │ │  Languages   │ │   Tools        ││                     │
- Docker    │ │  - Java      │ │   - SonarQube ││                     │
- OCI       │ │  - Python    │ │   - GitHub    ││                     │
- ┘ └──────────────┘ └────────────────┘│                     │
- ┘                     │
- ┘

##### Implementation Notes

- Maintain consistent spacing and alignment
- Clear labels and annotations
- Document all assumptions and prerequisites

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph OCI["OCI DevOps Examples Platform"]
        subgraph PS["Pipeline Services"]
            CICD["CICD Pipelines"]
            BT["Build Triggers"]
            DT["Deployment Triggers"]
            CRP["Cross-Region Pipeline"]:::file
            LSP["Language-Specific Pipelines"]:::file
        end

        subgraph BS["Build Services"]
            BR["Build Runners"]
            CM["Caching Mechanisms"]:::file
            CIB["Container Image Building"]
            VS["Vulnerability Scanning"]:::file
            SQ["SonarQube Integration"]:::file
            GV["GraalVM Integration"]:::file
        end

        subgraph DS["Deployment Services"]
            BG["Blue-Green Deployment"]:::file
            CD["Canary Deployment"]:::file
            CID["Container Instance Deployment"]:::file
            OKE["OKE Integration"]
            IGD["Instance Group Deployment"]
            SD["Shell-based Deployment"]:::file
        end

        subgraph CRS["Code Repository Services"]
            OCR["OCI Code Repository"]
            subgraph ERI["External Repository Integration"]
                GH["GitHub Integration"]:::file
                GL["GitLab Integration"]:::file
                BB["Bitbucket Integration"]:::file
            end
            FT["File-based Triggers"]:::file
            BM["Branch Management"]
        end

        subgraph CS["Configuration Services"]
            PM["Project Management"]:::file
            PLM["Policy Management"]:::file
            GM["Group Management"]
            SC["Security Configuration"]
            AC["Access Control"]
        end

        subgraph SL["Security Layer"]
            LA["License Auditing"]:::file
            VSC["Vulnerability Scanning"]:::file
            PE["Policy Enforcement"]
            ACS["Access Control System"]
            CV["CLA Verification"]:::file
        end
    end

    %% Relationships
    CRS --> BS
    BS --> PS
    PS --> DS
    CS --> BS
    CS --> PS
    CS --> DS
    SL --> BS
    SL --> DS

    %% Styling
    classDef file fill:#f9f,stroke:#333,stroke-width:2px
    classDef default fill:#09f,stroke:#333,stroke-width:1px

    %% Click Events
    click CRP "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-pipeline-examples/oci-cascaded-pipelines"
    click LSP "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-pipeline-examples/oci-devops-cicd-rust-sample"
    click CM "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-build-caching"
    click SQ "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_buildrunner_with_sonarqube"
    click GV "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_build_with_graalenterprise"
    click VS "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-vulnerability-audit-management"
    click BG "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-deployment-examples/oci-devops-deploy-with-blue-green-model"
    click CD "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-deployment-examples/oci-devops-deploy-with-canary-model-oke"
    click CID "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-deployment-examples/oci-devops-deploy-containerinstance"
    click SD "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-deployment-examples/oci-deployment-shell-stages"
    click GH "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-coderepo-examples/oci-devops-coderepo-with-github"
    click GL "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-coderepo-examples/oci-devops-coderepo-with-gitlab"
    click BB "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-coderepo-examples/oci-devops-coderepo-with-bitbucketcloud"
    click FT "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-coderepo-examples/oci-devops-coderepo-filebasedtrigger"
    click PM "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-config-examples/oci-project-cascadedelete"
    click PLM "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-config-examples/oci_devops_policy_dg_terraform"
    click CV "https://github.com/oracle-devrel/oci-devops-examples/blob/main/.github/workflows/cla.yml"
    click LA "https://github.com/oracle-devrel/oci-devops-examples/blob/main/.github/workflows/license_audit.yml"
    click VSC "https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_imagescan_before_deploy"
```
