Capras kurs i AWS for studenter våren 2019

I dette kurset skal vi sette opp en web-applikasjon med lagring til database med Amazon Web Services. Web-applikasjonen er en enkel sak for å opprette, endre, slette og se på arrangementer. Den er skrevet i TypeScript med React. Backenden vår er skrevet i Java, og er skrevet for å være Lambda-funksjoner i AWS.

Den første delen består i å sette opp alle tjenestene, og få applikasjonen til å fungere. Her har vi forsøkt å skrive detaljerte instruksjoner, men ikke nøl med å spørre dersom noe er uklart eller du står fast.

I den siste delen har vi laget noen ekstraoppgaver, hvor instruksjonene ikke er like detaljerte. Vi stiller med noen lenker og pekepinner på hvor man kan starte for å løse oppgaven, men deretter er det opp til dere. Vi er selvsagt også tilgjengelig for spørsmål.

Presentasjonen som Capra holdt kan du finne her.

Oppsett av utviklingsmiljø lokalt

Sørg for at du har gjort det som trengs på forhånd. Se PDF som ble sendt ut før kurset. Hvis du ikke har fått den, ligger den her

Når du er klar kan du fortsette med følgende:

1. Klon dette repoet med koden for Lambda funksjoner

$ git clone https://github.com/capraconsulting/studentkurs-2019-lambda.git

2. Klone webapp og følg instruksjonene fra README-filen der for å komme i gang

$ git clone https://github.com/capraconsulting/studentkurs-2019-webapp

Da er du klar til å sette i gang!

Amazon Web Services (AWS)

Amazon Web Services tilbyr en rekke tjenester. De har tjenester for å kjøre enkle virtuelle servere, for å sende e-post, prosessere enorme datamengder, lagring i ulike formater, lagring av filer og hosting av statisk innhold til nettsider, for å nevne noe.

For å kunne bruke AWS trenger man en konto. Man får mye selv med gratis-nivået, slik at man kan komme i gang uten å bekymre seg for at det blir dyrt.

Det finnes flere måter å jobbe med AWS på. Man kan bruke nettleseren, kommandolinjen eller lage egne maler. Sistnevnte gjør at man kan lage infrastruktur med kode. AWS sin tjeneste for dette heter CloudFormation. Akkurat CloudFormation er ikke noe vi skal benytte i dette kurset, men det kan være fint å vite om.

I dette kurset skal vi først sette opp tjenester med nettleseren, i den såkalte konsollen. Videre kan vi velge å oppdatere tjenester med nettleseren, eller Command-Line Interface (CLI) som AWS tilbyr. Dette er ikke nødvendig, men kan være nyttig.

Vi setter opp AWS-tjenester for applikasjonen vår

En vanlig web-applikasjon har tre lag: frontend, backend og en database. Frontenden er det vi ser, brukegrensesnittet. Backend har logikk og håndterer henvendelser fra frontend. Databasen lagrer data. Denne enkle figuren viser hvordan dette kan se ut:

Når vi kjører dette, enten lokalt eller på en server, kjører vi ofte tre ting: En web-applikasjon (frontend), en backend-applikasjon (for eksempel skrevet i Java) og en database (som Postgres eller MySQL). Da må man passe på at serveren, altså datamaskinen dette kjører på, er oppdatert og tettet for alle sikkerhetshull.

Når vi jobber med AWS, kan vi i stedet bruke tjenester som er spesielt designet for det vi ønsker å gjøre, være seg å kjøre backend-kode eller vise en web-applikasjon. Man kan kombinere tjenester slik at man oppnår de egenskapene til systemet som man ønsker. Tjenestene er gjerne det vi kaller «fully managed», som betyr at vi ikke trenger å forholde oss til serverne som dette faktisk kjører på.

I dette kurset vil vi ha en arkitektur som ser slik ut:

