startinblox-startinoff/README.md

223 lines
6.2 KiB
Markdown
Raw Normal View History

2021-03-17 14:41:20 +00:00
# startinblox-startinoff
2021-06-02 12:26:56 +00:00
## Quick-start: Gettin' started with Startin'blox
1. Sign up for an account on https://git.startinblox.com
2. Add your SSH key here: https://git.startinblox.com/profile/keys
3. Create a project folder, I'll use `export PROJECT_FOLDER=~/Projects/Autonomic/StartinBlox/` -- all subsequent steps are run from `$PROJECT_FOLDER`
4. (Optional) Create a Python virtual environment using your preferred method,
2021-06-02 12:44:47 +00:00
or e.g.
```
$ python3 -m venv $PROJECT_FOLDER/venv
$ source $PROJECT_FOLDER/venv/bin/activate
```
2021-06-02 12:26:56 +00:00
5. Check out the `djangoldp` code:
```
$ git clone git@git.startinblox.com:djangoldp-packages/djangoldp.git
```
2021-06-03 13:17:27 +00:00
and install it:
2021-06-02 12:44:47 +00:00
```
$ cd $PROJECT_FOLDER/djangoldp
$ pip install -e .
2021-06-02 12:26:56 +00:00
$ pip install psycopg2 pycryptodomex # is this still needed?
2021-06-02 12:44:47 +00:00
```
2021-06-02 12:26:56 +00:00
6. Check out this very repository:
```
$ git clone https://git.autonomic.zone/decentral1se/startinblox-startinoff
2021-06-03 13:29:24 +00:00
$ cd startinblox-startinoff
```
and copy example settings to `settings.yml`:
```
$ cp example-settings.yml settings.yml
2021-06-02 12:26:56 +00:00
```
7. Install dependencies:
2021-06-02 12:44:47 +00:00
```
$ djangoldp install
```
2021-06-02 12:26:56 +00:00
8. Run database migrations:
2021-06-02 12:44:47 +00:00
```
$ python manage.py migrate
```
9. Create an RSA key for OAuth:
```
$ python manage.py creatersakey
```
2021-06-02 12:26:56 +00:00
9. Launch the development server:
2021-06-02 12:44:47 +00:00
```
$ python manage.py runserver
$ # Or, alternatively:
$ djangoldp runserver
```
2021-06-02 12:26:56 +00:00
## Quick start 2: this time, it's Hubl!
2021-06-02 12:44:47 +00:00
_(in another terminal, don't need to load virtualenv)_
```
git clone https://git.startinblox.com/applications/hubl
cd hubl
npm install
```
Then, add the following as `config.json` in your hubl folder.
```
{
"client": {
"name": "Sample of a functional Hubl",
"logo": "https://cdn.startinblox.com/logos/webp/hubl.webp"
},
"components": [{
"type": "registering",
"parameters": {
"authority": "http://localhost:8000/",
"authorityName": "dataserver"
},
"endpoints": {
"get": "http://localhost:8000/open-communities/"
},
"route": false
},
{
"type": "notification",
"route": false
},
{
"type": "admin",
"route": false
},
{
"type": "about"
},
{
"type": "communities",
"route": false
},
{
"type": "dashboard",
"endpoints": {
"get": "http://localhost:8000/dashboards/"
}
},
{
"type": "profileDirectory",
"endpoints": {
"get": "http://localhost:8000/users/",
"skills": "http://localhost:8000/skills/",
"uploads": "http://localhost:8000/upload/"
},
"route": "members"
},
{
"type": "jobBoard",
"endpoints": {
"get": "http://localhost:8000/job-offers/",
"post": "http://localhost:8000/job-offers/",
"skills": "http://localhost:8000/skills/"
},
"route": "job-offers"
},
{
"type": "projects",
"endpoints": {
"get": "http://localhost:8000/projects/",
"post": "http://localhost:8000/projects/",
"captains": "http://localhost:8000/users/",
"users": "http://localhost:8000/users/",
"xmpp": "wss://xmpp-dev.startinblox.com/xmpp-websocket"
}
},
{
"type": "circles",
"endpoints": {
"get": "http://localhost:8000/circles/",
"post": "http://localhost:8000/circles/",
"owners": "http://localhost:8000/users/",
"users": "http://localhost:8000/users/",
"xmpp": "wss://xmpp-dev.startinblox.com/xmpp-websocket"
}
},
{
"type": "chat",
"endpoints": {
"xmpp": "wss://xmpp-dev.startinblox.com/xmpp-websocket"
},
"route": "messages"
},
{
"type": "analytics",
"parameters": {
"type": "matomo",
"url": "https://matomo.startinblox.com/",
"id": "2"
},
"route": false
}
]
}
```
Then install Node dependencies:
```
npm install
```
and launch the server with:
```
npm run watch
```
2021-06-02 12:26:56 +00:00
## Architecture 🏗
2021-03-17 14:41:20 +00:00
`djangoldp` is a Django app which you plug into a Django project. So, if you're
2021-06-02 12:26:56 +00:00
hacking on `djangoldp` or related apps, then you need a Django project to test it.
When you follow this [setup
2021-03-17 14:41:20 +00:00
guide](https://git.startinblox.com/djangoldp-packages/djangoldp#setup-a-djangoldp-server),
2021-03-17 14:43:24 +00:00
you get asked to run `djangoldp initserver myldpserver` (where I changed
`myldpserver` to `startinblox-startinoff`) and what spits out is what you also
2021-06-02 12:26:56 +00:00
see in this repository but with a working `settings.yml` file.
2021-03-17 14:41:20 +00:00
```
2021-06-02 12:26:56 +00:00
user@machine:/path/to/startinblox$ tree -L 1
2021-03-17 14:41:20 +00:00
.
2021-06-02 12:26:56 +00:00
├── djangoldp
2021-03-17 14:41:20 +00:00
└── startinblox-startinoff (run ./manage.py commands here which uses your djangoldp code)
2 directories, 0 files
```
2021-06-02 12:26:56 +00:00
## Using Postgres instead of SQLite
In the early days, we were using PostgreSQL, and we may yet need to return to
its warm embrace. To do so:
1. Install and start Postgres
2021-06-02 12:44:47 +00:00
- Mac OSX: https://www.postgresql.org/download/macosx/, or `brew install postgresql`, then `brew services start postgresql`
- Fedora: `dnf install postgresql-server && sudo systemctl enable postgresql.service && sudo systemctl start postgresql.service`
2021-06-02 12:26:56 +00:00
2. Create a user and a database:
2021-06-02 12:44:47 +00:00
```
$ createuser djangoldp
$ createdb -O djangoldp djangoldp
```
(you may need `sudo -u postgres` or `-U postgres` on both of these commands,
depending on your local security set-up)
2021-06-02 12:26:56 +00:00
3. Edit `settings.yml` if you need to remove the postgres user or change the
2021-06-02 12:44:47 +00:00
password
2021-06-02 12:26:56 +00:00
## Troubleshooting / top tips
* Remember to activate your virtual environment, if you're using one, before
running any Python / `manage.py` / `djangoldp` commands
2021-06-02 12:44:47 +00:00
* `django.db.migrations.exceptions.InconsistentMigrationHistory: Migration guardian.0001_initial is applied before its dependency djangoldp_account.0001_initial on database 'default'.`
* try `rm db.sqlite3` in your hublserver folder.
* `ImportError: cannot import name 'base64url_decode' from 'jwt.utils'`
* try `pip uninstall jwt` and `pip install pyjwt`
* `No module named 'oidc_provider.lib.utils.dpop'`
* Make sure you're in the right virtualenv!