install action

การติดตั้ง

การกระทำของ GitHub สำหรับการติดตั้งเครื่องมือพัฒนา (ส่วนใหญ่มาจาก GitHub ปล่อย)

• การใช้งาน
  • อินพุต
  • ตัวอย่างเวิร์กโฟลว์
• เครื่องมือที่รองรับ
  • เพิ่มการสนับสนุนสำหรับเครื่องมือใหม่
• ความปลอดภัย
• ความเข้ากันได้
• โครงการที่เกี่ยวข้อง
• ใบอนุญาต

การใช้งาน

อินพุต

ชื่อ	ที่จำเป็น	คำอธิบาย	พิมพ์	ค่าเริ่มต้น
เครื่องมือ	จริง	เครื่องมือในการติดตั้ง (รายการคั่นด้วยเครื่องหมายจุลภาค)	สาย
ตรวจสอบ	เท็จ	ไม่ว่าจะเปิดใช้งานการตรวจสอบ	บูลีน	true

ตัวอย่างเวิร์กโฟลว์

ในการติดตั้งเวอร์ชันล่าสุด:

- uses : taiki-e/install-action@v2
  with :
    tool : cargo-hack

คุณสามารถใช้ชวเลข (หากคุณไม่จำเป็นต้องตรึงเวอร์ชันของการกระทำนี้และเครื่องมือที่ติดตั้ง):

- uses : taiki-e/install-action@cargo-hack

ในการติดตั้งเวอร์ชันเฉพาะให้ใช้ @version syntax:

- uses : taiki-e/install-action@v2
  with :
    tool : [email protected]

คุณยังสามารถละเว้นเวอร์ชันแพทช์ (คุณสามารถละเว้นรุ่นรองได้หากเวอร์ชันหลักคือ 1 หรือมากกว่า)

- uses : taiki-e/install-action@v2
  with :
    tool : [email protected]

ในการติดตั้งเครื่องมือหลายอย่าง:

- uses : taiki-e/install-action@v2
  with :
    tool : cargo-hack,cargo-minimal-versions

หรือ:

- uses : taiki-e/install-action@cargo-hack
- uses : taiki-e/install-action@cargo-minimal-versions 

เครื่องมือที่รองรับ

ดูเครื่องมือ MD สำหรับรายการเครื่องมือที่ติดตั้งจากรายการที่มีการจัดการในการดำเนินการนี้

หากมีการระบุเครื่องมือที่ไม่รวมอยู่ในรายการด้านบนการดำเนินการนี้จะใช้การติดตั้งค่าขนส่งสินค้าเป็นทางเลือก

หากคุณต้องการให้แน่ใจว่าไม่ได้ใช้ทางเลือกให้ใช้ fallback: none

- uses : taiki-e/install-action@v2
  with :
    tool : cargo-hack
    # Possible values:
    # - none: disable all fallback
    # - cargo-binstall (default): cargo-binstall (includes quickinstall)
    fallback : none

เพิ่มการสนับสนุนสำหรับเครื่องมือใหม่

ดูคู่มือการพัฒนาสำหรับวิธีเพิ่มการสนับสนุนสำหรับเครื่องมือใหม่

ความปลอดภัย

เมื่อติดตั้งเครื่องมือจาก GitHub รุ่นการดำเนินการนี้จะดาวน์โหลดเครื่องมือหรือตัวติดตั้งจาก GitHub โดยใช้ HTTPS ด้วย TLSV1.2+ โดยทั่วไปถือว่าเป็นระดับความปลอดภัยในระดับเดียวกับการติดตั้ง Rustup ที่แนะนำ

นอกจากนี้การดำเนินการนี้จะตรวจสอบ SHA256 Checksums สำหรับไฟล์ที่ดาวน์โหลดในเครื่องมือทั้งหมดที่ติดตั้งจาก GitHub รุ่น สิ่งนี้เปิดใช้งานโดยค่าเริ่มต้นและสามารถปิดใช้งานได้โดยการตั้งค่าตัวเลือกการป้อนข้อมูล checksum เป็น false