Tjeneste	Fortkortelse	Hva bruker vi den til?
Simple Storage Service	S3	S3 brukes til lagring av data som skal aksesseres rimelig ofte. Det betyr gjerne at nettsider og bilder lagres her. For eksemepl bruker Imgur S3 til å lagre nettsider. S3 brukes også i stor grad til å lagre og vise statiske nettsider og web-applikasjoner.
API Gateway	-	API Gateway lar deg definere endepunkt, og la disse peke på andre tjenester i AWS. Det betyr at du for eksempel kan lage et endepunkt for å lagre bilder i API Gateway, og peke det rett til S3. Da trenger du ikke programmere noe for å oppnå lagring via et API.
Relational Database Serivce	RDS	RDS er en tjeneste for relasjonsdatabase. Her kan du lage databaseinstanser av typer som MySQL og Postgres. Med tradisjonelle servere må man selv passe på databaseinstansen med hensyn til oppetid og sikkerhetshull, fordi de kjører på en server. Med RDS forholder du deg kun til databaseinstansen, ikke til serveren den kjører på.
Lambda Functions	-	Lambda Functions lar deg kjøre koden din, helt uten en tradisjonell server. ...

Videre vil vi sette opp hver av disse tjenestene etter tur.

Om Regioner og Availability Zones

AWS har flere regioner. En region er et geografisk område som har et sett datasentere. Et eller flere datasenter samlet på et sted kalles en Availability Zone, eller AZ. En region har altså flere Availability Zones.

I dette kurset skal vi benytte oss av regionen eu-north-1. Den er helt ny, og ligger i Stockholm. Du velger region øverst til høyre i AWS konsollen.

Steg 1: Sette opp Simple Storage Service (S3)

I første steg skal vi, så enkelt og raskt som mulig, legge web-applikasjonen vår på det åpne nettet. Det vil si: Vi skal kunne nå web-applikasjonen fra en nettadresse. For å gjøre det må vi gjøre tre ting:

1. Opprette en bucket i S3
2. Gjøre innholdet åpent tilgjengelig
3. Laste opp web-applikasjonen til bucketen

Vi kjører i gang!

Opprette en bucket i S3

1. Logg inn i AWS Management Console
2. Naviger til S3. Det enkleste er å søke i feltet under «Find services».
3. Du har nå kommet til S3, som viser deg en liste over de buckets du har. Den er foreløpig tom. En bucket er som en slags mappe du kan konfigurere. For å opprette en slik, trykk «Create bucket»
4. Gi den et navn som er DNS-compliant, det vil si at det må kunne være et gyldig domene. Navn på buckets må være unikt globalt. Det betyr at ikke alle på kurset kan ha samme navn på sin bucket. Vi foreslår at du gir denne bucketen <hva du vil kalle din Event-tjeneste>.no, for eksempel 123events.no.
5. Alle regioner vil fungere, men det beste er å velge en som er i nærheten av hvor applikasjonen skal brukes, for å redusere latency. Etter at du har valgt en region, trykk «Next».
6. I neste steg kan du gjøre flere valg for bøtta, som å tagge den (nyttig hvis man har mye forskjellig på en og samme AWS-konto), eller skru på versjonering av objektene. Vi trenger ikke noe av dette når vi bare skal lagre en nettside, så vi trykker «Next».
7. Dette steget kontrollerer hvilke kontoer som kan sette tilganger for denne bucketen. For at vi skal kunne laste opp objekter og sette disse helt public (det skal jo være en nettside), må vi fjerne markeringen ved «Block new public ACLs and uploading public objects (Recommended)» og «Remove public access granted through public ACLs (Recommended)». Gjør dette, og trykk «Next».
8. Da kommer vi til siste steg. Trykk «Create bucket».

Gjør innholdet åpent tilgjengelig

Når bucketen er opprettet må vi gjøre den public. Det gjør vi ved å trykke på navnet på bucketen, slik at vi går inn på den. Deretter gjør vi følgende:

1. Velg «Properties» øverst
2. Trykk på «Static webwsite hosting»
3. Kopier URL som står etter «Endpoint». Dette blir URL til webappen, så den må du lagre til senere.
4. Velg «Use this bucket to host a website»
5. Under «Index document» skriver du index.html, altså standard verdi man bruker for indeksdokument til en nettside.
6. Trykk «Save»

