Eivinddh / terraform-aws-ws-starterpack

Webapp i AWS med terraform

En implementasjon av infratrukturen fra https://immutablewebapps.org/

Basert på @kleivane's workshop: https://github.com/kleivane/terraform-aws-ws/

Forberedelser

• Opprett en fork av dette repoet på din egen bruker og klon det ned på egen maskin
• Sjekk at node og npm er installert
• brew install awscli
• brew install terraform
• Hent brukeren for gruppa di i dokumentet som deles på Discord
• Kjør kommandoen aws configure med ACCESS_KEY_ID og SECRET_ACCESS_KEY som du fikk fra brukeren over. Bruk region eu-north-1
  • Kommandoen aws iam get-user kan brukes som en ping og sjekk av alt ok!
  • Når vi senere skal bruke terraform til å sette opp vår infrastruktur, er det credentials konfigurert gjennom aws-cliet over som terraform også bruker som credentials

Bli kjent

Om appen

Lokal oppstart

• Kjør opp appen med npm install && npm run start
• Gjør deg kjent med hvor de forskjellige inputene og env-variablene i appen kommer fra (sjekk dev-index.html, deploy-env.js og upload-assets.js)

Min første webapp i skyen

Felles mål her er en webapp med to S3-buckets hoster index.html og kildekode.

Nyttige lenker:

• Om du ikke er veldig kjent i aws-konsollen fra før, anbefaler jeg å sjekke ut de forskjellige servicene underveis
  • https://console.aws.amazon.com/s3
  • https://console.aws.amazon.com/lambda
• Terraform-docs
• AWS-cli-docs

Testmiljø med buckets

Opprett to buckets med terraform som skal bli der vi server asset og host. Start i terraform/test/main.tf. Husk at S3-bucketnavn må være unike innenfor en region!

Når du mener main.tf inneholder riktig konfigurasjon kan du først kjøre terraform init inne i terraform/test i repoet for å sette opp terraform. Deretter bruker du terraform plan for å se hvordan terraform tolker konfigurasjonen du har lagd. Om du er fornøyd kjører du terraform apply for å iverksette konfigurasjonen i AWS.

Noter denne terraform-outputen for begge buckets:

• bucket_domain_name - denne lenken kan du bruke til å aksessere filene du har lastet opp
• id - navnet på bucketen du har opprettet

Når begge bucket er oppprettet uten mer oppsett, og du kan gå inn i konsollen på web og manuelt laste opp en tilfeldig fil. Den vil ikke tilgjengelig på internett via bucket_domain_name/filnavn, ettersom default-policyen er at bucket er private. Vi kan konfigurere public tilgang ved å bruke acl-parameteret på en bucket eller en bucket policy. Sistnevnte er anbefalt av AWS ettersom bucketacl er et eldre og skjørere konsept.

Åpne buckets for automatisk opplasting med policies

Dersom du satte acl-parameteret på bøttene kan du fjerne det før dette steget.

Opprett bucketpolicies for begge bøttene ved å bruke aws_s3_bucket_policy. I policy-atributtet kan du bruke en templatefile med fila policy/public_bucket.json.tpl. Denne trenger en variabel bucket_arn. Bruk atributtet fra bucketen for å sende inn rett arn.

Se policy.md for en forklaring på innholdet i policyen. Husk å kjøre terraform apply for å iverksette endringene!

npm run upload-assets

Gjør endring i upload-assets.js og sett navn inn rett navn på bucket. Som version kan du beholde 1 forelpig. Kjør scriptet med npm run upload-assets og sjekk at du får den bygde main.js lastet opp i bøtta og public tilgjengelig på nett.

npm run deploy-test

Gjør endring i deploy-env.js og sett navn inn rett navn på bucket og rett url til assets-bucket (husk https://!). Som version kan du beholde 1 eller sette samme versjon som du gjorde i steget over. Kjør scriptet med npm run deploy-test og sjekk at du får den bygde index.html lastet opp i bøtta og public tilgjengelig på nett.

Denne fila skal du nå kunne åpne fra bucketen og se appen 🚀

Redeploy

Dersom du kjører npm run deploy-test med samme versjonsnummer en gang til, vil du se at Build deploy at endrer seg, mens fargen, heading og Build created at er den samme.

Ny versjon

Prøv å gjør en endring i koden og deploy en ny versjon! Hvilket tall du velger spiller ingen rolle, men husk å oppdatere versjonen både i upload-assets.js og deploy-env.js

Løsningsforslag i repoet frem til hit ligger under https://github.com/kleivane/immutable-webapp/tree/master/terraform/test-1. Forslaget er lagd for en større versjon av denne workshoppen, og inneholder nok en del du ikke trenger.

Vil du fortsette mere?

• Lag et prodmiljø ved å lage en ny host-bucket.
  • Trenger du noe mer oppsett for å skape et nytt miljø med egen deploy-funksjon?
  • Hvor mange assets-buckets trenger du?
• Legg til litt ekstra funksjonalitet med en AWS Lambda-funksjon for å hente data!
  • Vi har lagd en enkel funksjon som returnerer et tilfeldig tall.
  • Du trenger å provisjonere en Lambda, en API Gateway og en bucket til å holde på kildekoden for Lambdaen
  • Kanskje denne guiden kan hjelpe?
    • Den bruker AWS CLI til å legge til kildekode i bucket, kan du gjøre det med et NPM-script?
  • Hvordan skal du få hentet og vist dette tallet på nettsiden din?