เริ่มต้นใช้งาน Checks CLI

CLI ของ Checks จะนำฟังก์ชันการทำงานของ Checks มาไว้ในเวิร์กโฟลว์การพัฒนา ของคุณ คุณสามารถเรียกใช้ CLI ได้ในเครื่อง ในไปป์ไลน์ CI/CD หรือผ่านสคริปต์และการทำงานอัตโนมัติประเภทอื่นๆ

การตั้งค่าและการใช้ Checks CLI ต้องทำตามขั้นตอนต่อไปนี้

  1. ติดตั้ง Checks CLI
  2. ตรวจสอบสิทธิ์เครื่อง
  3. ผสานรวมและใช้ CLI ของการตรวจสอบโดยการเรียกใช้คำสั่งจากบรรทัดคำสั่งหรือผสานรวม CLI ของการตรวจสอบเข้ากับสภาพแวดล้อม CI/CD

ตั้งค่า Checks CLI

คุณติดตั้งหรืออัปเดต Checks CLI ได้โดยใช้ไฟล์ปฏิบัติการแบบสแตนด์อโลนในตารางสำหรับ Linux หรือ macOS

หลังจากติดตั้ง Checks CLI แล้ว คุณต้องตรวจสอบสิทธิ์ จากนั้นคุณจะเริ่มทดสอบและแก้ไขช่องโหว่ได้ โดยเริ่มจากการทดสอบการติดตั้ง

ติดตั้งด้วยไฟล์ปฏิบัติการแบบสแตนด์อโลน

Checks มีลิงก์ดาวน์โหลดไฟล์ปฏิบัติการแบบสแตนด์อโลนสำหรับรุ่นล่าสุดและ สำหรับเวอร์ชันที่เฉพาะเจาะจง ตัวอย่างเช่น ลิงก์ต่อไปนี้เป็นลิงก์สำหรับ macOS และ Linux

เช่น หากต้องการดาวน์โหลดและเรียกใช้ Checks CLI เวอร์ชันล่าสุดใน macOS ให้เรียกใช้คำสั่งต่อไปนี้

curl --compressed https://dl.google.com/checks/cli/latest/checks-macos -o checks
chmod +x ./checks
mv ./checks /usr/local/bin/
  1. ตรวจสอบว่าคุณได้ติดตั้งตัวจัดการแพ็กเกจและเครื่องมือของบุคคลที่สามที่จำเป็นแล้ว
  2. ดาวน์โหลดไบนารี CLI ของการตรวจสอบสำหรับแพลตฟอร์มของคุณ

Linux

แพลตฟอร์ม

แพ็กเกจ

ขนาด

ผลรวมตรวจสอบ SHA256

Linux

checks-linux

35.1 MB

cc12317c0d5b0a2edfe8d5bf28a3a0739d5bd469ccd771772bf65129ae97c94f

ทำให้ไบนารีเรียกใช้งานได้โดยเรียกใช้ chmod +x ./checks (ไม่บังคับ) ย้าย ไบนารีไปยังตำแหน่งที่คุณเรียกใช้ได้ทั่วโลก: mv ./checks /usr/local/bin/

macOS

แพลตฟอร์ม

แพ็กเกจ

ขนาด

ผลรวมตรวจสอบ SHA256

macOS

checks-macos

29.4 MB

a82699336aaf0f6b0a9502c293c84be45459d79d348a74eae3bbaaf89d1daa33

ทำให้ไบนารีเรียกใช้งานได้โดยการเรียกใช้ chmod +x ./checks (ไม่บังคับ) ย้าย ไบนารีไปยังตำแหน่งที่คุณเรียกใช้งานได้ทั่วโลก mv ./checks /usr/local/bin/

Windows

แพลตฟอร์ม

แพ็กเกจ

ขนาด

ผลรวมตรวจสอบ SHA256

Windows 8.1 ขึ้นไปและ Windows Server 2012 ขึ้นไป

checks-win.exe

29.5 MB

7ca465e28ffec9a7e16bc71e01bbaf9629c95d517e5846a31280a49af400d3c7

(ไม่บังคับ) เปลี่ยนชื่อไฟล์เป็น checks.exe เพื่อให้คุณเรียกใช้คำสั่งตรวจสอบได้ ตามที่ระบุไว้ เช่น checks help

อัปเดตเป็น CLI เวอร์ชันล่าสุด

เราขอแนะนำให้คุณ ตรวจสอบการอัปเดต CLI บ่อยๆ เพื่อให้มั่นใจว่าคุณจะได้รับฟีเจอร์ใหม่ล่าสุดและการแก้ไขข้อบกพร่อง

