Chuyển đến nội dung chính
Quay lại danh sách bài viết

gcloud CLI 591 แก้ตัวอัปเดตค้างบน macOS: รุ่น 590 ต้องใช้คำสั่งเฉพาะครั้ง

Google Cloud CLI 591.0.0 แก้บั๊ก components update บน macOS แต่เครื่องที่ติด 590.0.0/590.0.1 อาจต้องใช้ workaround จาก release notes ก่อนขึ้นรุ่นใหม่

gcloud CLI 591 แก้ตัวอัปเดตค้างบน macOS: รุ่น 590 ต้องใช้คำสั่งเฉพาะครั้ง

Google Cloud CLI รุ่น 591.0.0 ที่ประกาศเมื่อ 27 ตุลาคม 2026 แก้ปัญหาการอัปเดตบน macOS ซึ่งคำสั่ง gcloud components update ในรุ่น 590.0.0 และ 590.0.1 อาจจบลงหลังแสดงข้อความ WARNING: Known issue encountered updating Python modules ทำให้ผู้ใช้ติดอยู่ที่รุ่นเดิม ประเด็นที่ต้องเข้าใจคือแม้รุ่น 591 มีการแก้ไขแล้ว เครื่องที่ติดตั้งรุ่น 590 ที่มีบั๊กยังอาจใช้คำสั่งอัปเดตแบบปกติเพื่อไปถึงรุ่น 591 ไม่สำเร็จ Google จึงระบุคำสั่งแก้เฉพาะครั้งสำหรับเครื่องที่ติดปัญหานี้

ใครได้รับผลกระทบ

ขอบเขตที่ release notes ระบุชัดคือ macOS ที่มี Google Cloud CLI รุ่น 590.0.0 หรือ 590.0.1 และพบอาการอัปเดตติดขัด ผู้ใช้รุ่น 589.0.0 หรือต่ำกว่า และผู้ใช้ 591.0.0 ขึ้นไปไม่ต้องใช้ workaround นี้ สามารถเรียก gcloud components update ตามปกติได้ การเห็นคำว่า “Breaking Changes” ในหัวข้อ release notes ไม่ได้หมายความว่าทุกแพลตฟอร์มต้องรันคำสั่งพิเศษ ให้เริ่มจาก gcloud version เพื่อยืนยันรุ่นจริงก่อนทำอะไร

หากติดตั้ง Google Cloud CLI ด้วย package manager ที่ปิด component manager เช่น APT หรือ yum คำสั่ง gcloud components update ใช้ไม่ได้ตามแนวทางปกติอยู่แล้ว ต้องอัปเดตผ่าน package manager ที่ใช้ติดตั้ง กรณีข่าวนี้เน้น macOS และการอัปเดตผ่าน component manager ไม่ควรยก workaround ไปใช้กับ container image, Linux package หรือเครื่อง Windows โดยไม่มีเหตุ

คำสั่งแก้เฉพาะครั้งจาก Google

Google แนะนำให้ใช้ gcloud components --flags-file=<(echo 'update:') บน shell ที่รองรับ process substitution เช่น Bash หรือ Zsh เมื่อเครื่องรุ่น 590.0.0/590.0.1 มีอาการดังกล่าว คำสั่งนี้ส่งไฟล์ flags ชั่วคราวที่มี update: ให้กลุ่มคำสั่ง components เพื่อผ่านเส้นทางที่เกิดบั๊ก หลังอัปเดตสำเร็จให้ตรวจ gcloud version ว่าเป็นรุ่น 591.0.0 หรือใหม่กว่า และลองคำสั่งที่ทีมใช้งานจริง เช่น gcloud auth list หรือคำสั่งอ่านสถานะทรัพยากรที่ไม่เปลี่ยนระบบ เพื่อยืนยันว่า CLI ยังทำงานครบ

