forked from LengKundee/MQL5-Google-Onedrive
59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
# Setup, Compilation, and Deployment Guide
|
|
|
|
This guide outlines the steps to setup the environment, compile the MQL5 Expert Advisors, and redeploy the VPS.
|
|
|
|
## 1. Setup and Preparation
|
|
|
|
### Validate Repository
|
|
Ensure the repository meets all quality standards (file sizes, no binary trash, etc.).
|
|
```bash
|
|
python scripts/ci_validate_repo.py
|
|
```
|
|
|
|
### Package MQL5 Files
|
|
Prepare the MQL5 source code for distribution/compilation. This creates a ZIP file in `dist/`.
|
|
```bash
|
|
./scripts/package_mt5.sh
|
|
```
|
|
Output: `dist/Exness_MT5_MQL5.zip`
|
|
|
|
## 2. Compilation (Manual Step)
|
|
|
|
Since the environment is Linux-based, MQL5 compilation must be done on a Windows machine or using MetaEditor.
|
|
|
|
1. **Download** the `dist/Exness_MT5_MQL5.zip` file.
|
|
2. **Extract** it to your MetaTrader 5 `MQL5` folder (e.g., `%APPDATA%\MetaQuotes\Terminal\...\MQL5`).
|
|
3. **Open MetaEditor**.
|
|
4. **Compile** `Experts\EXNESS_GenX_Trader.mq5` and `Experts\SMC_TrendBreakout_MTF_EA.mq5`.
|
|
5. Ensure `Include\ZoloBridge.mqh` and `Include\AiAssistant.mqh` are available.
|
|
|
|
## 3. Redeploy VPS / Cloud
|
|
|
|
To update the VPS or Cloud environment with the latest dashboard and automation scripts:
|
|
|
|
### Option A: Via Docker Hub (Requires Credentials)
|
|
If you have Docker Hub credentials configured:
|
|
```bash
|
|
./scripts/deploy_docker_hub.sh [USERNAME] [TOKEN]
|
|
```
|
|
|
|
### Option B: On the VPS
|
|
SSH into your VPS and run:
|
|
```bash
|
|
./scripts/update_vps.sh
|
|
```
|
|
This will pull the latest `mouyleng/mql5-trading-automation:latest` image and restart the services.
|
|
|
|
### Option C: Deploy to Google Cloud
|
|
To deploy to Google Cloud Platform (Cloud Run or App Engine):
|
|
```bash
|
|
./scripts/deploy_gcp.sh
|
|
```
|
|
This script handles authentication (if needed) and deployment to the configured project (`gen-lang-client-0535796538`). It supports both Cloud Run and App Engine Flex.
|
|
|
|
## 4. Verification
|
|
|
|
Check the health of the deployment:
|
|
```bash
|
|
python scripts/test_web_dashboard.py
|
|
```
|