คุณสามารถดาวน์โหลดเวอร์ชันใหม่จากตารางก่อนหน้า แล้วแทนที่เวอร์ชันก่อนหน้าในระบบ

ทดสอบการติดตั้ง

หลังจากตรวจสอบสิทธิ์แล้ว คุณจะทดสอบการติดตั้งได้ หากต้องการทดสอบอย่างรวดเร็ว ให้เรียกใช้ checks --help

ข้อมูลเพิ่มเติม

เรียกใช้ checks --help หรือดูสรุปคำสั่งและตัวเลือก CLI

การขอรับความช่วยเหลือ

ส่งอีเมลไปที่ checks-support@google.com เมื่อใดก็ตามที่คุณต้องการความช่วยเหลือเกี่ยวกับ Checks CLI หรือ Checks โดยทั่วไป

ตรวจสอบสิทธิ์ CLI

หลังจากติดตั้ง CLI แล้ว คุณต้องลงชื่อเข้าใช้บัญชี Google หากต้องการให้สิทธิ์การเข้าถึงการตรวจสอบแก่ Checks CLI ให้ใช้บัญชีบริการหรือบัญชีผู้ใช้

บัญชีบริการคือบัญชี Google Cloud ที่เชื่อมโยงกับโปรเจ็กต์ Google Cloud ของคุณ ไม่ใช่ผู้ใช้ที่เฉพาะเจาะจง บัญชีบริการมีประโยชน์ในการตั้งค่า การตรวจสอบในสภาพแวดล้อม CI

บัญชีผู้ใช้คือบัญชี Google ที่มีสิทธิ์เข้าถึงบัญชี Checks ของคุณ นี่เป็นตัวเลือกที่ดีที่สุดสำหรับการใช้ CLI ของ Checks จากบรรทัดคำสั่ง

ตรวจสอบสิทธิ์ด้วยบัญชีบริการ

  1. เปิด Google Cloud Console แล้วเลือกโปรเจ็กต์
  2. เปิดใช้ Checks API ในไลบรารี API
  3. สร้างบัญชีบริการสำหรับโปรเจ็กต์โดยไปที่หน้าบัญชีบริการ IAM ใน Google Cloud Console คลิกสร้างบัญชีบริการ แล้วป้อนรายละเอียดบัญชีบริการ
    1. สร้างคีย์ JSON ส่วนตัวสำหรับบัญชีบริการที่สร้างขึ้นใหม่ แล้ว ย้ายคีย์ไปยังตำแหน่งที่สภาพแวดล้อมการสร้างเข้าถึงได้ โปรดเก็บไฟล์นี้ไว้ในที่ที่ปลอดภัย เนื่องจากไฟล์นี้จะให้สิทธิ์ผู้ดูแลระบบ ในการเข้าถึงการตรวจสอบ
    2. ตั้งค่าตัวแปรสภาพแวดล้อม CHECKS_CREDENTIALS เป็นเส้นทางของไฟล์ JSON คีย์ส่วนตัว เมื่อใช้ CLI หากใช้ปลั๊กอิน Checks CI/CD โปรดดูเอกสารประกอบของปลั๊กอินเพื่อดูวิธีระบุข้อมูล เข้าสู่ระบบ
  4. หากต้องการให้สิทธิ์เข้าถึงบัญชี Checks แก่บัญชีบริการ ให้เพิ่มอีเมล และมอบบทบาทเจ้าของในหน้าการตั้งค่าคอนโซล Checks ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชิญผู้ใช้ให้เข้าร่วมบัญชี Checks ได้ที่การจัดการ สิทธิ์เข้าถึงของทีม

ตรวจสอบสิทธิ์ด้วยบัญชีผู้ใช้

สำคัญ: หากเชื่อมต่อผ่าน SSH ให้ส่งต่อพอร์ต 9005

  1. ลงชื่อเข้าใช้ Checks CLI โดยใช้บัญชี Google ด้วยคำสั่งต่อไปนี้ checks login

    คำสั่งนี้จะเชื่อมต่อเครื่องของคุณกับ Checks และให้สิทธิ์เข้าถึงบัญชี Checks ของคุณ

    • ใช้ checks login --reauth หากคุณเคยลงชื่อเข้าใช้มาก่อน แต่ต้องการ เปลี่ยนไปใช้บัญชี Google อื่น
    • ใช้ checks logout เพื่อออกจากระบบ

  2. เปิด URL การตรวจสอบสิทธิ์ที่สร้างขึ้นในเบราว์เซอร์

  3. ลงชื่อเข้าใช้บัญชี Google

  4. ให้ความยินยอมแก่ Checks ในการเข้าถึงบัญชี Checks ของคุณ