Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 0 additions & 6 deletions .gitmodules
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,3 @@
[submodule "LDAP/LDAPServer"]
path = LDAP/LDAPServer
url = https://github.com/mieweb/LDAPServer.git
[submodule "ci-cd-automation/Proxmox-Launchpad"]
path = ci-cd-automation/Proxmox-Launchpad
url = https://github.com/maxklema/proxmox-launchpad.git
[submodule "mie-opensource-landing"]
path = mie-opensource-landing
url = https://github.com/maxklema/mie-opensource-landing
1 change: 0 additions & 1 deletion ci-cd-automation/Proxmox-Launchpad
Submodule Proxmox-Launchpad deleted from f40fda
1 change: 0 additions & 1 deletion mie-opensource-landing
Submodule mie-opensource-landing deleted from 31c40c
20 changes: 20 additions & 0 deletions mie-opensource-landing/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Dependencies
/node_modules

# Production
/build

# Generated files
.docusaurus
.cache-loader

# Misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local

npm-debug.log*
yarn-debug.log*
yarn-error.log*
3 changes: 3 additions & 0 deletions mie-opensource-landing/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# MIE Open Source Landing Page

A modern, responsive landing page showcasing MIE's open source initiatives, built with [Docusaurus](https://docusaurus.io/). Features container management tools, Proxmox Launchpad CI/CD integration, and comprehensive documentation.
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"label": "Creating Containers",
"position": 3,
"link": {
"type": "generated-index",
"description": "Learn how to create and set up both basic LXCs and deployment-ready LXC Containers"
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"label": "Creating Advanced Containers",
"position": 2,
"link": {
"type": "generated-index",
"description": "Learn how to create and set up deployment-ready LXC Containers from the command line."
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
---
sidebar_position: 1
---

# Deploying Containers Overview

The MIE Opensource Proxmox Cluster provides automated container deployment capabilities, allowing you to deploy applications directly from GitHub repositories without manual setup. This automation eliminates the need to SSH into containers, manually install dependencies, configure services, and start applications.

:::note Note
As of writing (8/14/25), automatic deploy only supports components that run on either a `nodejs` or `python` runtime environment.
:::

## Single vs Multi-Component Applications

### Single Component Applications

A **single component application** consists of one independent service or process that requires:
- One set of installation commands (e.g., `npm install`)
- One start command (e.g., `npm start`)
- One runtime environment (e.g., Node.js, Python)
- One package list or dependency file

**Examples:**
- A React frontend application
- A simple Express.js server
- A Flask API server
- A Meteor application

:::tip Tip
See the documentation for deploying single-component applications [here](/docs/creating-containers/advanced-containers/single-component).
:::

### Multi-Component Applications

A **multi-component application** consists of multiple independent services that each require:
- Their own installation commands
- Their own start commands
- Their own runtime environments
- Their own dependency files and environment variables

**Examples:**
- React frontend + Flask backend
- Vue.js frontend + Express.js API + MongoDB
- Angular frontend + Django backend + PostgreSQL
- Multiple microservices working together

:::tip Tip
See the documentation for deploying multi-component applications [here](/docs/creating-containers/advanced-containers/multi-component).
:::

### Key Differences

| Aspect | Single Component | Multi-Component |
|--------|------------------|-----------------|
| **Services** | One service/process | Multiple independent services |
| **Dependencies** | One package file | Multiple package files per component |
| **Runtime** | One runtime environment | Multiple runtime environments (although each runtime environment could be the same) |
| **Start Commands** | One start command | Multiple start commands |
| **Environment Variables** | One .env file | Multiple .env files per component |

## Benefits of Automated Deployment

### Eliminates Manual Setup
- **No SSH Required**: Deploy without manually connecting to containers
- **Automatic Dependencies**: Dependencies are installed automatically from package files
- **Service Configuration**: Required services (MongoDB, PostgreSQL, etc.) are installed and configured automatically
- **Environment Setup**: Environment variables are configured in the correct locations

### Reduces Deployment Time
- **Instant Deployment**: Applications are ready immediately after container creation
- **Consistent Environment**: Same deployment process every time, reducing errors
- **Parallel Processing**: Multiple components are set up simultaneously

### Simplifies Development Workflow
- **GitHub Integration**: Deploy directly from your repository with Proxmox Launchpad

:::note Note
It is recommended to deploy your application on a test container via the command line first before working with [Proxmox Launchpad](/docs/category/proxmox-launchpad).
:::


## When to Use Each Method

**Choose Single Component Deployment when:**
- Your application runs as one process
- All dependencies are in one package file
- You have one entry point/start command

**Choose Multi-Component Deployment when:**
- Your application has separate frontend and backend
- Different parts use different runtime enviornments
- Components have different dependency requirements
- You need different environment variables for different services

---

Ready to deploy? Choose your deployment method:
- [Single Component Deployment Guide](/docs/creating-containers/advanced-containers/single-component)
- [Multi-Component Deployment Guide](/docs/creating-containers/advanced-containers/multi-component)

Loading
Loading