Skip to content

Commit

Permalink
Aggiunta guida per il deploy su Supabase
Browse files Browse the repository at this point in the history
  • Loading branch information
Samurai016 committed Jun 26, 2024
1 parent 46d61bd commit 665d549
Show file tree
Hide file tree
Showing 6 changed files with 8,254 additions and 1 deletion.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
Tramite questa REST API hai accesso ad una lista di tutti i comuni, le province e le regioni italiane. I dati sono ottenuti e aggiornamenti da un sistema di aggiornamento semiautomatico che preleva i dati direttamente dagli archivi ISTAT e integra le informazioni mancanti interrogando Wikidata.
I dati non ottenuti automaticamente dal sistema vengono inoltrati direttamente a me che procedo a verificarli e modificarli manualmente.

L'API è scaricabile e installabile su una propria istanza di Supabase oppure è usufruibile in maniera gratuita all'indirizzo https://axqvoqvbfjpaamphztgd.functions.supabase.co.
L'API è [scaricabile e installabile su una propria istanza di Supabase](https://github.com/Samurai016/Comuni-ITA/blob/master/setup) oppure è usufruibile in maniera gratuita all'indirizzo https://axqvoqvbfjpaamphztgd.functions.supabase.co.
Dato che l'API è hostata su un servizio gratuito sarebbe opportuno evitare di sovraccaricare l'API per dare a tutti la possibilità di accedervi.

In questa wiki troverai una spiegazione di come funzionano gli endpoint e di come installare l'API su un server.
Expand Down
31 changes: 31 additions & 0 deletions setup/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Guida al deployment del progetto su Supabase
Questa guida ti accompagnerà passo dopo passo nel processo di deployment del progetto su una tua istanza di Supabase.

# 1. Setup Supabase
1. Crea un account [Supabase](https://supabase.com/dashboard/sign-up) o effettua il [login](https://supabase.com/dashboard/sign-up)
2. Accedi alla dashboard dei progetti ([https://supabase.com/dashboard/projects](https://supabase.com/dashboard/projects))
3. Crea un nuovo progetto cliccando su *"New Project"*
1. Assegna un nome al progetto e crea una password per il database (**è importante salvare questa password in un luogo sicuro in quanto potrebbe servire in futuro**)
2. Scegli **Central EU** come regione
3. Clicca *Create new project*
4. Attendi che Supabase crei il progetto
4. Dalla barra laterale apri il *SQL Editor*
5. Incolla il codice che trovi nel file [schema.sql](https://github.com/Samurai016/Comuni-ITA/blob/master/setup/schema.sql) e avvia la query cliccando su *Run*
6. Dalla barra laterale apri il *Table Editor*
7. Seleziona la tabella `regioni`
8. Importa i dati cliccando *Import data via CSV* (utilizza i file .csv che trovi in [questa cartella](https://github.com/Samurai016/Comuni-ITA/blob/master/setup))
9. Ripeti gli step da *6* a *8* per le tabelle `province` e poi `comuni` (l'ordine di esecuzione è importante per garantire l'integrità delle chiavi esterne)

# 2. Deploy del progetto
1. [Installa il Supabase CLI in locale](https://supabase.com/docs/guides/cli/getting-started#installing-the-supabase-cli)
2. Clona la repository in una cartella a scelta
3. All'interno della cartella del progetto avvia un terminale a riga di comando
4. [Segui le istruzioni riportate in questa guida per linkare il progetto Supabase alla cartella locale.](https://supabase.com/docs/guides/functions/deploy)
Fermati prima del punto [*Deploy your Edge Functions*](https://supabase.com/docs/guides/functions/deploy#deploy-your-edge-functions)
5. Effettua il deploy delle funzioni utilizzando i seguenti comandi:
```bash
supabase functions deploy comuni --no-verify-jwt
supabase functions deploy province --no-verify-jwt
supabase functions deploy regioni --no-verify-jwt
```
L'utilizzo della flag [`--no-verify-jwt`](https://supabase.com/docs/guides/functions/quickstart#skipping-authorization-checks) è fondamentale per poter rendere l'API utilizzabile pubblicamente.
Loading

0 comments on commit 665d549

Please sign in to comment.