Microservices Engine:Migration solution based on MSE Sync

Deployment modes

• Use a MySQL database

  You must build a MySQL database, and create an MSE Sync account that has the read and write permissions on the MySQL database. Specify the URL of the MySQL database, account username, and account password for MSE Sync by using environment variables. Multiple MSE Sync tools can share one MySQL database.

• Use a Derby database

  MSE Sync supports embedded Derby databases and can be started on a standalone basis.

Environment variables

• Database-related environment variables

  MSE Sync determines whether to use a MySQL database or an embedded Derby database based on environment variables. If the values of MYSQL_URL, MYSQL_USER_NAME, and MYSQL_PASSWORD are not left empty, MSE Sync is started by connecting the given environment to a MySQL database. In other cases, MSE Sync is started by using an embedded Derby database.

  Environment variable	Description	Example
  MYSQL_URL	The URL of the MySQL database.	jdbc:mysql://localhost:3306/sync
  MYSQL_USER_NAME	The username of the MSE Sync account that has read and write permissions on the MySQL database.	None
  MYSQL_PASSWORD	The password of the MSE Sync account that is specified by MYSQL_USER_NAME.	None

• JVM-related environment variables

  Add JVM parameters to the JAVA_OPT variable in the java.env file in the conf folder.

  For example, you can use JAVA_OPT="$JAVA_OPT -Xms2048m -Xmx2048m" in the code to specify the JVM heap memory.

Deployment methods

• Deploy MSE Sync in a Kubernetes cluster

  1. Modify the parameters such as MYSQL_USER_NAME, MYSQL_PASSWORD, and replicas in the following configurations. Save the modified configurations as the mse-sync-deployment.yaml file.

     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

     If you need to access the MSE Sync UI, you must add port 8000 that points to MSE Sync.

  2. Run the following command to deploy MSE Sync:

     kubectl apply -f mse-sync-deployment.yaml

• Deploy MSE Sync on an ECS instance

  1. Download the binary package of MSE Sync.

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

  2. Decompress the binary package and go to the root directory of MSE Sync.

     unzip ./msesync.zip

  3. Optional. If a MySQL database is used to start your MSE Sync, configure the following environment variables:

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

  4. Start MSE Sync.

     ./MseSync/bin/startup.sh start

Fields

The following table describes the clusters and tasks fields of the List type.

connectKeyList:
- localhost:8848
- localhost1:8848