Nå er selve bucketen åpnet for å kunne nås utenfra. Nå må vi laste opp innhold, og sørge for at det også kan nås utenfra.

Publiser applikasjonen

Nå som du har en bucket med de ønskelige egenskaper og rettigheter, er vi nesten klar for å laste opp web-applikasjonen. Først, verifiser at du har bygget den. Det gjør du ved å se at du har en dist mappe i mappen til web-appen. Hvis du ikke har det, gå til web-appen sin README og se hvordan du bygger applikasjonen.

Når du har et bygg er alt klart: Vi kan publisere appen! Det gjør vi enten ved å dra filene vi vil publisere over i bucketen ved hjelp av nettleseren, eller vi kan gjøre det ved hjelp av kommandolinjen.

Med nettleseren:

1. Logg inn i/åpne AWS Management Console, gå til S3 og åpne bucketen du ønsker å legge innholdet i.
2. Trykk «Upload», åpne en filutforsker, marker innholdet i dist-mappen i web-approsjektet og dra innholdet over til AWS-vinduet
3. Trykk «Next»
4. Under «Manage public permissions» velger du Grant public read access to this object(s).
5. Trykk «Next»
6. Og «Next» nok en gang. Til slutt «Upload»

Tips:

• Noen ad-blockers gjør at opplastingen til S3 feiler med en feilmelding som sier "100% fail", så om du opplever dette, prøv å deaktivere ad-blockeren du bruker og prøv på nytt.

Med kommandolinje:

1. Åpne en ny terminal og gå til mappen du har klonet web-applikasjonen i
2. Åpne et shell og logg inn med din AWS-konto. For å verifisere at du er logget inn kan du kjøre følgende kommando. Den lister alle S3-buckets du har på din konto.

$ aws s3 ls

3. Publiser innholdet i din bucket med tilgang slik at alle kan lese filene:

$ aws s3 cp dist/ s3://<navn på bucket> --acl public-read --recursive

Når opplasting er ferdig bør du kunne nå applikasjonen på URLen vi lagret i stad. Foreløpig snakker ikke web-applikasjonen med noen andre tjenester, så videre skal disse tjenestene settes opp.

Steg 2: Relational Database Serivce (RDS)

Vi oppretter en database i RDS, slik at vi har et sted å lagre data. Vi skal kunne nå denne fra Lambda funksjonene. Det er da fire steg:

1. Opprette databaseinstansen
2. Hente ut de instillingene vi trenger å gi til Lambda-funksjonene, slik at de kan koble til.
3. Konfigurere sikkerhetsinstillinger for at ikke hvem som helst skal kunne koble seg på databasen vår
4. Koble oss på databaseinstansen og opprette tabell for data, slik at applikasjonen har noe å lese og skrive fra/til der

Opprett databaseinstans i AWS

1. Gå til RDS og velg «Create database»
2. I første steg velger vi type database. I dette kurset bruker vi Postgres, så velg dette og trykk «Next»
3. Under Use case velger du «Dev/Test» og trykker «Next»
4. I dette steget velger vi en rekke detaljer om databasen vi skal sette opp. Det viktigste her er «DB instance class» sier noe om hvor stor last instansen vil kunne håndtere, og dermed også kostnandsnivået. Vi trenger ikke mer enn db.t3.micro
5. Huk også av «Only enable options eligible for RDS Free Usage Tier», dersom dette valget er synlig rett ovenfor der du velger «DB instance class».
6. Under «Settings» setter vi navn på instansen, og brukernavn og passord for den. Instansnavnet kan for eksempel være eventsapp. Brukernavnet kan godt være det samme. Passordet bør være noe du finner på selv. Husk å notere deg navn, brukernavn og passord slik at du har det til senere. Trykk «Next»
7. I dette steget får vi en rekke valg for databasen. Vi lar det meste stå som standard. Dobbeltsjekk at du tillater at man kan koble til databasen utenfra, altså at «Public accessibility» er satt til «Yes». Vi lar også RDS opprette nytt Virtual Private Network (VPC) og subgrupper av dette for instansen din. Derfor skal disse to valgene settes til «Create new VPC» og «Create new DB Subnet Group». Du kan se valgene i figuren under også.
8. Vi må også sette sette et navn på databasen som skal kjøre på databaseinstansen. Dette gjøres under feltet «Database name». Navnet kan godt være det samme om instansen, eventsapp. Trykk «Create database»

