Lisa 1. Hello World rakenduse ülesseadmine

Selles artiklis vaatame, kuidas käib Google App Engine SDK-ga kaasas oleva Hello World rakenduse ülesseadmine alates selle loomisest kuni brauseris tulemuse nägemiseni. Programmikoodi see artikkel ei puuduta - juttu on ainult vaikimisi kaasas oleva näiteprogrammi käima saamisest.

Rakenduse registreerimine

Esimese sammuna (seda võib ka hiljem teha, aga nii on lihtsam) tuleb registreerida loodav rakendus Google App Engine teenuses. Selle jaoks tuleb avada veebiaadress appengine.google.com ja enda Google Konto parooliga seal sisse logida (juhul kui Google Konto kasutajatunnus puudub, saab selle sealsamas kohe teha).

Kui kasutaja on Appspot teenusesse sisse logitud avaneb uue rakenduse registreerimise aken.

Joonis 1. Uue rakenduse registreerimine

Juhul kui konto on veel aktiveerimata (pole varem ühtegi aplikatsiooni loodud) avaneb järgmisena kasutaja tuvastamise aken, mis palub sisestada oma mobiiltelefoni number. Sellele numbrile saadetakse autentimiskood, mis tuleb enda tuvastamiseks avanenud aknas sisestada. Vajalik on see kasutajate hulga piiramiseks - ühe telefoninumbri kohta saab olla üks kasutaja. Kui see samm on ühe korra juba läbi tehtud, siis rohkem seda teha pole vaja.

Joonis 2. Kasutaja autentimine SMS sõnumi teel

Järgmisena avaneb uue rakenduse seadete aken. Kõige olulisem siit on Application Identifier väli, see peab olema unikaalne tekst, mis koosneb ladina tähtedest, numbritest ja sidekriipsudest. Sellest tekstist saab ka uue aplikatsiooni aadressi osa kujul app_id.appspot.com, kus app_id ongi Application Identifier. Näites on selleks rakenduse identifikaatoriks andristest ja rakenduse aadress oleks seega andristest.appspot.com.

Joonis 3. Rakenduse seadete määramine

Kui rakenduse registreerimine õnnestus, tuleb ka sellekohane teade. Nüüd on rakendus registreeritud ja on võimalik kasutada appspot.com infrastruktuuri oma rakenduse majutamiseks.

Rakenduse loomine

Reaalse rakenduse loomiseks ja üleslaadimiseks on vajalik alla laadida ja paigaldada Google App Engine SDK, mille saab siit: Google App Engine SDK. Juhul kui tegu on Windows tüüpi operatsioonisüsteemiga on täiendavalt vaja paigaldada ka programmeerimisekeele Python interpretaator (lae alla siit).

Kui SDK on paigaldatud, siis tuleb käivitada Google App Engine Launcher, mille leiab Windowsi puhul nii Start menüüst, kui ka töölaualt. Avanenud programmiaknas tuleb uue rakenduse loomiseks valida menüüst käsklus File→Create New Application…

Joonis 4. Uue rakenduse loomine GAE SDK abil

Avaneb rakenduse seadete aken, kus tuleb sisestada rakenduse asukoht kõvakettal ning Application Name mille väärtuseks tuleks panna eelnevalt Google App Engine veebis registreeritud unikaalne Application Identifier väärtus. Juhul kui aplikatsioon on veel veebis registreerimata, siis võib panna selleks mida iganes - antud väärtust saab tagantjärgi muuta.

Joonis 5. Loodava rakenduse seadete sättimine

Juhul kui on vaja siiski loodud aplikatsiooni Application Name väärtust muuta, saab seda GAE Launcher'is toimetamise käsuga. Selle jaoks tuleb valida nimekirjast rakendus, mille seadeid tahetakse muuta ja klikkida nupule Edit.

Joonis 6. Rakenduste nimekiri

Selle peale avatakse tekstitoimetis aplikatsiooni app.yaml fail. Aplikatsiooni unikaalse ID muutmiseks (eelkõige on see vajalik aplikatsiooni üleslaadimiseks), tuleb muuta ära aplikatsiooni nimetus esimesel real. Juhul kui kõik on tehtud järjekorras, pole seda sammu vaja teha, kuna aplikatsiooni nimeks on juba õige väärtus.

Joonis 7. Aplikatsiooni seadete muutmine avanenud app.yaml failis

Rakenduse ülesseadmine

Rakenduse üleslaadimiseks on SDK tööriistaribal nupp Deploy. Sellele nupule vajutades saadetakse nimekirjas valitud rakendus Google App Engine serverisse.

Joonis 8. Deploy nupp rakenduse üleslaadimiseks

Järgmisena avaneb aken, mis palub end rakenduse üleslaadimiseks sisse logida. Siia tuleb sisestada seesama kasutajanimi ja parool (Google Konto), mille alusel on rakendus Google App Engine teenuses registreeritud.

Joonis 9. Kasutaja tuvastamine enne failide üleslaadimist

Kui sisselogimine õnnestus, avaneb logiaken millelt on näha üleslaadimise staatus. Juhul kui esineb mingi viga, ilmub see samuti logiaknasse. Õnnestumise korral peaks kusagile logi lõppu ilmuma tekst new version is ready to start serving.

Joonis 10. Rakenduse üleslaadimise logiaken

Kui rakendus on edukalt üles laetud, saabki seda kohe kasutama hakata. Selle jaoks tuleb avada brauseris aadress app_id.appspot.com, kus app_id on aplikatsiooni identifikaator. Antud näite puhul on selleks aadressiks andristest.appspot.com

Joonis 11. Töötav rakendus kasutaja brauseris