DEV Community: Chanyut Leecharoen

Go kit ... first time

Chanyut Leecharoen — Sun, 27 Dec 2020 08:49:19 +0000

Go kit เป็น Library ตัวหนึ่ง ที่นำเสนอเรื่องรูปแบบ Structure เอาไว้จัดโครงสร้างของ code ให้เหมาะกับการทำ Micro service บางทีก็ถูกย้อนแย้งว่ามันเป็น Elegant Monolith ซะมากกว่า ซึ่งผมก็เห็นด้วยนิดๆนะ ติดว่าถ้าไม่จำเป็นต้องแยก service ออกมาจริงๆ implement แบบรวมๆไปเลยเป็น Monolith สบายกว่าเยอะจ้า

Go kit เสนอแนวคิด โดยให้แบ่ง structure ออกเป็น 3 domain (จากด้านในไปด้านนอก)

Service ดูแล business logic ใน layer เราสามารถแบ่งออกเป็น layer ย่อยๆ แบบใน clean architecture ได้เช่น data model, repository, logic layer
Endpoint เป็นตัวคั่น business logic ให้แยกออกจากส่วนจัดการการรับส่ง request (transport layer เช่น HTTP, gRPC, ...) ในชั้นนี้จะรับ [Request] object จากชั้น Transport แล้วแกะ parameters (p1, p2, p3, ... pn) ที่ต้องการออกจาก [Request] object และไป call function ที่ผูกไว้กับ ชั้น Service serviceFunc1(p1, p2, p3, ... pn) และเอา return Values ที่ได้จากการ call function มารวมกันเป็น [Response] object ส่งกลับออกไปที่ชั้น Transport เพื่อให้ส่งกลับไปให้ client
Transport เป็น layer ที่คอยจัดการวิธีรับส่งข้อมูล ด้วย protocol ต่างๆเช่น HTTP, gRPC, ... ในชั้นนี้จะทำหน้าที่แกะเอา parameter ออกจาก Request (กรณีของ HTTP server ก็จะอ่าน parameters จาก Header, Query string, Form หรือ Request body) แล้วเอามาประกอบเป็น [Request] object เพื่อส่งต่อไปที่ Endpoint ที่เชื่อมไว้ และเมื่อได้รับ [Response] object กลับมาจาก Endpoint ก็เอาไปแปลงเป็น Response ในรูปแบบของ Protocol ต่างๆ และส่งกลับไปให้ client (หรืออีก service ที่เป็นคนส่ง request มา)

ตัวอย่าง Flow ของ data ที่วิ่งผ่านระหว่าง layer ต่างๆ โดยใช้ HTTP server เป็นชั้น Transport

ในชั้น Transport HTTP server รับ HTTP request มา
แกะ parameter แต่ละตัวออกมาจาก Request body, Header, Form values, หรือ Query string และประกอบกันเป็น [Request] object
ส่ง [Request] object ต่อไปที่ Endpoint ที่ผูกไว้กับ api path นั้นๆ
Endpoint รับเอา [Request] object มา แล้วแกะเอา parameter ออกมาเป็น parameters ต่างๆ p1, p1, ..., pn
call function ในชั้น Service r1, r2, r3, ... rn = serviceFunction(p1, p2 , p3,... pn) และเอา returned values r1, r2, r3, ... rn มาประกอบกันเป็น [Response] object ส่งกลับไปที่ Endpoint
Endpoint ส่ง [Response] object ไปที่ชั้น Transport
Transport layer เอา [Response] object มาแปลงเป็น HTTP Response และส่งกลับไปให้ client

ความเห็นส่วนตัวหลังจากลอง migrate project เดิม

😄 แยก Business logic ออกมาได้ชัดเจนขึ้น สามารถแก้ไขแต่ละ layer โดยไม่กระทบกัน
😄 ถ้าวาง function ที่รองรับ Business logic ไว้แล้วใน Service layer (และมี function signature ที่นิ่งพอแล้ว) สามารถกระจายงานให้ programmer แยกย้ายกันไปจัดการใน layer ต่างๆได้เลย
😆 กำลังสนุกกับการใช้ Middleware มันสามารถทำ logging middleware เพื่อ log event ในแต่ละ layer ได้เลย หรือทำ rate limit, load balance และแต่ละ Middleware สามารถถอดเข้าออกได้โดยที่ไม่กระทบมากนัก
😓 Refractor เหนื่อยหน่อย ถ้ามีการเปลี่ยน function signature จาก Service layer แล้วล่ะก็ กระทบชิ่งยันชั้น Transport layer เลย
😓 หลังจากลอง implement ไป 3 service พบว่าตัวเองต้องเขียน code เยอะมาๆ และใช้เวลานานเลยทีเดียว อย่างตอนทำ service Leaderboard ที่มีประมาณ 6 endpoint ก็ใช้เวลาไปประมาณ 8-10 ชั่วโมง
🙄 ถึงแม้จะทำ code snippet เก็บไว้ใช้ มันก็ช่วยลดเวลา และ bug ได้อยู่บ้าง แต่ก็ยังต้อง code เยอะอยู่ดี คิดว่าถ้าใช้จนคล่อง และแม่นขึ้นแล้วจะไปลองใช้ tool พวก code generator ดูบ้าง

จบเพียงเท่านี้กับ Blog สั้นๆเรื่อง ครั้งแรกกับ Go kit แล้วถ้าผมเข้าใจเรื่อง Middleware มากขึ้นแล้วจะมาเขียน share ให้อีกทีจ้า

Golang - EP01. Intro

Chanyut Leecharoen — Mon, 06 Jul 2020 22:31:11 +0000

เกริ่น...

