Update README.md

Some notes for people that might want to run full-on native, with detail about how Mac hijacks port 7000 and how to get around it.
This commit is contained in:
Tim Consolazio 2024-02-09 09:18:29 -05:00
parent c36ed57996
commit 096887c26d
1 changed files with 18 additions and 0 deletions

View File

@ -16,6 +16,17 @@ First install python, poetry, and mysql. Then:
./bin/recreate_db clean
./bin/run_server_locally
Note: if you're on a Mac and trying to run native (might translate elsewhere) running python 3 and get errors with mysqlclient and psycopgen2, you may need to install mysql-client, pkg-config, mysqlclient, and psycopgen2 (and remove mysqlclient and psycopgen2 from the pyproject.toml or Poetry will try to build them and crash).
brew install mysql-client pkg-config
export PKG_CONFIG_PATH="$(brew --prefix)/opt/mysql-client/lib/pkgconfig"
pip install mysqlclient
pip install psycopg2
On a Mac, port 7000 (used by the app) might be hijacked by Airplay. See the Docker section below.
Remember, if you don't need a full-on native dev experience, you can run the docker image, which saves you from all the native setup.
## Keycloak Setup
You will want an openid server of some sort.
@ -24,6 +35,9 @@ You can start it like this:
./keycloak/bin/start_keycloak
It'll be running on port 7002 (if you want to log into the keycloak admin, localhost:7002).
Creds = admin/admin (also logs you into the app if running the front end)
## Frontend Setup
First install nodejs, ideally the version in .tool-versions (but likely other versions will work). Then:
@ -32,6 +46,8 @@ First install nodejs, ideally the version in .tool-versions (but likely other ve
npm install
npm start
Assuming you're running KeyCloak as indicated above, login will be admin/admin.
## Run tests
./bin/run_pyl
@ -48,6 +64,8 @@ For full instructions, see [Running SpiffWorkflow Locally with Docker](https://w
The `docker-compose.yml` file is for running a full-fledged instance of spiff-arena while `editor.docker-compose.yml` provides BPMN graphical editor capability to libraries and projects that depend on SpiffWorkflow but have no built-in BPMN edit capabilities.
Note: For those who upgraded to MacOS 12.1 and are running everything locally, your AirPlay receiver may have started on Port 7000 and your docker (or anything requesting port 7000) may fail due to this port already being used. You can disable this port in System Preferences > Sharing > AirPlay receiver.
## Contributing
To start understanding the system, you might: