Skip to content

Latest commit

 

History

History
137 lines (84 loc) · 4.75 KB

asennusohje.md

File metadata and controls

137 lines (84 loc) · 4.75 KB

Asennusohje

Sovelluksen asennusta ja käyttämistä varten tarvitset ainakin:

  • tuen Python-kielisten ohjelmien suorittamiseen. Käytössäsi tulee olla vähintään Pythonin versio 3.5
  • tuen Python-kirjastojen lataamiseen. Käytössäsi tulee olla Pythonin pip, jonka avulla saat ladattua apukirjastoja
  • tuen Python-"virtuaaliympäristöjen" luomiseen. Käytössäsi tulee olla Pythonin venv-kirjasto
  • työvälineet git-repojen käsittelyyn
  • käyttäjätunnukset Herokuun ja työvälineet työvälineet Herokussa sijaitsevien palvelujen käsittelyyn (Heroku CLI)
  • sopivan ohjelmointiympäristön Python-kehitykselle esim. Visual Studio Code

Sovelluksen asennus lokaalisti

Avaa komentoterminaali ja siirry kansioon, jonne haluat asentaa sovelluksen.

[Komentoterminaali]

Hae sovelluksen tiedostot GitHubin repositoriosta:

  • git clone https://github.com/juissijohtaja/Pizzapalvelu.git

Siirry äskeen luotuun Pizzpalvelu-kansioon:

  • cd Pizzapalvelu

(Tästä alkaen kaikki komennot suoritetaan tässä kansiossa.)

Luodaan hakemiston sisälle Python-virtuaaliympäristö:

  • python3 -m venv venv

Aktivoidaan tämän jälkeen virtuaaliympäristö:

  • source venv/bin/activate

Sovelluksen riippuvuudet on määritelty tiedostossa requirements.txt. Lataa riippuvuudet:

  • pip install -r requirements.txt

Käynnistä sovellus:

  • python run.py
[Selain]

Mene selaimella osoitteeseen:

  • http://localhost:5000/

Luo käyttäjätili menemällä selaimella osoitteeseen:

  • http://localhost:5000/auth/signup/

Tämän jälkeen sinulla on tavallinen käyttäjätili (USER), jonka voi muuttaa ylläpitäjän (ADMIN) tiliksi seuraavalla tavalla.

[Komentoterminaali]

Luo yhteys paikalliseen tietokantaan:

  • sqlite3 application/pizzapalvelu.db

Huom. mikäli olet jo luonut useampia kuin yhden käyttäjätilin, tarkista tietokannasta sen käyttäjän id-numero, jolle ylläpito-oikeudet halutaan antaa. Katso käyttäjien tiedot tietokannasta:

  • SELECT * FROM account;

Anna haluamallesi käyttäjätilille (id) ylläpitäjän oikeudet. Tee muutos tietokantaan:

  • UPDATE account SET admin = 1 WHERE id = 1;

Voit halutessasi sulkea yhteyden tietokantaan:

  • .quit
[Selain]

(Varmista, että sovellus on käynnissä.)

Nyt voit kirjautua valitsemallasi käyttäjätilillä uudelleen sisään ja pääset ylläpitopuolelle. Tämän jälkeen voit käyttää sovellusta, hallinnoida sisältöjä ja antaa haluamillesi käyttäjille ylläpitäjän oikeudet ylläpitosivujen kautta.

Lisää aiheesta: Sovelluksen käyttöohje

Sovelluksen asennus Herokuun

(Asenna ensin sovellus lokaalisti yllä olevien ohjeiden avulla.)

Avaa Pizzapalvelu-hakemisto komentoterminaalissa.

(Tästä alkaen kaikki komennot suoritetaan tässä kansiossa.)

Herokun (sovelluksen käynnistämistä varten) tarvitsema Procfile-tiedosto on jo olemassa, joten voimme suoraan luoda sovellukselle paikan Herokuun.

[Komentoterminaali]

Luo sovellukselle paikka Herokuun:

  • heroku create

Prosessin valmistuttua Heroku ilmoittaa komentorivillä sivuston osoitteen, joka on muotoa:

  • https://joku-ihme-nimi.herokuapp.com/

(Mikäli avaat osoitteen selaimella, huomaat että sovellus ei ole vielä siellä.)

Lähetä projekti Herokuun:

  • git push heroku master
[Selain]

Operaation valmistuttua voit mennä edellisessä vaiheessa saamaasi osoitteeseen (pävitä sivu tarvittaessa) ja huomaat, että sovellus pyörii nyt Herokun palvelimella.

[Komentoterminaali]

Sovelluksella ei ole vielä Herokussa tietokantaa, joten korjataan tilanne.

Luo Herokuun ympäristömuuttuja HEROKU:

  • heroku config:set HEROKU=1

Ota käyttöön Herokun PostgreSQL-tietokanta:

  • heroku addons:add heroku-postgresql:hobby-dev

Tietokanta on nyt käytössä.

[Selain]

Luo uusi käyttäjätili sovelluksessa.

Nyt sinulla on tavallinen käyttäjätili (USER), jonka voi muuttaa ylläpitäjän (ADMIN) tiliksi seuraavalla tavalla.

[Komentoterminaali]

Luo yhteys Herokun tietokantaan:

  • heroku pg:psql

Huom. mikäli olet jo luonut useampia kuin yhden käyttäjätilin, tarkista tietokannasta sen käyttäjän id-numero, jolle ylläpito-oikeudet halutaan antaa. Katso käyttäjien tiedot tietokannasta:

  • SELECT * FROM account;

Anna haluamallesi käyttäjätilille (id) ylläpitäjän oikeudet. Tee muutos tietokantaan:

  • UPDATE account SET admin = True WHERE id = 1;

Voit halutessasi sulkea yhteyden tietokantaan:

  • \q
[Selain]

Nyt voit kirjautua valitsemallasi käyttäjätilillä uudelleen sisään ja pääset ylläpitopuolelle. Tämän jälkeen voit käyttää sovellusta, hallinnoida sisältöjä ja antaa haluamillesi käyttäjille ylläpitäjän oikeudet ylläpitosivujen kautta.

Lisää aiheesta: Sovelluksen käyttöohje