Hent ut instillinger

Nå skal vi hente ut URL til databasen, slik ta vi kan la koden vår koble seg på den senere:

1. Trykk «Databases» til venstre
2. Finn databasen du nettopp lagde, og vent til status er blitt «Available». Dette kan ta noen minutter. Når den er det, trykker du på den.
3. Lagre verdien som står under «Endpoint», slik at vi har den til senere.. Den vil være noe sånt som: <ditt-database-navn>.cwkzdvvfjrvm.eu-north-1.rds.amazonaws.com.

Sett opp databasemodell

En relasjonsdatabase trenger en tabell for å lagre data. Vi må gi dette til databasen vår. For å gjøre det skal vi kjøre en SQL-statement som oppretter denne. For å gjøre det må vi skrive en SQL-statmenet, koble oss på databasen og kjøre dette.

SQL har vi alt skrevet, du finner det i db-mappa. Det heter setup.sql. Sjekk at brukernavnet som står der, eventsapp, er det samme som oppga som brukernavn da du opprettet databasen. Deretter gjør du følgende:

1. Åpne Pgadmin (hvis du ikke installerte det på forhånd finner du det her)
2. Trykk på «Add connection to a server» øverst til venstre. Du oppgir tilkoblingsdetaljer som du fant i tidligere steg, altså URL til database, samt brukernavn og passord som du satte for databasen din.
3. Når du har koblet til, dobbeltklikk på «Databases» slik at du får opp databasene. Velg den du opprettet da du lagde instansen, og trykk på SQL-knappen på oppgavelinja (til høyre for søppelbøtta)
4. Kopier inn SQL fra db/setup.sql og lim inn i SQL-vinudet før du trykker på «Play»-knappen øverst. Hvis alt går etter planen vil det gi beskjeden Query returned successfully with no result in 73 msec.

Dette kan vi også gjort via terminalen, med verktøyet psql (mer informasjon her). Da kjører man kommandoen:

$ psql -U <brukernavn>  --password -h <url til database> -d <databasenavn> -a -f db/setup.sql

Her er URL til databasen altså den vi hentet ut tidligere, altså <databaseinstansnavn>.cwkzdvvfjrvm.eu-west-1.rds.amazonaws.com for eksempel eventsappinstance.cwkzdvvfjrvm.eu-west-1.rds.amazonaws.com

For eksemepel:

$ psql -U eventsappuser  --password -h eventsappinstance.cwkzdvvfjrvm.eu-west-1.rds.amazonaws.com -d eventsapp -a -f db/setup.sql

Opprett regler for tilgang til database

Vi ønsker å begrense hvem som har tilgang til å koble seg på databasen fra nå av. Da må vi justere Security Group for databasen. Det gjør vi slik:

1. Gå tilbake til AWS-konsollen
2. Velg "Services" helt øverst og deretter "EC2" under "Compute"-kategorien.
3. Under "Network & Security" i fanen til venstre trykker du på "Security Groups"
4. Trykk på Security Group-en som har rds-launch-wizard som "Group Name"
5. Velg fanen "Inbound". Du ser nå en oversikt over regler for innkommende trafikk til denne sikkerhetsgruppen. Trykk "Edit".
6. Legg til en ny regel ("Add Rule") og fyll den ut med Type: PostgreSQL og Source: Custom. I input-feltet kan du begynne å skrive "sg" og du vil da få opp en liste med sikkerhetsgrupper. Velg ID-en til rds-launch-wizard. Dette står som "Group ID" i listen over Security Groups.
7. Det skal da se cirka slik ut:

Steg 3: Lambda Functions

