mirror of
https://github.com/storytold/artcraft.git
synced 2026-11-03 17:08:13 +00:00
122 lines
2.4 KiB
Markdown
122 lines
2.4 KiB
Markdown
storyteller-web
|
|
===============
|
|
This is our main user account monolith that we'll also bake other pieces into.
|
|
|
|
Local development
|
|
-----------------
|
|
|
|
### Database migrations
|
|
|
|
To reset the entire database (drop, migrate), run:
|
|
|
|
```
|
|
diesel database reset
|
|
```
|
|
|
|
To migrate at the current step and beyond:
|
|
|
|
```
|
|
diesel migration run
|
|
```
|
|
|
|
To undo migrations at the current step:
|
|
|
|
```
|
|
diesel migration redo
|
|
```
|
|
|
|
To save sqlx database state to cache file (necessary for builds):
|
|
|
|
```
|
|
SQLX_OFFLINE=true cargo sqlx prepare
|
|
```
|
|
|
|
Now that we have multiple binaries, it's required to include all the queries in the main
|
|
binary so we can generate the cached queries as a single target. That's then executed
|
|
with:
|
|
|
|
```
|
|
SQLX_OFFLINE=true cargo sqlx prepare -- --bin storyteller-web
|
|
```
|
|
|
|
Production
|
|
----------
|
|
|
|
### Database migrations
|
|
|
|
1. Set `DATABASE_URL` in `.env`
|
|
2. Run `diesel migration run`
|
|
|
|
Actix notes
|
|
-----------
|
|
|
|
json request
|
|
```
|
|
async fn handler(request: web::Json<Mytype>) -> impl Responder { "whatever" }
|
|
```
|
|
|
|
form-multipart request
|
|
```
|
|
async fn handler(request: web::Form<Mytype>) -> impl Responder { "whatever" }
|
|
```
|
|
|
|
route parameters
|
|
```
|
|
#[get("/{name}")]
|
|
async fn hello(name: web::Path<String>) -> impl Responder { format!("Hi {}", name) }
|
|
```
|
|
|
|
|
|
TODO
|
|
----
|
|
|
|
* Make all "token" types correct
|
|
* Use correct collation for all tables
|
|
* Install indexes on all foreign keys
|
|
* Make sure unique indexes are correct
|
|
|
|
Notes / TODOs:
|
|
|
|
* Examples for good Actix+Sqlx Tests:
|
|
https://stackoverflow.com/questions/65370752/how-do-i-create-an-actix-web-server-that-accepts-both-sqlx-database-pools-and-tr
|
|
|
|
* Actix/sqlx runtime compat:
|
|
https://github.com/launchbadge/sqlx/issues/1117#issuecomment-801237734
|
|
|
|
|
|
Docker builds
|
|
-------------
|
|
|
|
The repository needs to be given read access to the base docker image:
|
|
|
|
https://github.com/orgs/storytold/packages/container/docker-base-images-rust-ssl/settings
|
|
|
|
Local Nginx Proxy
|
|
-----------------
|
|
Set up a local nginx to proxy to the frontend and backend so cookie issues aren't annoying
|
|
|
|
Edit, `/etc/nginx/sites-enabled/storyteller`
|
|
|
|
```
|
|
server {
|
|
listen 80;
|
|
server_name api.jungle.horse;
|
|
location / {
|
|
proxy_set_header Host $host;
|
|
proxy_pass http://127.0.0.1:12345;
|
|
proxy_redirect off;
|
|
}
|
|
}
|
|
server {
|
|
listen 80;
|
|
server_name jungle.horse;
|
|
location / {
|
|
proxy_set_header Host $host;
|
|
proxy_pass http://127.0.0.1:7000;
|
|
proxy_redirect off;
|
|
}
|
|
}
|
|
|
|
```
|
|
|