Parse Server is an open source backend that can be deployed to any infrastructure that can run Node.js.

Our Sponsors

Our backers and sponsors help to ensure the quality and timely development of the Parse Platform.

🥉 Bronze Sponsors

Parse Server works with the Express web application framework. It can be added to existing web applications, or run by itself.

Documentação oficial
Container Parse Alpine
Docker Compose
Customizando a configuração de inicialização
Suporte

Documentação oficial

A documentação da plataforma Parse pode ser vista clicando aqui

Parse Server: https://docs.parseplatform.org/parse-server/guide/
Parse GraphQL API: https://docs.parseplatform.org/graphql/guide/
Parse iOS: https://docs.parseplatform.org/ios/guide/
Parse Android: https://docs.parseplatform.org/android/guide/
Parse Javascript: https://docs.parseplatform.org/js/guide/
Parse .NET + Xamarin: https://docs.parseplatform.org/dotnet/guide/
Parse macOS: https://docs.parseplatform.org/macos/guide/
Parse Unity: https://docs.parseplatform.org/unity/guide/
Parse PHP: https://docs.parseplatform.org/php/guide/
Parse Arduino: https://docs.parseplatform.org/arduino/guide/
Parse Embedded C: https://docs.parseplatform.org/embedded_c/guide/
Parse Cloud Code: https://docs.parseplatform.org/cloudcode/guide/
Parse REST API: https://docs.parseplatform.org/rest/guide/

Container Parse Alpine

A imagem deste container cria uma instancia do servidor Parse. A estrutura do container é flexível o que torna a sua criação preparada para o público alvo iniciante ao avançado.

Estrutura interna

Internamente no seu diretório raiz o container possui um diretório chamado parse-server, nele estão contidas todas as configurações necessárias para a inicialização do serviço.

A estrutura deste diretório está organizada conforme descrito a seguir:

cloud (diretório): Configuração do Cloud Code;
cloud/main.js: A arquivo main.js contém as Cloud Functions e que são repassadas para o Parse Server. Para mais informação acesse o link.
server.js: Arquivo de inicialização da instância do Parse Server, escrito em node.js com uso do framework Express.

Exemplo de configuração do server.js

// Example express application adding the parse-server module to expose Parse
// compatible API routes.

var express = require("express");
var ParseServer = require("parse-server").ParseServer;
var path = require("path");

var api = new ParseServer({
  databaseURI:
    process.env.PARSE_DATABASE_URI || "mongodb://localhost:27017/dev",
  cloud: process.env.PARSE_CLOUD_CODE_MAIN || __dirname + "/cloud/main.js",
  appId: process.env.PARSE_APP_ID || "myAppId",
  masterKey: process.env.PARSE_MASTER_KEY || "", //Add your master key here. Keep it secret!
  serverURL: process.env.PARSE_URL || "http://localhost:1337/parse", // Don't forget to change to https if needed
  liveQuery: {
    classNames: ["Posts", "Comments"], // List of classes to support for query subscriptions
  },
});
// Client-keys like the javascript key or the .NET key are not necessary with parse-server
// If you wish you require them, you can set them as options in the initialization above:
// javascriptKey, restAPIKey, dotNetKey, clientKey

var app = express();

// Serve static assets from the /public folder
app.use("/public", express.static(path.join(__dirname, "/public")));

// Serve the Parse API on the /parse URL prefix
var mountPath = process.env.PARSE_MOUNT || "/parse";
app.use(mountPath, api);

// Parse Server plays nicely with the rest of your web routes
app.get("/", function (req, res) {
  res.status(200).send("Starting parse-server platform");
});

// There will be a test page available on the /test path of your server url
// Remove this before launching your app
app.get("/test", function (req, res) {
  res.sendFile(path.join(__dirname, "/public/test.html"));
});

var port = process.env.PARSE_PORT_NUMBER || 1337;
var httpServer = require("http").createServer(app);

httpServer.listen(port, function () {
  console.log("parse-server-example running on port " + port + ".");
});

// This will enable the Live Query real-time server
ParseServer.createLiveQueryServer(httpServer);

Exemplo de configuração do main.js

Parse.Cloud.define("hello", function (req, res) {
  return "Hi";
});

Variáveis de Ambiente

