mstrazds/docker-parse-server

Docker ❤ Parse

https://img.shields.io/docker/pulls/yongjhih/parse-server.svg](https://hub.docker.com/r/yongjhih/parse-server/) https://img.shields.io/docker/stars/yongjhih/parse-server.svg](https://hub.docker.com/r/yongjhih/parse-server/) https://img.shields.io/github/tag/yongjhih/docker-parse-server.svg](https://hub.docker.com/r/yongjhih/parse-server/tags/) https://img.shields.io/github/license/yongjhih/docker-parse-server.svg](https://github.com/yongjhih/docker-parse-server/raw/master/LICENSE.txt) https://img.shields.io/travis/yongjhih/docker-parse-server.svg](https://travis-ci.org/yongjhih/docker-parse-server) https://img.shields.io/gitter/room/yongjhih/docker-parse-server.svg](https://gitter.im/yongjhih/docker-parse-server)

一键部署

https://www.herokucdn.com/deploy/button.png](https://heroku.com/deploy) 

核心功能

• 集成MongoDB的Parse Server
• 支持Git自动重建的Parse云代码
• Parse推送通知（iOS、Android）
• Parse实时查询
• Parse Dashboard管理界面
• 经过测试的Docker镜像
• 支持Docker部署
• 支持Docker Compose部署
• 一键部署
• GraphQL支持（通过GRAPHQL_SUPPORT=true和GRAPHQL_SCHEMA配置）

概述

!https://github.com/yongjhih/docker-parse-server/raw/master/art/parse-server-diagram.png

部署方案

注意

• 若从2.3.0以下版本升级，请参考https://github.com/ParsePlatform/parse-server/blob/master/2.3.0.md%E3%80%82

Docker部署

sh
$ docker run -d -p 27017:27017 --name mongo mongo

$ docker run -d                                \
             -e APP_ID=${APP_ID}         \
             -e MASTER_KEY=${MASTER_KEY} \
             -p 1337:1337                      \
             --link mongo                      \
             --name parse-server               \
             yongjhih/parse-server

$ docker run -d                                \
             -p 2022:22                        \
             --volumes-from parse-server       \
             --name parse-cloud-code-git       \
             yongjhih/parse-server:git

# 测试parse-server
$ curl -X POST \
  -H "X-Parse-Application-Id: {appId}" \
  -H "Content-Type: application/json" \
  -d '{}' \
  http://localhost:1337/parse/functions/hello

$ docker run -d \
             -e APP_ID=${APP_ID}         \
             -e MASTER_KEY=${MASTER_KEY} \
             -e SERVER_URL=http://localhost:1337/parse \
             -p 4040:4040                      \
             --link parse-server               \
             --name parse-dashboard            \
             yongjhih/parse-dashboard

# 生产环境中上述命令需通过SSH远程登录管理面板，若需直接访问（如本地开发），需添加允许不安全HTTP的配置，并设置用户名密码：
$ docker run -d \
             -e APP_ID=$(APP_ID)\
             -e MASTER_KEY=$(MASTER_KEY)\
             -e SERVER_URL=http://localhost:1337/parse \
             -e PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1  \
             -e USER1=yourUsername  \
             -e USER1_PASSWORD=yourUsernamesPassword \
             -p 4040:4040                      \
             --link parse-server               \
             --name parse-dashboard            \
             yongjhih/parse-dashboard

Docker Compose部署

sh
$ wget https://github.com/yongjhih/docker-parse-server/raw/master/docker-compose.yml
$ APP_ID=YOUR_APP_ID MASTER_KEY=YOUR_MASTER_KEY PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1 SERVER_URL=http://localhost:1337/parse docker-compose up -d

注意

• 开发环境中使用PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1允许不安全HTTP访问。

• $ wget https://github.com/yongjhih/docker-parse-server/raw/master/docker-compose.yml -O - | APP_ID=YOUR_APP_ID MASTER_KEY=YOUR_MASTER_KEY docker-compose up -d -f - # Docker Compose容器不支持此方式

云服务部署

• Heroku + Mongolab开发
• AWS Elastic Beanstalk
• Microsoft Azure App Service
• Google App Engine
• Scalingo

高级主题

• 如何使用现有MongoDB（通过DATABASE_URI）
• 如何使用现有Parse云代码
• 如何使用自定义认证
• 如何指定Parse Server版本
• 如何指定Parse Server最新提交版本
• 如何独立启动Parse Dashboard
• 如何通过Let's Encrypt设置SSL
• 如何设置推送通知
• 如何集成GitHub和DockerHub上的Parse云代码镜像
• 如何配置Docker
• 如何配置Docker Compose
• 如何从GitHub导入SSH密钥