Lambda er en tjeneste i AWS for å kjøre kode på forespørsel uten tradisjonelle servere. Med andre ord kjøres koden kun ved behov, for eksempel ved kall fra API Gateway. Det betyr at vi kan ha en backend, eller en funksjon, for hvert eneste endepunkt. Det gjør videre at vi får en applikasjon hvor de ulike endepunktene har veldig liten kobling mellom hverandre, og kan oppdateres uavhengig av hverandre.

I dette steget skal vi opprette Lambda-funksjoner, ett for hvert endepunkt. Deretter skal vi laste koden vår opp, enten ved hjelp av CLI eller nettleseren.

Du trenger ikke sette opp alle Lambda-funksjonene med en gang, men kan for eksempel først implementere metoden for å hente alle Events, og så gjøre resten av guiden ferdig først, for så å gå tilbake og implementere resten av Lambda-funksjonene i etterkant. På denne måten kan du verifisere at flyten helt fra databsen og til WebAppen er satt opp riktig før du går løs på resten av metodene.

Opprett Lambda-function

1. Åpne eller logg inn i AWS Management Console
2. Sjekk at du er i AWS-region Stockholm, også kjent som eu-north-1. Dette ser du øverst i venstre hjørnet. Hvis du ikke er det allerede, bytter du til eu-north-1 Stockholm.
3. Gå til Lambda
4. Trykk «Create function»
5. Du sjekker at «Author from scratch» er valgt øverst. Du gir funksjonen et navn under «Name». Dette bør være noe unikt, som gjør at du kjenner igjen funksjonen. For eksempel myeventsapp-GET-events. Under Runtime velger du Java 8. Under «Role» velger du «Create a custom role», noe som åpner et nytt vindu. SE til at navnet på rollen er lambda_basic_execution. Trykk så «Allow» nederst til høyre.
6. Trykk «Create function»

Gi Lambdaen rettigheter til databasen

I AWS har vi en tjeneste som heter AWS IAM, AWS Identity and Access Management. Denne tjenesten håndterer roller, brukere og brukergrupper på tvers av alle tjenester, og hvilke rettigheter disse har.

I foregående steg gav vi Lambdaene en rolle service-roles/basic_lambda_execution. Vi må gi denne rollen rettigheter til å gjøre operasjoner over nettverket, slik at den ikke bare kan koble seg til en database men også skrive, lese og slette data fra den.

Vi gjør følgende:

1. Åpne eller logg inn i AWS Management Console.
2. Sjekk at du er i AWS-region Stockholm, også kjent som eu-north-1. Dette ser du øverst i venstre hjørnet. Hvis du ikke er det allerede, bytter du til eu-north-1 Stockholm.
3. Gå til tjenesten IAM
4. Velg «Roles» i menyen til venstre
5. Velg rollen til Lambdaen, service-roles/basic_lambda_execution
6. Velg fanen «Permissions» og så «Attach policies»
7. Velg policiy AWSLambdaVPCAccessExecutionRole (du kan søke etter den øverst), og trykk «Attach policy»

Bygg Lambda-funksjonene

Lambda-funksjonene ligger i lambda-mappen i dette repositoriet, og er skrevet i Java. Lambda trenger at dette er en ferdigbygget JAR-fil, eller en ZIP av Java-filer. Du bygger alle ved å gå til mappen og skrive mvn clean installi terminalen.

Last opp koden til Lambda-function

Når vi har bygd en JAR-fil for hvert endepunkt, kan vi hver og en opp til en Lambda ved hjelp av konsoll eller kommandolinjen. Gjør det for hvert av endepunktene.

Med nettleseren:

1. Åpne eller logg inn i AWS Management Console
2. Gå til Lambda-tjenensten
3. Finn funksjonen du opprettet i forrige steg
4. Trykk «Upload» og velg JAR-fil du ønsker å laste opp. Disse ligger i target-mappen innenfor hver funksjon i lambda-mappen.
5. I feltet «Handler» må du oppgi pakkenavn, klassenavn og metodenavn. Pakkenavn er mappenavnet, det vil si no.capraconsulting.kurs2019. Klassenavnet finner du i Java-filen til hver lambda, for eksempel i GetAllHandler.java. Den siste biten er metodenavnet, som er handleRequest. For akkurat det å hente alle events vil Handler da være no.capraconsulting.kurs2019.GetAllHandler::handleRequest

