Devex

🚀 DevEx – オープンクラウドIDEプラットフォーム

DevExは、クラウド上で機能豊富なコンテナ化された開発環境を実行することができるプラットフォームです。AIの支援とセキュアなサンドボックス機能を備え、Kubernetes、WebSocket、GoLangによって動作するスケーラブルなREPLセッションを提供します。

🚀 クイックスタート

DevExは、オープンソースのクラウドベースの開発環境（REPL）を提供するプラットフォームです。この環境は、ローカルのセットアップと同じように動作し、ブラウザ上でどこでもいつでも利用できます。柔軟性を重視して構築されており、好みのスタックでコーディングしたり、SSHで接続したり、MCPサーバーを介してAIエージェントとセッションを実行したりすることができます。また、AIによって生成されたコードを安全にサンドボックス化し、分離された環境で実際の変更をテストすることもサポートしています。

他のクラウドIDEプラットフォームとは異なり、DevExは軽量でセルフホスト可能で、すぐに本番環境で使用できるように設計されています。開発者を第一に考えたCLI、シームレスなAI統合、無限のスケーラビリティを実現するKubernetesネイティブな設計が特徴です。

📣 独自のREPLテンプレートを追加したいですか？簡単です！ 👉 Contributing Guide を読んで始めましょう。

💡 使用提示

MCPサーバーが現在 glama.ai で稼働中です。これにより、AIエージェントが直接REPLとやり取りできるようになります！

✨ 主な機能

• 🔐 GitHub OAuth 認証
• 🪄 コアAPIを介した REPLの作成、開始、停止、削除
• 💾 S3ベースのファイル永続化
• 📦 REPLごとのKubernetesデプロイメント（動的）
• 📡 WebSocketベースのエディターとターミナル
• 🧹 クリーンアップと同期のための一時的なコンテナ
• 🔒 Let's EncryptとCert Managerによる HTTPSとTLS
• 🎨 美しい Next.js + Tailwindフロントエンド

🔧 技術詳細

システムの仕組み

graph TB
    User[👤 User] --> Web[🌐 Web Frontend<br/>React/Next.js Application]
    Web --> Core[🔧 Core Backend<br/>• User Authentication<br/>• Repl Management<br/>• S3 Integration<br/>• K8s Orchestration]
    Core --> S3[(🗄️ S3 Storage<br/>username/repl-id/<br/>├── templates/<br/>└── user-files/)]

    subgraph K8sCluster["☸️ Kubernetes Cluster"]
        direction TB
        IngressController[🚪 Ingress NGINX Controller<br/>Traffic Routing]
        CertManager[🔒 Cert Manager<br/>TLS Certificate Management]

        subgraph ReplResources["📦 Per-Repl Resources"]
            Deployment[🚀 Deployment<br/>Repl Container Instance]
            Service[🔗 Service<br/>Internal Network Access]
            Ingress[🌍 Ingress<br/>External Access Route]
        end

        subgraph Pod["🏠 Repl Pod"]
            MainContainer[🐳 Runner Container<br/>• WebSocket Server<br/>• File Operations<br/>• PTY/Terminal Access<br/>• Code Execution]
            EphemeralContainer[⚡ Ephemeral Container<br/>File Sync Back to S3<br/>🔄 Cleanup Process]
        end

        Deployment --> Pod
        Service --> Pod
        Ingress --> Service
        IngressController --> Ingress
    end

    Core --> K8sCluster
    Core -.->|Create Resources<br/>Deploy → Service → Ingress| ReplResources
    Web -.->|🔌 WebSocket Connection<br/>• File Management<br/>• Terminal Access<br/>• Real-time Collaboration| MainContainer
    Core -.->|📁 Copy Template<br/>to user directory| S3
    EphemeralContainer -.->|💾 Sync Files Back<br/>Before Cleanup| S3
    MainContainer -.->|📂 Load Files<br/>on Session Start| S3

セッションのライフサイクル

sequenceDiagram
    participant U as User
    participant W as Web Frontend
    participant C as Core Service
    participant K as Kubernetes
    participant S as S3 Storage
    participant R as Runner Container

    U->>W: Create New Repl
    W->>C: POST /repl/create
    C->>S: Create user directory<br/>Copy template files

    U->>W: Start Session
    W->>C: POST /repl/start
    C->>K: Create Deployment<br/>Service & Ingress
    K->>R: Initialize Container
    R->>S: Download files
    R->>W: WebSocket Connection

    Note over U,R: Development Session Active
    U->>R: File operations via WebSocket
    R->>R: Real-time file editing

    U->>W: Close Session
    W->>C: POST /repl/stop
    C->>K: Inject Ephemeral Container
    K->>S: Upload modified files
    C->>K: Delete Resources

🔩 主要コンポーネント

– フロントエンド

• Next.js + Tailwind CSS で構築
• GitHub OAuthログイン
• ファイルツリー、エディター、ターミナルのGUI
• Runnerとやり取りするためのWebSocketフック

– バックエンドAPI

• Go で記述
• ユーザー認証、S3操作、Kubernetesデプロイメント、クリーンアップを処理
• REPLセッション状態のためのRedis
• 📄 詳細なアーキテクチャとデプロイメント手順については core/README.md を参照

– REPLランタイムコンテナ

• 軽量なGoサーバー
• 以下のためのWebSocket API:
  • ファイルツリーとファイル内容のアクセス
  • ターミナル（PTY）セッション
• 📄 イベントリストとパッケージ内部の詳細については runner/README.md を参照

– KubernetesブートストラップとTLS

• 以下を含む:
  • Ingress-NGINXのセットアップ
  • 自動TLSのための cert-manager + Let’s Encrypt
• 📄 完全なセットアップ手順については k8s/README.md を参照

• REPL作成時にコピーされるベースフォルダ（例：Node.js、Python）
• 言語固有のDocker化されたスケルトン
• 📦 独自のテンプレートを追加したい場合は、 Contribution Guide を参照

🧱 インフラストラクチャ

• ☸️ REPLポッドのためのKubernetesクラスター
• 🔒 TLSのためのCert Manager + Let’s Encrypt
• 🗃️ 永続化のためのS3互換ストレージ
• 🐳 ランタイム環境のためのDockerイメージ
• ⚙️ メモリ内のセッション追跡のためのRedis

📦 デプロイメントフロー

1. ユーザーがログインしてREPLを作成する
2. core/ がS3上の username/repl-id/ にテンプレートをコピーする
3. core/ がKubernetesにポッド、サービス、イングレスをデプロイする
4. runner/ がWebSocketで接続し、ファイルシステムとターミナルを提供する
5. セッション終了時:
   • 一時的なコンテナが更新されたファイルをS3にアップロードする
   • すべてのK8sリソースがクリーンアップされる

💻 技術スタック

📄 コンポーネントごとのドキュメント

📚 より詳細な実装の詳細については:

• – Backend README.md
• – Runner WebSocket README.md
• – Kubernetes + TLS Setup
• – Frontend README.md

🧠 開発動機

“このプロジェクトは、クラウドインフラストラクチャ、DevOps、フルスタックエンジニアリングへの深い探究を、実際のアプリケーションにまとめたものです。” — Parth Kapoor

🌐 デモとリンク

• 🧪 ライブデモ
• 🧑‍💻 ポートフォリオ
• 🐙 GitHubリポジトリ

🤝 コントリビューション

このプロジェクトは現在積極的に開発されています。テンプレートの追加、不具合の修正、機能の追加など、コントリビュートしたい場合は、 Contributing Guide を参照して始めましょう。プルリクエスト、提案、フィードバックはいつでも歓迎します！

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。