PARSE_URL: Indica qual URL o parse poderá ser acessado.

Valor padrão: http://localhost:1337/parse

PARSE_MOUNT: Ponto de montagem para acesso a API do parse.

Valor padrão: "/parse"

PARSE_PORT_NUMBER: Porta para acesso a plataforma.

Valor padrão: 1337

PARSE_APP_ID: O ID do aplicativo a ser utilizado pela instância do servidor. Você pode usar qualquer sequência arbitrária. Para aplicativos migrados, isso deve corresponder ao seu aplicativo Parse hospedado.

Valor padrão: myappID

Observação: Para mais detalhes sobre o AppId veja a documentação do parse server no link.

PARSE_MASTER_KEY: A chave mestra a ser usada para substituir a segurança da ACL. Você pode usar qualquer sequência arbitrária. Mantenha em segredo! Para aplicativos migrados, isso deve corresponder ao seu aplicativo Parse hospedado.

Valor padrão: mymasterKey

Observação: Para mais detalhes sobre o AppId veja a documentação do parse server no link.

PARSE_DATABASE_URI: URI de acesso ao banco de dados.

Valor padrão: mongodb://mongo.parse:27017/database_dev

Observação: Se você utilizar a instância com suporte ao mongodb, veja (aqui)[https://docs.mongodb.com/manual/reference/connection-string/], como a URI do mongo é formatada. Observação 2: Se você utilizar a intância com suporte ao postgresql, veja (aqui)[https://tableplus.com/blog/2018/08/connection-uri-syntax-in-postgresql.html], como a URI do postgres é formatada.

PARSE_CLOUD_CODE_MAIN: Arquivo javascript onde estão armazenadas as cloud functions.

Valor padrão: /parse-server/cloud/main.js

Docker Compose

version: "3.5"
services:
  mongodb_parse:
    image: "mongo:latest"
    ports: 
      -  27017:27017
    restart: always
    environment:
        - MONGO_INITDB_ROOT_USERNAME=root
        - MONGO_INITDB_ROOT_PASSWORD=123456
        - MONGO_INITDB_DATABASE=database_dev
    volumes:
        - mongodb_data:/data/db
  parse_platform:
    image: "parse-platform-alpine:latest"
    ports:
      - "1337:1337"
    environment:
      - PARSE_URL=http://localhost:1337/parse
      - PARSE_MOUNT=/parse
      - PARSE_PORT_NUMBER=1337
      - PARSE_APP_ID=myappID
      - PARSE_MASTER_KEY=mymasterKey
      - PARSE_DATABASE_URI=mongodb://root:123456@mongodb_parse:27017/database_dev?authSource=admin
    depends_on:
      - mongodb_parse
volumes:
  mongodb_data:
    driver: local

Customizando a configuração de inicialização

A qualquer momento você pode customizar a configuração de inicialização do seu container. Isso permitirá adeque o container a qualquer cenário de uso. Recomendações para customização:

Obedeça a estrutura hierárquica do container;

O container precisa basicamento de um diretório na sua raiz com o nome parse-server e dentro deste diretório devem ter:

 - /parser-server/cloud/main.js
 - /parser-server/server.js
 - /parser-server/package.json

Configure o diretório como um volume do tipo bind;
O package.json deve obter no mínimo a seguinte estrutura (em desenvolvimento):

{
  "name": "parse-server",
  "version": "1.0.0",
  "description": "",
  "main": "server.js",
  "dependencies": {
    "parse-server": "^4.2.0",
    "express": "^4.17.1"
  },
  "devDependencies": {},
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node server.js"
  },
  "author": "",
  "license": "ISC"
}

Você está livre para adicionar qualquer novo pacote dentro da plataforma. O container ficará encarregado de instalar o que for necessário.

Você pode reconfigurar o arquivo de inicialização do server da forma que você achar mais conveniente. Siga como exemplo o modelo listado nesta documentação clicando (aqui)[#exemplo-de-configuração-do-mainjs].
Mude o entrypoint do container apontando para o script /reinstall_parse.sh.

Suporte

Em caso de dúvidas entre em contato comigo ou visite a documentação do parse.

Deixo aqui meus contatos:

dilsonjlrjr / parse-server-alpine