ควรคัดลอกคำสั่งจากเอกสารทางการโดยตรง และรันใน shell ที่รองรับรูปแบบ <(...) เพราะ PowerShell หรือ shell บางชนิดไม่แปลไวยากรณ์นี้เหมือนกัน หากเครื่องมีระบบจัดการซอฟต์แวร์ขององค์กร ให้ปฏิบัติตามวิธีอัปเดตที่ทีมดูแลกำหนด อย่าผสมการอัปเดตหลายวิธีโดยไม่ตรวจ path ของ gcloud ที่กำลังเรียก เพราะอาจมีทั้งชุดที่ติดตั้งจาก installer และจาก Homebrew อยู่ในเครื่องเดียวกัน

แผนตรวจสำหรับทีมที่มีเครื่องนักพัฒนาหลายเครื่อง

ทีม platform สามารถสำรวจ gcloud version และวิธีติดตั้งบนเครื่อง macOS ที่ใช้ build หรือ deploy จากนั้นแยกเครื่องที่เป็น 590.0.0/590.0.1 ออกจากเครื่องรุ่นอื่น หากเครื่องอยู่ในกลุ่มที่เสี่ยง ให้ลองอัปเดตตามวิธีปกติและตรวจ log ถ้าพบข้อความ warning ตรงกับประกาศจึงใช้คำสั่งเฉพาะครั้ง ไม่จำเป็นต้องรัน workaround บนทุกเครื่องแบบเหมารวม หลังแก้แล้วบันทึกเวอร์ชัน CLI, รายการ component ที่สำคัญ และผลของคำสั่งตรวจสิทธิ์หรือทรัพยากรที่ pipeline ใช้

CI/CD ที่บรรจุ CLI ใน image ควร pin หรือบันทึกเวอร์ชันที่ใช้เพื่อให้รู้ว่าคำสั่งอัปเดตอัตโนมัติเปลี่ยนสิ่งใด หาก pipeline ล้มหลังการอัปเดตให้แยกปัญหาการติดตั้ง CLI ออกจากปัญหาสิทธิ์หรือการเปลี่ยน API ของบริการ Google Cloud การทดสอบด้วยคำสั่งอ่านข้อมูลก่อนช่วยลดการรบกวน production ขณะที่ยังเห็นว่า authentication และ configuration ของ CLI ถูกต้อง

รุ่น 591 มีอะไรที่ควรรู้เพิ่ม

release notes ระบุว่า Google Cloud CLI รุ่น 591.0.0 อัปเดต Python ที่ bundled มาเป็น 3.14.9 และมีการเปลี่ยนกลุ่มคำสั่งหลายส่วน เช่น Agent Registry บางกลุ่มขึ้น GA และ flag ใหม่ของบริการต่าง ๆ ทีมที่มีสคริปต์พึ่งพา output หรือ environment ของ CLI ควรอ่านรายการเปลี่ยนแปลงเต็มก่อน rollout แม้ข่าวหลักของบทความนี้คือการแก้การอัปเดตบน macOS ก็ตาม โดยเฉพาะเครื่องที่ใช้ CLI ใน automation มากกว่าการสั่งงานด้วยมือ

สรุปสั้น ๆ: ตรวจเวอร์ชันก่อน ถ้าเป็น macOS 590.0.0 หรือ 590.0.1 และ gcloud components update หยุดหลัง warning เรื่อง Python modules จึงใช้ workaround ใน release notes จากนั้นยืนยันว่าเครื่องขึ้น 591.0.0 ขึ้นไป เครื่องรุ่นอื่นอัปเดตตามปกติ และเครื่องที่ใช้ package manager ให้ใช้ช่องทางอัปเดตของตนเอง วิธีนี้แก้เครื่องที่ติดรุ่นบั๊กโดยไม่เปลี่ยนขั้นตอนของเครื่องที่ไม่ได้รับผลกระทบ

แหล่งข่าว: Google Cloud CLI 591.0.0 release notes วันที่ 27 ตุลาคม 2026 และ เอกสารจัดการ gcloud components

Chia sẻ bài viết:
Xem thêm bài viết