PagePlug mac系统部署

低代码平台PagePlug的mac端部署

由于PagePlug官网目前只提供了windows环境下的部署方式，由于个人需要，要在mac环境下进行本地部署。

一.后端部署

官方部署教程：appsmith教程
环境准备：

• JDK 17
• maven 3.6
• mongoDB 5.0及以上
• redis实例

1. JDK多版本切换（mac）

首先安装对应版本的JDK

open ~/.bash_profile

打开配置文件后进行如下设置

export JAVA_8_HOME="$(/usr/libexec/java_home -v 1.8)"
export JAVA_11_HOME="$(/usr/libexec/java_home -v 11)"
export JAVA_17_HOME="$(/usr/libexec/java_home -v 17)"
alias jdk8='export JAVA_HOME=$JAVA_8_HOME'
alias jdk11='export JAVA_HOME=$JAVA_11_HOME'
alias jdk17='export JAVA_HOME=$JAVA_17_HOME'
export JAVA_HOME=$JAVA17_HOME

之后通过修改JAVA_HOME的引用再执行如下命令即可完成JDK版本的切换

source ~/.bash_profile

2.Maven设置

maven下载地址
首先去maven的网址下载3.6版本，注意要下载binaries，不要下载source压缩包。

下载完成后同样修改./bash_profile文件

#maven
export MAVEN_HOME=/Users/apache-maven-3.6.2 #替换为你的解压后maven文件夹的放置路径
export MAVEN_HOME
export PATH=$MAVEN_HOME/bin:$PATH

接着需要对maven换源，打开/config/setting.xml

  <mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  </mirrors>

3.mongdb设置

这里只需要按照官方说明进行设置即可
置本地MongoDB实例

以下命令将在本地启动MongoDB docker实例：

docker run -d -p 127.0.0.1:27017:27017 --name appsmith mongodb --hostname=localhost-e MONGO_INITDB_DATABASE=appsmith-v/path/to/store/data:/data/db MONGO --replSet rs0

MongoDB对/data/db进行持久化数据映射到/path/to/store/data，可以将其修改为对应的存储地址。访问路径为mongodb://localhost:27017/appsmith.

此命令不会在数据库上设置任何用户名或密码，因此使用端口映射参数中的127.0.0.1，只能从localhost访问。

从官网MongoDB社区版下载下载mongosh

本地化使用mongoDB需要以replica set模式启动并初始化replica set

mongod --port 27017 --dbpath <path/to/db> --replSet <replica-set-name> && mongo --eval “rs.initiate()”

4.Redis

Redis部分也只需和官网保持一致即可

5.启动

# 进入文件夹 
cd app/server

# 创建环境变量文件
cp envs/dev.env.example .env

# 打开.env，配置环境变量
APPSMITH_MONGODB_URI="你的Mongo实例地址"
APPSMITH_REDIS_URL="你的Redis实例地址"

#【可选】如果需要小程序预览功能，需要配置你的小程序信息
CLOUDOS_WECHAT_APPID=""
CLOUDOS_WECHAT_SECRET=""

# 构建 java 服务
mvn clean compile
./build.sh -DskipTests

# 启动 java 服务
./scripts/start-dev-server.sh

二、前端部署

PagePlug给出的只有windows环境下的前端部署，mac部署方式有较大差异appsmith前端部署
环境准备：

• nodejs 18.17.1
  

• yarn 3.5.1

  1.npm

  使用nvm进行npm版本的管理，本人采用的使用brew进行nvm的下载

  brew install nvm
  source $(brew --prefix nvm)/nvm.sh
  nvm ls #查看node版本
  nvm use 18.17.1 #将node版本切换为18.17.1

  2.yarn

  使用brew和npm安装的yarn都为1.x的旧版本
  可以从yarn官网看到新版本的yarn都是通过corepack进行管理

  npm install -g corepack

  之后在/app/client文件夹下使用yarn -v可以看到yarn的版本为3.5.1

3.镜像换源

npm install -g nrm
nrm ls

通过nrm我们可以进行换源和查看常用源的地址

需要注意的是，目前网上很多资料显示淘宝源地址为http://npm.taobao.org 和 http://registry.npm.taobao.org目前均已过期。最新的淘宝源地址为https://registry.npmmirror.com/

npm set registry https://registry.npmmirror.com #手动npm换源

yarn set npmRegistryServer https://registry.npmmirror.com #手动yarn换源

注：新版本yarn配置项中没有registry，取而代之的是registry。

4.前端启动

# 配置 host
127.0.0.1 dev.appsmith.com

# 环境变量
cp .env.example .env

# 启动本地 nginx docker
cd app/client
yarn start-proxy

# 安装依赖
yarn

# 启动前端服务
yarn start-win

client文件夹下的package.json文件需要做相应的改动才可以启动。

• start-win-log：将set命令替换为cross-env来设置环境变量
• start-win：将set命令替换为cross-env来设置环境变量
• preinstall：将preinstall删除
  
  执行yarn命令时会显示无法找到shared文件夹下的js文件，目前是没有这个文件夹的。