Skip to content

Commit

Permalink
First public release of VPX.
Browse files Browse the repository at this point in the history
  • Loading branch information
golflima committed Feb 2, 2018
2 parents 1af50ff + c5ee3e0 commit f4460ef
Showing 1 changed file with 17 additions and 4 deletions.
21 changes: 17 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,19 @@
```
3. Restart your Parse server.

## Usage

*VPX* will monitor every modification made on user Parse entities and log them in the class `VpxEntityOperationLog`:

| Field | Type | Description
| :------------ | :------- | :------------------------------------------------------------
| `createdAt` | `Date` | Date of the event
| `operation` | `String` | Operation executed, can be: `created`, `updated` or `deleted`
| `targetClass` | `String` | Class name of the entity modified
| `targetId` | `String` | Parse ID of the entity modified

Note: by default, *VPX* will monitor *create*, *update* and *delete* operations. If a new class is added, *VPX* configuration must be reloaded with job `vpx-reload` or by restarting the Parse server in aim to monitor the added classes.

## Configuration

*VPX* can be configuration through configuration parameters available with Parse.
Expand All @@ -33,17 +46,17 @@ These parameters can be created with Parse Dashboard in `Config > Create a param
* `vpx-reload`: Reloads *VPX* configuration, can be called when new Parse classes have been added to monitor them.
* `vpx-exec-ccc`: Executes the custom cloud code.

## Test locally
## Test it locally

You can use the `docker-compose` provided to run locally *VPX*, Parse Server and Parse Dashboard:

1. Clone or download this repository: `git clone ...`
2. Run docker-compose: `docker-compose up`
1. Clone or download this repository: `git clone https://github.com/virtua-sa/virtua-parse-extended.git`
2. Run docker-compose: `cd virtua-parse-extended`, then `docker-compose up`
3. Browse to: http://dashboard.vpx.docker/
* Login and password can be found in the `docker-compose.yml` file, under section `parse-dashboard > environment > PARSE_DASHBOARD_USER_*`

Note: you'll need [`dnsdock`](https://github.com/aacebedo/dnsdock) in aim to use this setup.
## Licence terms
## License terms
*VPX - Virtua Parse eXtended* is published under the terms of [GNU Affero General Public License v3](https://www.gnu.org/licenses/agpl-3.0.html), see the [LICENSE](LICENSE) file.

0 comments on commit f4460ef

Please sign in to comment.