Med kommandolinje:

1. Benytt aws-vault til å åpne et shell knyttet til kontoen det skal kjøre på:

$ aws-vault exec <profilnavn>

2. For å laste opp, kjør:

$ aws lambda update-function-code --function-name=<funksjonsnavn> --zip-file=fileb://<navn på jar> --region eu-north-1

Sett instillingene til database som en miljøvariabler

1. Under «Environment variables» legger du til følgende miljøvariabler. PG_URL er verdien du hentet ut i slutten av steg 3, altså URL til Postgres-databasen.
2. Trykk «Save» øverst til høyre, og så «Actions» etterfulgt av «Publish new version».

Gi Lambda-funksjonen tilgang til databasen

1. Legg lambdaen i samme VPC (Virtual Private Network) som databasen. Dette gjøres ved å scrolle ned til "Network" og velge "Virtual Private Cloud (VPC)". Fra nedtrekksmenyen bør du finne en VPC som heter noe slikt som Default vpc-ac79.... Velg denne.
2. Når lambdaen er tilordnet et VPC må man også velge minst 2 subnet. Dette gjøres under "Network" og "Subnets". Velg minst 2 av subnettene fra nedtrekksmenyen. Dette gjør at lambda-funksjonen din kjører i minst 2 Availabiliy Zones og blir dermed ikke påvirket dersom et av datasenterene til AWS får problemer.
3. Velg en "Security group" for lambda-funksjonen din. Dette er en slags gruppering av brannur-regler og portåpninger. For enkelhets skyld velger vi her den samme "Security group"-en som databasen kjører i, hvor vi tidligere la til en "Inbound rule". Velg derfor den som har navn på dette formatet sg-0f6f... (rds-launch-wizard).
4. Det bør nå se ut ca. slik som dette:

Publiser lambda-funksjonen

Når man gjør endringer kan man lagre, men de trår ikke i kraft før man har publisert.

1. Trykk «Actions»
2. Trykk «Publish new version», gi en eller annen beskrivelse og trykk «Publish»

Steg 4: API Gateway

API Gateway er en tjeneste i AWS for å lage APIer helt uten programmering som kan kobles mot andre tjenester i AWS. I vårt tilfelle skal vi lage endepunkter for å opprette, endre, slette og hente ut eventer fra databasen vår. For å gjøre dette må vi:

1. Designe endepunktene våre slik at vi vet hvordan de skal se ut
2. Lage disse i API Gateway
3. Knytte endepunktene til andre tjenester i AWS, slik at endepunktene faktisk gjør noe. I vårt tilfelle betyr det at vi skal koble de til Lmabda-funksjoner.

Først, steg 1: Hvordan skal APIet se ut? Vi trenger et Create Read Update Delete (CRUD) for events:

Metode	Endepunkt	Konsumerer	Returnerer
GET	/events	-	En array med alle events
POST	/events	Nytt event objekt	En nyopprettet event
GET	/events/{uuid}	-	En enkelt event
DELETE	/events/{uuid}	-	200 OK hvis event ble slettet.
PUT	/events/{uuid}	Event-objekt med endringer som man ønsker at skal lagres.	En event oppdatert etter endringer

Lage API i API Gateway

1. Logg inn i AWS-konsollen og naviger til API Gateway
2. Trykk «Create API»
3. Da skal du se det følgende skjermbildet
4. Under «API Name» gir du APIet et navn, for eksmepel eventsapp.De andre verdiene kan du beholde som de er.
5. Trykk «Create API»

Du har nå opprettet et API vi kan legge til ressurser i, og knytte metoder til disse ressursene.

Lage ressurser til en API i API Gateway

Når man har opprettet et API, havner man automatisk i editoren for å lage API i API Gateway. Hvis du ikke har gjort det, gå til API Gateway og velg APIet du lagde.

