Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
alex-cova authored Apr 24, 2022
1 parent 54d7b6b commit 58f35c7
Showing 1 changed file with 66 additions and 1 deletion.
67 changes: 66 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,66 @@
# DatastoreWorkBench
# Local Datastore Browser

LDB Or Local Datastore Browser is the missing tool to work with the GCP Datastore emulator

<img width="932" alt="Screen Shot 2022-04-23 at 23 47 52" src="https://user-images.githubusercontent.com/25180512/164957260-56467c9f-5bed-455f-baf5-218ed562bec9.png">


## 1. Get Datastore Emulator Up & Running

**datastore-compose.yaml**

```
docker-compose -f datastore-compose.yaml up
```

```yaml
version: '3.8'
services:
datastore-local:
command: "gcloud beta emulators datastore start --project test-project --host-port 0.0.0.0:8081 --consistency 1.0"
image: "gcr.io/google.com/cloudsdktool/cloud-sdk:382.0.0-emulators"
container_name: datastore-local
ports:
- "8081:8081"
volumes:
- "./datastore:/root/.config/gcloud/emulators/datastore/WEB-INF/appengine-generated/"
working_dir: /home/datastore

```

## 2. Open LDB

Java 17 or newer is requiered.

```
java - jar 'fileName.jar'
```

## 3. Set up your project-id

<img width="374" alt="Screen Shot 2022-04-23 at 23 48 16" src="https://user-images.githubusercontent.com/25180512/164957371-f13fad79-0f2c-4504-a5c8-f2f9daf14ebb.png">

## 4. Browse your data

<img width="932" alt="Screen Shot 2022-04-23 at 23 47 57" src="https://user-images.githubusercontent.com/25180512/164957384-47ebe946-43de-4914-bd88-eb587492024e.png">

## Why I made this & TODO List

I've been working with Datastore (Firestore mode) for a while, when one of the tests fails can be [tricky](https://cloud.google.com/datastore/docs/tools/emulator-export-import) to check what happened, maybe I'm wrong, But despite of that I'm kinda UI man, so enjoyed making this app in my free time and it already saved me hours of work :).

TODO

- [ ] Paginator
- [x] Entity Viewer
- [ ] UI Components for filters
- [ ] Entity Editor
- [ ] Data Exporter/Importer
- [x] Kind properties viewer
- [ ] Clean up the code

And much more...

---

This application is powered by OpenSource projects

0 comments on commit 58f35c7

Please sign in to comment.