นอกจากนี้เรายังตรวจสอบลายเซ็นหากเครื่องมือแจกจ่ายเอกสารสำคัญที่ลงนาม การตรวจสอบลายเซ็นจะดำเนินการในขั้นตอนของการตรวจสอบดังนั้นการปิดการใช้งานการตรวจสอบจะปิดใช้งานการตรวจสอบลายเซ็น

ดูเอกสารที่เชื่อมโยงสำหรับข้อมูลเกี่ยวกับความปลอดภัยเมื่อติดตั้งโดยใช้ SNAP หรือการติดตั้งค่าขนส่งสินค้า

ดูส่วนเครื่องมือที่รองรับสำหรับวิธีการตรวจสอบให้แน่ใจว่าไม่ได้ใช้ทางเลือก

ความเข้ากันได้

การกระทำนี้ได้รับการทดสอบสำหรับนักวิ่งที่โฮสต์ GitHub (Ubuntu, MacOS, Windows) และคอนเทนเนอร์ (Ubuntu, Debian, Fedora, Centos, Alma, OpenSuse, Arch, Alpine)

บน Linux หากเครื่องมือที่จำเป็นหายไปการกระทำนี้จะพยายามติดตั้งจากผู้จัดการแพ็คเกจของ Distro EOL อยู่แล้วและจำเป็นต้องใช้ repos vault/เก็บถาวร - ดู "การติดตั้งข้อกำหนด" ในการกำหนดค่า CI ของเราสำหรับตัวอย่างการตั้งค่า)

บนแพลตฟอร์มอื่น ๆ อย่างน้อยจำเป็นต้องใช้เครื่องมือต่อไปนี้:

• ทุบตี 3.2+
• JQ 1.3+
• Curl 7.34+ (หรือ Rhel7/Centos7 ของ Curl 7.29)

สภาพแวดล้อมที่เป็นที่รู้จักที่ได้รับผลกระทบจากข้อกำหนดของเวอร์ชันข้างต้นคือ CentOS 6 (EOL ในปี 2020-11) โดยใช้ Curl 7.19 และ Ubuntu 12.04 (EOL ใน 2017-04) โดยใช้ Curl 7.22 (ดู "ข้อกำหนดการติดตั้ง" ใน CI ของเรา .

โครงการที่เกี่ยวข้อง

• Cache-cargo-install-action: การกระทำของ GitHub สำหรับ cargo install ด้วยแคช
• Create-GH-REALEASE-ACTION: การกระทำของ GitHub สำหรับการสร้าง GitHub ปล่อยตามการเปลี่ยนแปลง
• อัพโหลด-Rust-Binary-Action: การกระทำของ GitHub สำหรับการสร้างและอัปโหลดไบนารีสนิมไปยัง GitHub
• Setup-Cross-Toolchain-Action: GitHub Action สำหรับการตั้งค่าเครื่องมือสำหรับการรวบรวมข้ามและการทดสอบข้ามสำหรับการเกิดสนิม
• Checkout-Action: การกระทำของ GitHub สำหรับการตรวจสอบที่เก็บ (ทางเลือกการกระทำ/การชำระเงินที่ง่ายขึ้นซึ่งไม่ได้ขึ้นอยู่กับ Node.js. )

ใบอนุญาต

ได้รับใบอนุญาตภายใต้ใบอนุญาต Apache ทั้งรุ่น 2.0 หรือ MIT ใบอนุญาตของคุณที่ตัวเลือกของคุณ

เครื่องมือแต่ละตัวที่ติดตั้งโดยการกระทำนี้มีใบอนุญาตที่แตกต่างกัน ดูส่วนเครื่องมือที่รองรับสำหรับข้อมูลเพิ่มเติม

หากคุณไม่ได้ระบุอย่างชัดเจนการบริจาคใด ๆ ที่ส่งโดยเจตนาเพื่อรวมไว้ในงานโดยคุณตามที่กำหนดไว้ในใบอนุญาต Apache-2.0 จะได้รับใบอนุญาตคู่ดังกล่าวข้างต้นโดยไม่มีข้อกำหนดหรือเงื่อนไขเพิ่มเติมใด ๆ