I APi Gateway har vi to konsepter: Resources, og Methods. En Resource er en ressurs, eller en entitet. I vårt tilfelle er et eksemepl på en slik en ett enkelt event. Vi må opprette ressurser i APIet vårt. Hver ressurs vil også representere et endepunkt. Gjør følgende for å lage en ressurs:

1. Trykk på «Actions» og trykk «Create resource»
2. Du vil da få opp et skjermbilde for å opprette en ressurs. «Resource name» er navnet på ressursen, og er kun for at man skal skjønne hva det er for noe når man ser ressursen i editoren for API Gateway. «Resource Path» er endepunktet. Fyll ut begge basert på tabellen som beskriver API ovenfor. Huk også av for «Enable API Gateway CORS» sånn at det automatisk blir oprettet en options-metode for ressursen. Det første du skal opprette er da altså events.
3. Gjenta dette slik at du får en struktur som den beskrevet ovenfor, altså en ressurs /events og under der en ressurs {uuid}

Når du er ferdig bør det se noe sånt som dette ut:

Legg til metoder og knytt til Lambda-funksjoner for ditt API i API Gateway

Når API er implementert har vi fått alle endepunktene som dokumentet definerer. Vanligvis kunne man definert dette ved hjelp av API Gateway direkte, men vi har lagt det ved for å gjøre det litt raskere for dere. Nå som vi har ressurser kan vi knytte metoder til dem, som vi peker mot Lambda-funksjonene vi lagde tidligere. Det gjør vi slik: For hver ressurs, trykk på den og trykk:

1. Trykk «Actions» og så «Create method»
2. Velg HTTP-metode i dropdown-menyen
3. Du får da mulighet for å konfigurere metoden mot endepunktet. Vi skal sende requests til endepukntet mot en Lambda, så velg Integration type til å være «Lambda Function» og søk på funksjonen du vil knytte til endepunktet i boksen for «Lambda Function». Velg den du skal ha, og trykk «OK» i vinduet som dukker opp. Det sørger for at de riktige tillatlesene settes opp. Huk av for «Use Lambda Proxy integration»
4. Når du er ferdig trykker du «Save»

Gjenta dette slik at du får laget alle metodene som trengs for hver ressurs, og knyttet alle disse opp mot riktig Lambda-funksjon. Merk at du i tillegg til de vanlige metodene gjerne også må ha et OPTIONS slik at de såklate preflight-forespørslene nettleseren gjør er mulig.

Deploy API

Når man har definert API, kan man deploye det, slik at vi kan nå det fra web-applikasjonen.

1. Om du ikke er det allerede, gå til API Gateway og velg APIet du lagde tidligere
2. Velg «Actions» og så «Deploy API»
3. Vi skal nå produksjonsette/deploye/publisere APIet vi har laget til et nytt miljø. For å gjøre det må vi lage et miljø. Det vil si at du kan ha et miljø for produksjon, og et annet hvor du bare tester ut endepunktene dine. Et miljø i API Gateway kalles et stage. Vi har ikke noe stage, så vi må opprette dette. Velg «New stage» ved siden av «Stage»
4. I feltet «Stage name» skal vi gi navn til ditt Stage. Vi skal nok bare ha et i denne omgang, så du kan gjerne kalle det production. Vanlige navn er dev, test, qa eller prod.
5. Trykk «Deploy» for å lage Stage og produksjonsette til det.

Du vil nå få en del innstillinger for dette staget, blant annet URL til APIet for dette staget. Kopier lenken, slik at vi kan bruke den senere. Den står øverst etter «Invoke URL». Den ser noe sånt ut: https://<en API ID>.execute-api.<region>.amazonaws.com/<stage name>

Hvis du senere vil produksjonsette endringer i ditt API, går trykker du igjen «Actions» og så «Deploy API». Da velger du det Stage du ønsker å produksjonsette til, og trykker «Deploy»

Steg 5: Bring it all together

