สวัสดี Cloud Run กับ C#

1. บทนำ

Cloud Run เป็นแพลตฟอร์มที่มีการจัดการซึ่งทำให้คุณเรียกใช้คอนเทนเนอร์แบบไม่เก็บสถานะที่เรียกใช้ผ่านคำขอ HTTP ได้ Cloud Run เป็นแบบ Serverless ด้วยการตัดการจัดการโครงสร้างพื้นฐานทั้งหมดออก คุณจึงมุ่งเน้นไปที่การสร้างแอปพลิเคชันที่ยอดเยี่ยม ซึ่งเป็นสิ่งที่สำคัญที่สุดได้

Cloud Run สร้างขึ้นจาก Knative ซึ่งให้คุณเลือกที่จะเรียกใช้คอนเทนเนอร์แบบมีการจัดการครบวงจรด้วย Cloud Run หรือในคลัสเตอร์ Google Kubernetes Engine ด้วย Cloud Run บน GKE ได้

เป้าหมายของ Codelab นี้คือการสร้างอิมเมจคอนเทนเนอร์และทําให้ใช้งานได้กับ Cloud Run

2. การตั้งค่าและข้อกำหนด

การตั้งค่าสภาพแวดล้อมแบบเรียนรู้ด้วยตนเอง

1. ลงชื่อเข้าใช้ Google Cloud Console แล้วสร้างโปรเจ็กต์ใหม่หรือใช้โปรเจ็กต์ที่มีอยู่ซ้ำ หากยังไม่มีบัญชี Gmail หรือ Google Workspace คุณต้องสร้างบัญชี

• ชื่อโปรเจ็กต์คือชื่อที่แสดงสำหรับผู้เข้าร่วมโปรเจ็กต์นี้ ซึ่งเป็นสตริงอักขระที่ Google APIs ไม่ได้ใช้ คุณอัปเดตได้ทุกเมื่อ
• รหัสโปรเจ็กต์จะไม่ซ้ำกันในโปรเจ็กต์ Google Cloud ทั้งหมดและเปลี่ยนแปลงไม่ได้ (เปลี่ยนไม่ได้หลังจากตั้งค่าแล้ว) Cloud Console จะสร้างสตริงที่ไม่ซ้ำกันโดยอัตโนมัติ ซึ่งโดยปกติแล้วคุณไม่จำเป็นต้องสนใจว่าสตริงนั้นคืออะไร ใน Codelab ส่วนใหญ่ คุณจะต้องอ้างอิงรหัสโปรเจ็กต์ (โดยทั่วไปจะระบุเป็น PROJECT_ID) หากไม่ชอบรหัสที่สร้างขึ้น คุณอาจสร้างรหัสแบบสุ่มอีกรหัสหนึ่งได้ หรือคุณอาจลองใช้ชื่อของคุณเองและดูว่ามีชื่อนั้นหรือไม่ คุณจะเปลี่ยนแปลงรหัสนี้หลังจากขั้นตอนนี้ไม่ได้ และรหัสจะคงอยู่ตลอดระยะเวลาของโปรเจ็กต์
• โปรดทราบว่ายังมีค่าที่ 3 ซึ่งคือหมายเลขโปรเจ็กต์ที่ API บางตัวใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าทั้ง 3 นี้ได้ในเอกสารประกอบ

ข้อควรระวัง: รหัสโปรเจ็กต์จะไม่ซ้ำกันทั่วโลกและบุคคลอื่นจะใช้รหัสนี้ไม่ได้หลังจากที่คุณเลือกแล้ว คุณเป็นผู้ใช้รหัสดังกล่าวเพียงคนเดียว แม้ว่าจะลบโปรเจ็กต์ไปแล้ว แต่ก็ไม่สามารถใช้รหัสซ้ำได้

หมายเหตุ: หากใช้บัญชี Gmail คุณสามารถปล่อยให้ตำแหน่งเริ่มต้นเป็นไม่มีองค์กรได้ หากใช้บัญชี Google Workspace ให้เลือกสถานที่ตั้งที่เหมาะสมกับองค์กร

2. จากนั้นคุณจะต้องเปิดใช้การเรียกเก็บเงินใน Cloud Console เพื่อใช้ทรัพยากร/API ของ Cloud การทำตาม Codelab นี้จะไม่มีค่าใช้จ่ายมากนัก หรืออาจไม่มีค่าใช้จ่ายเลย หากต้องการปิดทรัพยากรเพื่อหลีกเลี่ยงการเรียกเก็บเงินนอกเหนือจากบทแนะนำนี้ คุณสามารถลบทรัพยากรที่สร้างขึ้นหรือลบโปรเจ็กต์ได้ ผู้ใช้ Google Cloud รายใหม่มีสิทธิ์เข้าร่วมโปรแกรมช่วงทดลองใช้ฟรีมูลค่า$300 USD

Google Cloud Shell

แม้ว่าคุณจะใช้งาน Google Cloud จากแล็ปท็อปได้จากระยะไกล แต่ใน Codelab นี้เราจะใช้ Google Cloud Shell ซึ่งเป็นสภาพแวดล้อมบรรทัดคำสั่งที่ทำงานในระบบคลาวด์

Cloud Shell เป็นสภาพแวดล้อมการพัฒนาและการปฏิบัติการออนไลน์ที่เข้าถึงได้ทุกที่ด้วยเบราว์เซอร์ คุณจัดการทรัพยากรได้ด้วยเทอร์มินัลออนไลน์ที่โหลดไว้ล่วงหน้าพร้อมยูทิลิตีต่างๆ เช่น เครื่องมือบรรทัดคำสั่ง gcloud, kubectl และอื่นๆ นอกจากนี้ คุณยังพัฒนา สร้าง แก้ไขข้อบกพร่อง และทำให้แอปในระบบคลาวด์ใช้งานได้โดยใช้ Cloud Shell Editor แบบออนไลน์ได้ด้วย

เครื่องเสมือนนี้มีเครื่องมือพัฒนาซอฟต์แวร์ทั้งหมดที่คุณต้องการ โดยมีไดเรกทอรีหลักแบบถาวรขนาด 5 GB และทำงานใน Google Cloud โดยตรง ซึ่งช่วยเพิ่มประสิทธิภาพเครือข่ายและการตรวจสอบสิทธิ์ได้อย่างมาก ซึ่งหมายความว่าคุณจะต้องมีเพียงเบราว์เซอร์เท่านั้นสำหรับโค้ดแล็บนี้ (ใช่แล้ว ใช้ได้ใน Chromebook)

• หากต้องการเปิดใช้งาน Cloud Shell จาก Cloud Console เพียงคลิกเปิดใช้งาน Cloud Shell

หากเริ่มใช้ Cloud Shell เป็นครั้งแรก คุณจะเห็นหน้าจอระดับกลางที่อธิบายว่า Cloud Shell คืออะไร หากเห็นหน้าจอระดับกลาง ให้คลิกต่อไป

การจัดสรรสภาพแวดล้อมจะใช้เวลาเพียงไม่กี่วินาที

เมื่อเชื่อมต่อกับ Cloud Shell แล้ว คุณจะเห็นว่าระบบได้ตรวจสอบสิทธิ์คุณแล้ว

gcloud auth list

เอาต์พุตของคำสั่ง

Credentialed Accounts

ACTIVE: *
ACCOUNT: <my-account>@<mydomain>

หมายเหตุ: gcloud เครื่องมือบรรทัดคำสั่งเป็นเครื่องมือบรรทัดคำสั่งที่มีประสิทธิภาพและเป็นหนึ่งเดียวใน Google Cloud โดยจะติดตั้งมาล่วงหน้าใน Cloud Shell คุณจะเห็นว่าเครื่องมือนี้รองรับการเติมข้อความอัตโนมัติด้วยการกด Tab ระบบอาจแจ้งให้คุณตรวจสอบสิทธิ์ในครั้งแรกที่เรียกใช้คำสั่ง ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมเครื่องมือบรรทัดคำสั่ง gcloud

นอกจากนี้ โปรเจ็กต์ควรตั้งค่าเป็น PROJECT_ID อยู่แล้ว (ในกรณีที่คุณเลือกโปรเจ็กต์ในเว็บคอนโซล)

gcloud config list project

เอาต์พุตของคำสั่ง

[core]
project = <PROJECT_ID>

หากไม่ได้ตั้งค่าโปรเจ็กต์ด้วยเหตุผลบางประการ ให้เรียกใช้คำสั่งต่อไปนี้

gcloud config set project <PROJECT_ID>

หากกำลังมองหา PROJECT_ID ดูเมนูแบบเลื่อนลงที่ด้านบนของ Cloud Console

นอกจากนี้ คุณยังดูรายละเอียดโปรเจ็กต์ได้โดยใช้ส่วน "การตั้งค่าและยูทิลิตี" ดังนี้

นอกจากนี้ Cloud Shell ยังตั้งค่าตัวแปรสภาพแวดล้อมบางอย่างโดยค่าเริ่มต้น ซึ่งอาจมีประโยชน์เมื่อคุณเรียกใช้คำสั่งในอนาคต

echo $GOOGLE_CLOUD_PROJECT

เอาต์พุตของคำสั่ง

<PROJECT_ID>

• สุดท้าย คุณสามารถตั้งค่าโซนเริ่มต้นได้โดยทำดังนี้

gcloud config set compute/zone us-central1-f

คุณเลือกโซนอื่นได้ ดูข้อมูลเพิ่มเติมได้ที่ภูมิภาคและโซน

หมายเหตุ: เมื่อเรียกใช้ gcloud ในเครื่องของคุณเอง ระบบจะบันทึกการตั้งค่า Config ไว้ในเซสชันต่างๆ แต่ใน Cloud Shell คุณจะต้องตั้งค่านี้สำหรับเซสชันใหม่หรือการเชื่อมต่อใหม่ทุกครั้ง

เปิดใช้ Cloud Run API

เปิดใช้ Cloud Run API จาก Cloud Shell โดยทำดังนี้

gcloud services enable run.googleapis.com

ซึ่งควรจะแสดงข้อความว่าดำเนินการสำเร็จคล้ายกับข้อความนี้

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully.

3. เขียนแอปพลิเคชันตัวอย่าง

เราจะสร้างแอปพลิเคชัน ASP.NET C# อย่างง่ายที่ตอบสนองต่อคำขอ HTTP

หากต้องการสร้างแอปพลิเคชัน ให้ใช้dotnetเครื่องมือบรรทัดคำสั่งใน Cloud Shell ดังนี้

dotnet new web -o helloworld-csharp

เปลี่ยนเป็นไดเรกทอรี helloworld-csharp

cd helloworld-csharp

หากต้องการแก้ไขไฟล์ ให้ใช้ vi, emacs, nano หรือโปรแกรมแก้ไขเว็บของ Cloud Shell โดยคลิกไอคอนโปรแกรมแก้ไขรูปปากกาใน Cloud Shell ("เปิดตัวแก้ไขโค้ด")

จากนั้น ให้อัปเดต Program.cs ให้ตรงกับข้อมูลต่อไปนี้

var builder = WebApplication.CreateBuilder(args);

var port = Environment.GetEnvironmentVariable("PORT") ?? "8080";
var url = $"http://0.0.0.0:{port}";
builder.WebHost.UseUrls(url);

var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

โค้ดนี้จะสร้างเว็บเซิร์ฟเวอร์พื้นฐานที่รอฟังพอร์ตซึ่งกำหนดโดยตัวแปรสภาพแวดล้อม PORT และตอบกลับด้วย Hello World

คุณสามารถทดสอบแอปได้โดยการเรียกใช้แอปในเครื่องใน Cloud Shell คุณควรเห็นว่ากำลังฟังอยู่บนพอร์ต 8080 ดังนี้

$ dotnet run
Using launch settings from /home/atameldev/helloworld-csharp/Properties/launchSettings.json...
Hosting environment: Development
Content root path: /home/atameldev/helloworld-csharp
Now listening on: http://0.0.0.0:8080
Application started. Press Ctrl+C to shut down.

