Skip to content

KBTG-Kampus-ClassNest-SE-Java/workshop-group-5

Repository files navigation

KBazaar - Online Shopping Application (Workshop)

Pre-requisites

Getting Started

  1. Clone this repository
  2. cd to kbazaar directory and run make setup (if not working you can run pre-commit manually)
  3. Run make test to run unit tests
  4. Run make test-it to run integration tests
  5. Run make run to start the application

Troubleshooting

ใช้ colima แทน Docker

เพิ่ม environment variables ต่อไปนี้ใน .env file

export DOCKER_HOST="unix://${HOME}/.colima/default/docker.sock"
export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE="/var/run/docker.sock"
export TESTCONTAINERS_RYUK_DISABLED=true

API Documentation

Example for .env

export SONAR_HOST_URL={REPLACE_ME}
export SONAR_TOKEN=${SONAR_TOKEN}

# spring config
export SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/postgres
export SPRING_DATASOURCE_USERNAME=postgres
export SPRING_DATASOURCE_PASSWORD=postgres
export SECURITY_JWT_SECRET={REPLACE_ME}

export ENABLED_FEATURE_PROMOTION_LIST_API=false

Existing Features

  • List all Shopper GET /shoppers
  • Get Shopper by username GET /shoppers/{username}
  • List all Products GET /products
  • Get Product by sku GET /products/{sku}
  • List all Promotions GET /promotions
  • Get Promotion by code GET /promotions/{code}

Infrastructure

STEP0: Initial Repository

  1. ใช้ repository ที่เตรียมไว้ให้ตามกลุ่ม
  2. Replace all group-5 ด้วย กลุ่มตัวเอง e.g group-1
  3. ทำการเพิ่มสมาชิกใน Github ของทีมเพื่อให้สามารถเข้าถึง Repository ได้
  4. ไปที่ Settings > Collaborators and teams > Manage access
  • กด Add People
  • เลือก Role เป็น Admin ทุกคนเลย

STEP1: 🎃 Setup AWS Credential

เพื่อให้ Access AWS ได้เราจะกำหนด Credential เข้าไปให้ Shell ของเราก่อน หรือ set ใน .bashrc, .zshrc ก็ได้

export AWS_ACCESS_KEY_ID=<KEY>
export AWS_SECRET_ACCESS_KEY=<SECRET>

STEP2: 🧾 Terraform

1.ติดตั้ง Terraform ให้เรียบร้อย

  1. cd ไปที่ infra/terraform จากนั้นรัน

  2. สั่งเริ่มต้น Terraform

terraform init
  1. สั่งสร้าง Terraform สร้าง Resource ใน AWS
terraform apply -var group_name="group-<ID>" --auto-approve
  1. ตอบ yes กด enter แล้วรอไปกดกินข้าวก่อน
Do you want to perform these actions?
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.

  Enter a value: yes

STEP3: 🚀 Deploy ยังไง?

เรา Deploy ด้วย ArgoCD ที่อยู่บน AWS EKS ผ่าน Terraform เพื่อให้ใช้งานได้ ต้องเตรียมของดังนี้

STEP3.1: 🍻 Setup CI/CD

ตั้งค่าสิทธิ์ในการเข้าถึงของ Github Action

  1. ไปที่ Settings > Actions > Workflow permissions > Read and write permissions
  2. Settings > Secrets and variables > Actions > New Repository
    • SONAR_HOST_URL
    • SONAR_TOKEN

STEP3.2: 🗂️ แก้ไข DATABASE_URL ให้เป็น url ของทีม

  1. find and replace <db_dev_url>, <db_dev_username>, <db_dev_password> ให้เป็น database url DEV connection ของทีม
  2. find and replace <db_prod_url>, <db_prod_username>, <db_prod_password> ให้เป็น database url PRODUCTION connection ของทีม

🛟 Kubernetes

1.ติดตั้ง AWS CLI ให้เรียบร้อย

2.ติดตั้ง Kubernetes CLI ให้เรียบร้อย

3.เนื่องจากเราใช้ AWS EKS เป็น Kubernetes Cluster ดังนั้นเราต้องเอา Kubernetes Context จาก AWS EKS โดยสั่ง (มั่นใจว่าเรา run command ที่ terminal เดียวกันกับเรา export AWS_ACCESS_KEY_ID และ AWS_SECRET_ACCESS_KEY)

aws eks update-kubeconfig --region ap-southeast-1 --name "eks-group-<ID>"

4.ลองสั่ง kubectl

kubectl get ns

ถ้าได้ผลลัพธ์ประมาณนี้เป็นอันใช้ได้

NAME              STATUS   AGE
default           Active   3d
kube-system       Active   3d
kube-public       Active   3d
kube-node-lease   Active   3d

เพิ่ม ingress controller

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.10.0/deploy/static/provider/cloud/deploy.yaml

💺 ArgoCD

1.รันคำสั่งสร้าง Namespace

kubectl create namespace argocd

2.รันคำสั่งติดตั้ง ArgoCD

kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

3.หารหัสผ่าน ArgoCD ของ admin ไว้ก่อน

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d; echo

4.Forword Port เพื่อใช้งาน ArgoCD

kubectl port-forward svc/argocd-server -n argocd 8080:443
  1. ไปที่ ArgoCD http://localhost:8080 แล้วใส่ Username admin และ Password ที่ได้จากข้อ 3.

🚀 Deployment

  1. setup gitops สำหรับ development env
  • กด + New App แล้วใส่ข้อมูลดังนี้
  • Application Name: group-<ID>-dev
  • Project Name: default
  • SYNC POLICY: Automatic
  • ✅ PRUNE RESOURCES
  • Repository URL: https://github.com/<your-github>/workshop
  • Revision: main
  • Path: infra/gitops/dev
  • Cluster URL: https://kubernetes.default.svc
  • กด Create มุมบนซ้าย
  1. setup gitops สำหรับ production env
  • กด + New App แล้วใส่ข้อมูลดังนี้
  • Application Name: group-<ID>-prod
  • Project Name: default
  • SYNC POLICY: Automatic
  • ✅ PRUNE RESOURCES
  • Repository URL: https://github.com/<your-account>/workshop
  • Revision: main
  • Path: infra/gitops/prod
  • Cluster URL: https://kubernetes.default.svc
  • กด Create มุมบนซ้าย

💣 ใช้ AWS เสร็จแล้วอย่าลืม Destroy ทิ้งน๊า (ห้ามทำในขณะที่กำลังเรียน Workshop อยู่)

  1. ก่อนจะ Destroy ด้วย Terraform ควรจะลบ Applicaton ใน Argo ทิ้งก่อน
  2. สั่งรัน Terraform Destroy
terraform destroy -var group_name="group-<ID>" --auto-approve