I dette steget skal vi se at applikasjonen virker. Det gjør vi ved å verifisere at vi kan lagre events i webappen, og gå tilbake senere og finne de samme eventene.

Det som må gjøres er:

1. Bytte endepunkter i web-applikasjonen slik at den går til din API Gateway
2. Bygge og produksjonsette web-applikasjonen i den S3-bucketen vi opprettet, slik at den er produksjonsatt med nye endepunkt
3. Verifisere at alt fungerer ved å teste applikasjonen

Endre endepunkt i webappen

Nå må vi endre koden for webappen, slik at vi går mot endepunktet du lagde i API Gateway.

1. Åpne repoet studentkurs-2019-webapp i en passende editor, for eksempel Visual Studio Code
2. Åpne filen eventService.ts i src/services
3. Noe kode er kommentert ut. Fjern kommentering og sett endepunktet. Husk å lagre filen!

Deploy av webapp med endringer

Når du har lagret endringene, må du bygge på nytt slik vi gjorde i steg 1. Det vil si, gå til webappen, kjør bygg-kommandoen (se nedenfor) og se at du har en dist-mappe. Deretter laster du opp denne slik du vi gjorde i steg 1, under «Publiser applikasjonen» -- enten med nettleser eller med terminalen.

$ npm run build

Verifiser at applikasjonen virker

Nå skal vi ha en web-applikasjon som lagrer data i en database. Lambda-funksjoner står for selve lagringsoperasjonen, og API Gateway står for APIet som web-applikasjonen snakker med. For å verifisere dette kan vi for eksempel gjøre følgende:

1. Åpne web-applikasjonen og opprette et event
2. Åpne web-applikasjonen fra en annen datamaskin/nettleservindu og se at det opprettede eventet dukker opp

Dersom dette ikke byr på problemer bør alt fungere som det skal! Gratulerer -- du har satt opp en web-applikasjon og backend i AWS.

Veien videre / Ekstraoppgaver

Nå har du fått satt opp alle de nødvendige tjenestene, hurra! Det er nå tid for å leke og videreutvikle løsningen din. Her er det veldig opp til deg selv, men her følger noen ideer til hva som kan gjøres:

Sette opp CloudFront foran webapplikasjonen

AWS CloudFront er en tjeneste for caching i Content Delivery Networks (CDN), som stort sett settes foran blant annet nettsider i S3, men også APIer for applikasjoner, for å redusere lastetid. Du kan sette opp dette ved å gå til CloudFront i AWS, og trykke «Create distribution». Du finner mer hjelp i denne guiden

Inviter venner per e-post

AWS har tjenester for å sende varsler på ulike måter, for eksempel via e-post. For det har de AWS SES. Ved å ta i bruk denne tjenesten, og legge til et ekstra felt som lagres i webapplikasjonen, kan vi invitere brukere til arrangementer.

1. Legg til et felt for e-postadresser i webappliksajonen, og sørg for at dette sendes med når man lagrer eller endrer et arrangement
2. Gjør endringer i Lambda-funksjonene (endre og lage arrangement) som plukker ut feltet med e-postadressene, og sender en e-post til hver av dem ved hjelp av AWS SES. Denne hjelpesiden kan være nyttig når du skal implementere dette.

Implementer bildeopplasting i webapplikasjonen

Vi ønsker også å kunne laste opp bilder til arrangementene, slik at man kan vekke interessen til besøkende på en bedre måte. For å få til det må vi:

1. Implemnetere opplasting av bilder i webapplikasjonen
2. Lagre plasseringen av bildene med arrangementet, altså ha et felt for bilde. Dette finnes allerede, feltet url er alt i bruk for dette i web-applikasjonen.
3. Vise bildet for arrangementer som har det, altså implementere dette i webapplikasjonen

Å kunne lagre bilder kan implemneteres direkte mot S3 fra webapplikasjonen. Denne siden bør kunne være en pekepinn på hvordan man gjør det.

Når bildet er lagret må du da få URL til bildet, og lagre sammen med arrangementet. Til slutt må denne URLen brukes til å vise bildet med arrangementet.