Microservices Engine:MSE Sync migration solution

Deployment modes

• MySQL-dependent deployment

  You must provide your own MySQL service. In your MySQL service, create a database and a user account with read and write permissions for MSE Sync. Pass the MySQL URL, username, and password using environment variables. Multiple MSE Sync instances can share a single MySQL service.

• Derby-dependent deployment

  MSE Sync supports an embedded Derby database and can be run on a single machine.

Environment variables

• Database-related environment variables

  MSE Sync automatically determines whether to use MySQL or the embedded Derby database based on environment variables. If the MYSQL_URL, MYSQL_USER_NAME, and MYSQL_PASSWORD environment variables are all set, MSE Sync connects to a MySQL service at startup. Otherwise, it uses the embedded Derby database.

  Environment variable name	Description	Example
  MYSQL_URL	The connection string for MySQL.	jdbc:mysql://localhost:3306/sync
  MYSQL_USER_NAME	The username of the account that has read and write permissions for MSE Sync.	None
  MYSQL_PASSWORD	The password for the `MYSQL_USER_NAME` account.	None

• JVM-related environment variables

  In the `java.env` file in the `conf` directory, add JVM parameters using the `JAVA_OPT` variable.

  For example, to set the JVM heap memory size, add the following code: JAVA_OPT="$JAVA_OPT -Xms2048m -Xmx2048m".

Deployment methods

• Kubernetes deployment

  1. Modify parameters such as the MySQL username, password, and replicas in the following configuration. Save the configuration file as mse-sync-deployment.yaml.

     apiVersion: apps/v1
     kind: Deployment
     metadata:
       labels:
         app.kubernetes.io/name: mse-sync
       name: mse-sync-svc
     spec:
       replicas: 3
       selector:
         matchLabels:
           app.kubernetes.io/name: mse-sync
       template:
         metadata:
           labels:
             app.kubernetes.io/name: mse-sync
         spec:
           containers:
           - name: mse-sync
             image: msecrinstance-registry.cn-hangzhou.cr.aliyuncs.com/mse-demo/mse-sync:latest
             ports:
             - containerPort: 8000
             env:
             - name: MYSQL_URL
               value: "jdbc:mysql://192.xx.xx.xx:3306/sync"
             - name: MYSQL_USER_NAME
               value: "mse-sync"
             - name: MYSQL_PASSWORD
               value: password

     Note

     To access the MSE Sync UI, add a Service that points to port 8000 of MSE Sync.

  2. Run the following command to deploy MSE Sync.

     kubectl apply -f mse-sync-deployment.yaml

• ECS deployment

  1. Download the MSE Sync binary package.

     curl https://msesync.oss-cn-hangzhou.aliyuncs.com/MseSync.zip --output msesync.zip

  2. Unzip the binary package and navigate to the root directory of MSE Sync.

     unzip ./msesync.zip

  3. Optional: If you use MySQL, configure the following environment variables.

     export MYSQL_URL=""
     export MYSQL_USER_NAME=""
     export MYSQL_PASSWORD=""

  4. Start the application.

     ./MseSync/bin/startup.sh start

Configuration fields

The following sections describe the clusters and tasks fields. Both fields are of the List type.

connectKeyList:
- localhost:8848
- localhost1:8848