服务端开发

如何推送云代码到服务器
https://github.com/yongjhih/docker-parse-server/raw/master/art/docker-parse-server-git.gif]([***]

sh
# 生成SSH密钥对（~/.ssh/id_rsa.pub和私钥），按提示操作即可
$ ssh-keygen -t rsa

# 若Git容器名为`parse-cloud-code-git`
$ docker exec -i parse-cloud-code-git ssh-add-key < ~/.ssh/id_rsa.pub

# 端口2022，仓库路径为`/parse-cloud-code`
$ git clone ssh://git@localhost:2022/parse-cloud-code
$ cd parse-cloud-code
$ echo "Parse.Cloud.define('hello', function(req, res) { res.success('Hi, git'); });" > main.js
$ git add main.js && git commit -m 'Update main.js'
$ git push origin master

# 测试云代码
$ curl -X POST \
  -H "X-Parse-Application-Id: ${APP_ID}" \
  -H "Content-Type: application/json" \
  -d '{}' \
  http://localhost:1337/parse/functions/hello

客户端开发

可使用REST API、JavaScript SDK或其他开源SDK：

curl示例

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

curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "Content-Type: application/json" \
  -d '{}' \
  http://localhost:1337/parse/functions/hello

curl -H "X-Parse-Application-Id: YOUR_APP_ID" \
     -H "X-Parse-Master-Key: YOUR_MASTER_KEY" \
     -H "Content-Type: application/json" \
     http://localhost:1337/parse/serverInfo

JavaScript示例

Parse.initialize('YOUR_APP_ID','unused');
Parse.serverURL = 'https://whatever.herokuapp.com';
var obj = new Parse.Object('GameScore');
obj.set('score',1337);
obj.save().then(function(obj) {
  console.log(obj.toJSON());
  var query = new Parse.Query('GameScore');
  query.get(obj.id).then(function(objAgain) {
    console.log(objAgain.toJSON());
  }, function(err) {console.log(err); });
}, function(err) { console.log(err); });

Android示例

// 在应用类中
Parse.initialize(new Parse.Configuration.Builder(getApplicationContext())
        .applicationId("YOUR_APP_ID")
        .clientKey("YOUR_CLIENT_ID")
        .server("http://YOUR_SERVER_URL/parse/")   // 'parse'后需加 '/'
        .build());

ParseObject testObject = new ParseObject("TestObject");
testObject.put("foo", "bar");
testObject.saveInBackground();

iOS示例

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject:AnyObject]?) -> Bool {
        let configuration = ParseClientConfiguration {
            $0.applicationId = "YOUR_APP_ID"
            $0.clientKey = "YOUR_CLIENT_ID"
            $0.server = "http://YOUR_SERVER_URL/parse"
        }
        Parse.initializeWithConfiguration(configuration)
    }
}

GraphQL支持

启用GraphQL功能：

shell
GRAPHQL_SUPPORT=true APP_ID=YOUR_APP_ID MASTER_KEY=YOUR_MASTER_KEY SERVER_URL=http://localhost:1337/parse docker-compose up -d

确保./cloud/graphql/schema.js已推送至云代码。
访问：http://localhost:1337/graphql?query=%7B%0A%20%20hello%0A%7D%0A

参考链接

• https://github.com/ParsePlatform/parse-server
• [***]
• [***]
• https://hub.docker.com/r/yongjhih/parse-server/
• https://github.com/yongjhih/parse-cloud-code
• https://hub.docker.com/r/yongjhih/parse-cloud-code/
• [***]
• https://github.com/yongjhih/docker-parse-dashboard
• Docker ❤ Parse
• DigitalOcean ❤ Parse

贡献者与致谢

https://github.com/didierfranc.png?size=40](https://github.com/didierfranc) https://github.com/ArnaudValensi.png?size=40](https://github.com/ArnaudValensi) https://github.com/gerhardsletten.png?size=40](https://github.com/gerhardsletten) https://github.com/acinader.png?size=40](https://github.com/acinader) https://github.com/kandelvijaya.png?size=40](https://github.com/kandelvijaya) https://github.com/mjdev https://github.com/vitaminwater.png?size=40](https://github.com/vitaminwater) https://github.com/euklid https://github.com/walkerlee https://github.com/chainkite https://github.com/cleever.png?size=40](https://github.com/cleever) https://github.com/katopz.png?size=40](https://github.com/katopz)