Docker β€ Parse
βοΈ One-Click Deploy
β Features
- Parse Server with MongoDB
- Parse Cloud Code via git with auto rebuild
- Parse Push Notification : iOS, Android
- Parse Live Query
- Parse Dashboard
- Tested Docker Image
- Deploy with Docker
- Deploy with Docker Compose
- Deploy with one click
- GraphQL support
GRAPHQL_SUPPORT=true,GRAPHQL_SCHEMA=YOUR_SCHEMA_URL(default to./cloud/graphql/schema.js)
πΊ Overview
π Sneak Preview
π Deployments
Note
- If you are upgrading from version below 2.3.0, please see these recommended steps.
π Deploy with Docker
$ 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
# Test 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
# The above command will asuume you will later create a ssh
# and log into the dashboard remotely in production.
# However, to see the dashboard instanly using either
# localhost:4040 or someip:4040(if hosted somewhere remotely)
# then you need to add extra option to allowInsecureHTTP like
# It is also required that you create username and password
# before accessing the portal else you cant get in
$ docker run -d \
-e PARSE_DASHBOARD_CONFIG='{"apps":[{"appId":"<appid>","serverURL":"http://localhost:1337/parse","masterKey":"<masterkey>","appName":"<appname>"}],"users":[{"user":"<username>","pass":"<password>"}]}' \
-e PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1 \
-p 4040:4040 \
--link parse-server \
--name parse-dashboard \
yongjhih/parse-dashboard
π Deploy with Docker Compose
$ 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 -dNote
- We use
PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1to allow insecure via development environment.
$ 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 - # not supported for docker-compose container
π Deploy to Cloud Services
- Heroku + Mongolab Development
- AWS Elastic Beanstalk
- Microsoft Azure App Service
- Google App Engine
- Scalingo
β‘ Advance topics
- How to use with existing mongodb with DATABASE_URI
- How to use with existing parse-cloud-code
- How to use with custom authentication
- How to specify parse-server version
- How to specify latest commit of parse-server
- How to start parse dashboard as standalone
- How to setup SSL with letsencrypt
- How to setup push notification
- How to integrate parse-cloud-code image on GitHub and DockerHub
- How to config Docker
- How to config Docker Compose
- How to import ssh-key from github
π₯ Server Side Developments
How to push cloud code to server
# This command wil create a SSH keys for you as
# ~/.ssh/id_rsa.pub and another private key.
# you can leave the options balnk by pressing enter.
$ ssh-keygen -t rsa
# If git container name is `parse-cloud-code-git`
$ docker exec -i parse-cloud-code-git ssh-add-key < ~/.ssh/id_rsa.pub
# port 2022, repo path is `/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π± Client Side Developments
You can use the REST API, the JavaScript SDK, and any of our open-source SDKs:
π curl example
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 example
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 example
//in your application class
Parse.initialize(new Parse.Configuration.Builder(getApplicationContext())
.applicationId("YOUR_APP_ID")
.clientKey("YOUR_CLIENT_ID")
.server("http://YOUR_SERVER_URL/parse/") // '/' important after 'parse'
.build());
ParseObject testObject = new ParseObject("TestObject");
testObject.put("foo", "bar");
testObject.saveInBackground();
π iOS example
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
Run with GraphQL support.
GRAPHQL_SUPPORT=true APP_ID=YOUR_APP_ID MASTER_KEY=YOUR_MASTER_KEY SERVER_URL=http://localhost:1337/parse docker-compose up -dMake sure
./cloud/graphql/schema.jsis pushed to cloud code.
Then navigate to http://localhost:1337/graphql?query=%7B%0A%20%20hello%0A%7D%0A
π See Also
- https://github.com/ParsePlatform/parse-server
- http://blog.parse.com/announcements/introducing-parse-server-and-the-database-migration-tool/
- https://parse.com/docs/server/guide#migrating
- 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://medium.com/cowbear-coder/migration-of-parse-server-with-docker-part1-87034cc29978
- https://github.com/yongjhih/docker-parse-dashboard
- Docker
β€ Parse - DigitalOcean β€ Parse
π Contributors & Credits
