Pre-deployment Preparation

This document will guide you through the environment preparation work required before WeDa private deployment to ensure a smooth deployment process.

Prerequisites

Before starting the deployment, please ensure you have prepared the following necessary conditions:

License Requirements

• WeDa Low-Code Development Tool License Key: Please refer to the License Application Guide to obtain one

Technical Requirements

• Docker Environment: Familiarity with and installation of Docker Engine and Docker Compose
• Linux System: Linux-based server or virtual machine
• Network Access: Ensure the server can access the external network

System Environment Requirements

Operating System Support

WeDa private deployment supports the following Linux distributions:

Operating System	Recommended Version
TencentOS Server	3.1 (TK4) or 4.x
CentOS	7.8 or 7.9
OpenCloudOS	8.x or 9.x
Ubuntu Server	22.04 LTS or higher
Debian	12.4 or 12.5

Docker Version Requirements

Docker Version Check

After installation, please check the Docker version. Docker version must be greater than 20.0.0, otherwise you need to upgrade the Docker version.

# Query Docker version
docker version

Hardware Resource Configuration

Minimum Configuration Requirements

Resource Type	Minimum Requirement	Description
Memory	16 GiB	Ensure stable service operation
CPU	8 vCPU	Handle concurrent requests
Storage Space	100 GiB	Space required for Docker data directory

Storage Configuration Recommendations

Production Environment Important Reminder

For production environments or servers with multiple disks, it is strongly recommended to place the Docker data directory on an independent, large-capacity disk to avoid system disk being full and causing service exceptions.

Configuration Expansion

The above are the recommended configurations required for development tool operation. You can allocate more resources for easy instance scaling.

Software Dependency Requirements

Required Software Packages

Please ensure the following software packages are installed:

• curl: Used for downloading installation scripts and files
• unzip: Used for extracting installation packages

Installation Command Examples

# CentOS/RHEL systems
yum install -y curl unzip

# Ubuntu/Debian systems
apt-get update && apt-get install -y curl unzip

Network Configuration Requirements

Port Opening Requirements

Please ensure the following ports are not occupied and have access permissions opened:

Port	Purpose	Customizable
80	WeDa platform access port	✅ Customizable
38080	Installer default port	✅ Customizable

Port Configuration Instructions

For custom port configuration, please refer to: Port and Whitelist IP Configuration

External Network Access Requirements

Network Whitelist Configuration

The following external network addresses need to be accessed during deployment. Please ensure network policies allow access:

• Image Repository Access:

  • weda-private.tencentcloudcr.com:443 - Image pulling
  • https://weda-private.tencentcloudcr.com - Image repository
  • https://tcr-9r3x9jec-1302110647.cos.ap-guangzhou.myqcloud.com - Image storage

• License Service:

  • https://license.tcloudbasegateway.com - Certificate activation and version retrieval

Docker Environment Preparation

Automatic Docker Installation

We provide an automated script to check and install Docker:

# Run Docker installation script
./docker-install.sh

This script will:

1. Check current Docker installation status
2. If not installed, automatically install Docker using package management tools
3. Verify installation results

Domestic Environment Optimization

Mirror Source Configuration

When installing in domestic environments, if you encounter network issues, you can refer to the Cloud Server Operations Guide to replace with domestic mirror sources, then re-execute the installation script.

Environment Verification

After completing the above preparation work, please verify if the environment is ready:

1. System Resource Check

# Check memory
free -h

# Check disk space
df -h

# Check CPU information
lscpu

2. Docker Environment Check

# Check Docker version
docker version

# Check Docker Compose version
docker-compose version

# Test Docker operation (In domestic environments, image pulling may fail due to network issues, you can configure image accelerator or skip this step)
docker run hello-world

3. Network Connectivity Check

# Test external network access
curl -I https://weda-private.tencentcloudcr.com

# Check port occupation
netstat -tlnp | grep -E ':(80|38080)'

Summary

After completing the above preparation work, your environment should meet the following conditions:

1. ✅ Valid WeDa License key obtained
2. ✅ System meets hardware resource requirements
3. ✅ Docker environment properly installed and configured
4. ✅ Necessary software packages installed
5. ✅ Network access permissions configured
6. ✅ Port opening policies set

Now you can proceed with the Docker Deployment Process.