使用Docker在MacOS上部署Parse Server和Parse Server Dashboard

部署parse-server

官方镜像在这里parseplatform/parse-server，就当前日期（2022年9月1日），官方的文档并没有着重介绍如何使用Docker进行部署。

第一步：拉取parse-server镜像到本地

docker pull parseplatform/parse-server

第二步：挂载

我们需要考虑的挂载包括下面这些内容：

配置文件：/parse-server/config
Cloud Code：/parse-server/cloud
日志：/parse-server/logs

我们需要在主机内创建相应的文件/目录，通过 -v 指令将本地的和镜像内的进行挂载（映射）。

首先，需要在本地创建相应的目录，在我们的项目开发目录parse.server.docker下创建下面这些目录以及子目录。

cd $HOME 
cd parse.server.docker
mkdir ./parse-server
mkdir ./logs/parse-server
mkdir -p ./parse-server/{config,cloud}
touch ./parse-server/config/config.json
touch ./parse-server/cloud/main.js

初始化配置文件

{
  "appId": "APPLICATION_ID",
  "masterKey": "MASTER_KEY",
  "appName": "Hello World",
  "serverURL": "http://localhost:1337/parse",
  "cloud":"/parse-server/cloud/main.js",
  "databaseURI": "mongodb://parse:parse@mongo/parse_server_database"
}

这里我们配置了几个必备的参数，如需要更多的配置，可以参考配置文件。

这里需要非常注意：由于我们的mongo数据库也是由docker启动的，databaseURI必须以这种格式进行书写：即mongodb://用户名:密码@由docker启动的mongdb的名字/数据库名。例如结合我们之前创建的，这里应该为：--databaseURI mongodb://parse:parse@mongo/parse_server_database

此外，目前我们的serverURL使用的是http://localhost:1337/parse，而非https://localhost:1337/parse。如果需要支持https，这就是另一个故事了。

初始化Cloud Code文件

Parse.Cloud.define("HelloCloud", async (request) => {
    return 'Hello Cloud';
  });

这里我们定义一个“HelloCloud”函数，方便我们后面测试Cloud功能。

第三步：启动parse-server

cd $HOME/parse.server.docker
docker run \
--name parse-server \
-p 1337:1337 \
-v $(pwd)/parse-server/config:/parse-server/config \
-v $(pwd)/parse-server/cloud:/parse-server/cloud \
-v $(pwd)/logs/parse-server:/parse-server/logs \
--link mongo:mongo \
-d parseplatform/parse-server /parse-server/config/config.json

在这里我们根据配置文件启动Parse Server，因此不需要再额外指定parse-server的启动参数了。

第四步：测试Parse-Server

在这里我们使用REST API进行测试，执行下面的命令，往数据库表GameScore中插入一条数据

curl -X POST \
-H "X-Parse-Application-Id: APPLICATION_ID" \
-H "Content-Type: application/json" \
-d '{"score":1337,"playerName":"Sean Plott","cheatMode":false}' \
http://localhost:1337/parse/classes/GameScore

返回结果类似，这样就是执行成功了。

{
  "objectId":"l7D7mO73Jh",
  "createdAt":"2022-08-31T22:12:15.955Z"
}

第五步：测试Cloud Code

执行下面的命令

curl -X POST \
  -H "X-Parse-Application-Id: APPLICATION_ID" \
  -H "Content-Type: application/json" \
  http://localhost:1337/parse/functions/HelloCloud

返回的结果如下：

{"result":"Hello Cloud"}

---

部署parse-dashboard

第一步：拉取parse-dashboard镜像到本地

docker pull parseplatform/parse-dashboard:4.1.4

为什么指定版本？因为当前的latest版本有一个错误（https://github.com/parse-community/parse-dashboard/issues/2194）

第二步：挂载

我们需要考虑的挂载包括下面这些内容：

配置文件：/src/Parse-Dashboard/parse-dashboard-config.json

首先，需要在本地创建相应的目录，在我们的项目开发目录parse.server.docker下创建下面这些目录以及子目录。

cd $HOME 
cd parse.server.docker
mkdir ./parse-dashboard
mkdir ./parse-dashboard/config
touch ./parse-dashboard/config/parse-dashboard-config.json

初始化配置文件

{
    "apps": [
        { 
            "serverURL": "http://localhost:1337/parse",
            "appId": "APPLICATION_ID",
            "masterKey": "MASTER_KEY",
            "appName": "Hello World",
        }
    ],
    "users": [
        {
            "user":"parse",
            "pass":"password"
        }
    ]
}

第三步：启动parse-dashboard

cd $HOME/parse.server.docker
docker run \
--name parse-dashboard \
-p 4040:4040 \
-v $(pwd)/parse-dashboard/config/parse-dashboard-config.json:/src/Parse-Dashboard/parse-dashboard-config.json \
-d parseplatform/parse-dashboard:4.1.4 \
--allowInsecureHTTP \
--mountPath /parse-dashboard

注意，parse dashboard默认只能通过https访问，指定--allowInsecureHTTP则可以通过http访问。--mountPath /parse-dashboard非常重要，而且/不能省。

第四步：验证

在浏览器中输入http://localhost:4040，会出现如下的页面、

截屏2022-09-01 16.13.42.png

输入用户名密码之后，跳转到如下的页面

截屏2022-09-01 16.13.59.png