บทความในซีรี่ Golang tutorial ต่อไปนี้ อาจจะไม่มีคำหยาบหรือมุกตลกให้ทุกท่านได้ขำขันเฮฮากัน จะมีก็แต่ความรู้จากประสบการณ์การใช้ภาษา Go มาตลอด 2 ปี ผสมกับมุกแบบเนิร์ดๆ ฝืดๆ ที่แทรกเข้ามาอยู่บ้าง ถ้าผิดพลาดประการใด ก็ขอภัยมา ณ ที่นี้

สวัสดีครับ ผม ชาญยุทธ์ aka บิ๊ก ... ตามที่เกริ่นไว้ว่าใช้ golang มาประมาณนึง เลยอยากจะรวบรวมความรู้มาไว้เป็น Tutorial Blog สั้นๆ เอาไว้ใช้เป็นชุดความรู้สำหรับเทรนน้องๆที่เข้ามาร่วมงานใหม่ที่ studio ส่วนถ้าใครหลงเข้ามาอ่านก็ยินดีที่ได้รู้จักครับ และหวังว่าจะได้ประโยชน์กลับไปมิใช่น้อย ถ้ามีคำถามอะไร comment ไว้ได้เลย จะพยายามมาตอบให้ครับ

ใน Tutorial นี้จะแบ่งเป็น post ย่อยๆ ตามนี้

Ep02. เตรียม Dev environment

ค่อยๆอ่านเรียงๆกันไป แต่ถ้าใครเน้นไวอ่านข้ามไปข้ามมา กระผมขอไม่รับประกันความพึงพอใจมาไว้ ณ ที่นี้ด้วยนะครับ ถ้าพร้อมแล้วมาเริ่มต้นกันที่ Ep02. เตรียม Dev environment

Golang - EP02. เตรียม Dev environment

Chanyut Leecharoen — Mon, 06 Jul 2020 22:25:10 +0000

จะเริ่มต้น dev ด้วย golang เราต้องการ 2 สิ่ง คือ

Text Editor
Go Binary

Text editor

ขอแนะนำเป็น Visual Studio Code มันฟรีจร้า ส่วนถ้ามีกำลังทรัพย์ซักหน่อยก็ไปจัดตัวนี้เลย GoLand เค้าว่ากันว่าดี... แต่แพงนะ

Go Binary

อันนี้จำเป็น เพราะเป็นพวก library files และ tool ต่างๆ ที่จำเป็นต้องใช้ ก็ไป download กันได้ ตาม link download นี้เลยจัดไป! (ณ วันที่เขียน post นี้จะเป็น go version 1.14.4)

Windows Terminal

จริงๆแล้วเราสามารถใช้ Window cmd เพื่อ run คำสั่งของ Go ได้ แต่ยังไงขอแนะนำของใหม่ (ณ ตอนที่เขียน blog นี้) ซึ่งก็คือ Windows Terminal สามารถ download ได้ผ่านทาง Microsoft Store

มาเริ่มกันเลย

ตัว OS ของผมเป็น windows มันจะมี file .msi ให้ download

หลังจาก download เรียบร้อยก็ double click อย่างที่คุ้นเคย แล้วก็ Next, Next, Yes, Yes ไปตามระเบียบ ...

หลังจากที่ install เรียบร้อยแล้ว ตัว Go binary จะ extract file ต่างๆไปวางไว้ที่ folder C:\Go

ถัดมาให้เข้าไปดูที่ Environment Variables

Double click ที่ Variable Path เพื่อดู path ทั้งหมดที่ set เอาไว้

และดูว่ามี path C:\Go\bin อยู่แล้วหรือไม่ ถ้ายังไม่มีให้กด New แล้วก็ Browse ไปที่ folder C:\Go\bin เพื่อ add เข้ามา

ถ้าทุกอย่างเรียบร้อยดี ให้ทดสอบโดยการ เปิด Windows Terminal ขึ้นมา

และพิมพ์ command go version แล้ว enter จะได้ผลลัพธ์แบบนี้

ต่อมาเราจะลง Visual Studio Code กัน สามารถ download ได้ที่ Link นี้ ซึ่งต่อไปนี้ผมจะเขียนชื่อมันสั้นๆว่า vscode (วี-เอส-โค้ด) นะครับ

หลังจาก install เรียบร้อยแล้วให้ เปิด vscode ขึ่นมา ก็จะเห็นหน้าตาหล่อๆแบบนี้

ต่อมาเราจะ install extension สำหรับปรับแต่ง เราสามารถใช้ vscode เพื่อเขียน Go ได้สะดวกขึ้น [1] เลือกที่ Tab "Extension" > [2] พิมพ์ค้นหา "Golang" > [3] กด Install

หลังจากลง extension เรียบร้อยแล้ว เราจะ install tools ต่างๆของ Go เพื่อ support การเขียน code ของเรา กด Ctrl + Shift + p (ทั้งสามปุ่มพร้อมกัน) เพื่อเปิด Command palette ขึ้นมา

จากนั้น [1] พิมพ์ go install ในช่องค้นหา > [2] กดที่ Go install / update tools

แล้วมันจะให้เลือกว่าเราจะ install หรือ update package ไหนบ้าง [1] เลือกติ๊กถูกเพื่อเลือกทุก package > [2] กด Ok

รอให้ vscode download และ install package ทั้งหมด ในขั้นตอนนี้อาจจะใช้เวลาซักหน่อยนึง ก็ออกไปเตะบอลก่อนแล้วค่อยกลับมาดูก็ได้นะ

ถ้าทุกอย่างพร้อมแล้ว ใน post ถัดไป เราจะมาเริ่มเขียน "Hello world" ด้วย Golang กัน ไปต่อกันเลย