workshop

สวัสดีชาวโลก 👋 ยินดีต้อนรับสู่ Software Engineering with Go ในส่วนของ Workshop

สิ่งที่ต้องเตรียม

• brew install terraform (หรือติดตั้งตาม terraform install-cli)
• brew install kubectl
• brew install awscli
• Install Container Management (Rancher Desktop, Docker Desktop, Minikube, etc.)

STEP0: Fork Repository

1. Fork repository นี้ไปที่ Github ของตัวเอง
2. 1 ทีม 1 Fork 1 คนเท่านั้นพอ เราจะเพิ่มเพื่อนใน Step ถัดๆไปไม่ต้องกังวัล

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

3. สั่งสร้าง Terraform สร้าง Resource ใน AWS

terraform apply -var group_name="group-<ID>" --auto-approve

4. ตอบ 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

หลังจากที่ Fork repository ไปแล้ว จะให้ CI/CD ทำงานได้ จะต้องเซ็ตค่า WORKFLOW_TOKEN ด้วย โดยเอามาจาก PAT ของ Github จากนั้นเอาไปใส่ที่ Secret

1. สร้าง Personal Access Token ของ Github
2. ไปที่ Personal Access Token
3. กด Generate new token (classic) เอา classic นะ
4. ตั้งชื่อ Note เป็น ชื่อกลุ่มตัวเอง เช่น group-1
5. กดเลือกทีละอัน ทั้งหมด ทุกอัน แล้วกด Generate token
6. เสร็จแล้ว copy ไว้ มันจะไม่แสดงอีกแล้ว copy ได้แค่ครั้งเดียว ห้ามทำหาย
7. set ค่า WORKFLOW_TOKEN ใน Github ของทีม
8. กลับไปที่ Repository workshop ของเรา ที่เรา fork มา (e.g. <https://github.com//workshop>)
9. ไปที่ Settings > Secrets and variables > Actions
10. กด New repository secret
11. ใส่ชื่อ Name เป็น WORKFLOW_TOKEN แล้วใส่ค่า Personal Access Token ที่เรา copy ไว้ใน ใส่เข้าไปในช่อง Secret
12. กด Add secret
13. จบแล้ว

References:

• Generate PAT
• Create GHA Secret

1. แก้ไข CI/CD ให้เป็นชื่อ repository ของทีม
2. ไปที่ Github Repository ของทีม แล้วไป tab Actions ดูว่า CI/CD ทำงานได้ไหม
3. กด I understand my workflows, go ahead and enable them ถ้าเป็นครั้งแรกที่ใช้งาน
4. เปิดโปรเจคของเราด้วย VSCode แล้ว find and replace <your-github-account> ให้เป็นชื่อ github account ของคุณคนที่ fork มา ( MUST be lowercase)
5. git add -> git commit -> git push

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

1. find and replace <DB_CONNECTION_DEV> ให้เป็น database url DEV connection ของทีม

2. find and replace <DB_CONNECTION_HOTFIX> ให้เป็น database url HOTFIX connection ของทีม

3. find and replace <DB_CONNECTION_PRD> ให้เป็น database url PRODUCTION connection ของทีม

STEP3.3: เพิ่มสมาชิกใน Github

1. ทำการเพิ่มสมาชิกใน Github ของทีมเพื่อให้สามารถเข้าถึง Repository ได้
2. ไปที่ Settings > Collaborators and teams > Manage access

• กด Add People
• เลือก Role เป็น Admin ทุกคนเลย

🛟 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

💺 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

5. ไปที่ ArgoCD http://localhost:8080 แล้วใส่ Username admin และ Password ที่ได้จากข้อ 3.

6. setup gitops สำหรับ development env

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

note: ตรวจสอบให้แน่ใจว่าที่ https://github.com/?tab=packages ที่ workshop เป็น public (ไม่มีคำว่า private แสดงอยู่)

7. setup gitops สำหรับ production env

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

จบแล้ว

• สามารถหา endpoint ของ api ได้จาก ArgoCD -> ในกล่อง svc api เราจะเห็น HOSTNAMES url ที่ deploy ไปใน aws

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

1. ก่อนจะ Destroy ด้วย Terraform ควรจะลบ Applicaton ใน Argo ทิ้งก่อน
2. สั่งรัน Terraform Destroy

terraform destroy -var group_name="group-<ID>" --auto-approve

🏁 Development เริ่มยังไง?

ใน Repository นี้เราใช้ Makefile ในการทำงานได้ ดังนั้นสามารถสั่งรันง่ายๆ ผ่าน make ได้เลย

1.เริ่มต้นลองสั่งติดตั้ง dependencies ของ Go มาก่อน

make install

2.จากนั้นสั่งรันได้เลย

make dev

เมื่อ Server ทำงานได้ควรจะสามารถเรียกจาก http://localhost:1323

👻 รัน Test ยังไง?

โปรเจกนี้มี 3 ระดับคือ unit, integration ระดับของ Go และ end-to-end ในระดับ Backend รันได้ดังนี้

🪛 Unit

make test-unit

⚙️ Integration

make test-integration

🤖 End-to-End

make test-e2e

🔐 Basic Autentication

username: admin
password: secret