เรามีเอกสารประกอบในภาษาอื่นๆ อีกมากมายเพื่อช่วยให้คุณเริ่มต้นใช้งาน Cloud Run ได้ และคุณสามารถดูวิธีการสำหรับ Go, Python, Java, PHP, Ruby, สคริปต์ Shell และอื่นๆ ได้ที่ https://cloud.google.com/run/docs/quickstarts/build-and-deploy

4. ทำให้ใช้งานได้กับ Cloud Run

ทำให้แอปพลิเคชันใช้งานได้ใน Cloud Run ด้วยคำสั่งต่อไปนี้

gcloud run deploy hello-world \
    --allow-unauthenticated \
    --region us-central1 \
    --source .

• hello-world คือชื่อบริการ
• ฟีเจอร์allow-unauthenticatedจะทำให้บริการพร้อมใช้งานแบบสาธารณะโดยไม่ต้องมีการตรวจสอบสิทธิ์
• us-central1 คือภูมิภาคที่จะติดตั้งใช้งานแอป
• โดยแฟล็ก source จะกำหนดตำแหน่งของแหล่งที่มาที่จะสร้าง Cloud Run ใช้ Buildpack เพื่อสร้างคอนเทนเนอร์จากซอร์สโค้ดโดยอัตโนมัติ

รอ 2-3 นาทีจนกว่าการติดตั้งใช้งานจะเสร็จสมบูรณ์ เมื่อสำเร็จ บรรทัดคำสั่งจะแสดง URL ของบริการดังนี้

Service [hello-world] revision [hello-world-00001-yos] has been deployed and is serving 100 percent of traffic.
Service URL: https://helloworld-wdl7fdwaaa-uc.a.run.app

ตอนนี้คุณสามารถไปที่คอนเทนเนอร์ที่ติดตั้งใช้งานได้โดยเปิด URL ของบริการในเว็บเบราว์เซอร์

ยินดีด้วย คุณเพิ่งทําให้แอปพลิเคชันที่แพ็กเกจในอิมเมจคอนเทนเนอร์ใช้งานได้กับ Cloud Run Cloud Run จะปรับขนาดรูปภาพคอนเทนเนอร์ในแนวนอนโดยอัตโนมัติเพื่อจัดการคำขอที่ได้รับ จากนั้นจะปรับขนาดลงเมื่อความต้องการลดลง คุณจะจ่ายเฉพาะค่า CPU, หน่วยความจำ และเครือข่ายที่ใช้ไปในระหว่างการจัดการคำขอ

แม้ว่าแล็บสั้นๆ นี้จะดำเนินการโดยใช้บรรทัดคำสั่ง gcloud แต่ Cloud Run ก็พร้อมใช้งานผ่าน Cloud Console ( console.cloud.google.com) เพียงไปที่ Compute > Cloud Run คุณก็จะเห็นบริการ helloworld แสดงอยู่

นอกจากนี้ คุณยังใช้คอนโซลเพื่อทำให้บริการ Cloud Run ใช้งานได้ด้วย

5. ได้เวลาทำความสะอาดแล้ว

คุณสามารถเลือกที่จะลบโปรเจ็กต์ GCP เพื่อหลีกเลี่ยงการเรียกเก็บเงิน ซึ่งจะหยุดการเรียกเก็บเงินสำหรับทรัพยากรทั้งหมดที่ใช้ภายในโปรเจ็กต์นั้น หรือจะลบบริการ Cloud Run ก็ได้ โดยทำดังนี้

gcloud run services delete helloworld

6. ขั้นตอนต่อไปคืออะไร

ขั้นตอนถัดไปที่ควรทำคือทำให้ใช้งานได้กับ Cloud Run บน GKE

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างคอนเทนเนอร์ HTTP แบบไม่เก็บสถานะที่เหมาะกับ Cloud Run จากแหล่งที่มาของโค้ดและการพุชคอนเทนเนอร์ไปยัง Container Registry ได้ที่

• การพัฒนาบริการ Cloud Run
• การสร้างคอนเทนเนอร์