การดำเนินการเผยแพร่อัตโนมัติ

GitHub เผยแพร่อัตโนมัติ

การดำเนินการนี้ทำให้กระบวนการเผยแพร่ GitHub ง่ายขึ้นโดยการอัปโหลดเนื้อหาโดยอัตโนมัติ การสร้างบันทึกการเปลี่ยนแปลง การจัดการรุ่นก่อนเผยแพร่ และอื่นๆ

สารบัญ

1. ตัวอย่างการใช้งาน
2. พารามิเตอร์ที่รองรับ
3. ทริกเกอร์เหตุการณ์
4. การกำหนดเวอร์ชัน
5. จะขอความช่วยเหลือได้อย่างไร
6. ใบอนุญาต

หมายเหตุ : พื้นที่เก็บข้อมูล marvinpinto/action-automatic-releases เป็นมิเรอร์ที่สร้างขึ้นโดยอัตโนมัติของ marvinpinto/actions monorepo ที่มีการดำเนินการนี้และการดำเนินการอื่น ๆ กรุณายื่นประเด็นและดึงคำขอไปที่นั่น

ตัวอย่างการใช้งาน

สร้างเวอร์ชันก่อนเผยแพร่โดยอัตโนมัติเมื่อมีการเปลี่ยนแปลงบนต้นแบบ

เวิร์กโฟลว์ตัวอย่างนี้จะเริ่มทำงานทันทีที่การเปลี่ยนแปลงมาถึงบน master หลังจากทำตามขั้นตอนเพื่อสร้างและทดสอบโปรเจ็กต์ของคุณแล้ว:

1. มันจะสร้าง (หรือแทนที่) แท็ก git ที่เรียกว่า latest
2. สร้างบันทึกการเปลี่ยนแปลงจากการกระทำทั้งหมดระหว่างสิ่งนี้กับแท็ก latest ก่อนหน้า
3. สร้างรุ่นใหม่ที่เกี่ยวข้องกับแท็ก latest (ลบรุ่นที่เกี่ยวข้องก่อนหน้านี้)
4. อัปเดตรุ่นใหม่นี้ด้วยชื่อที่ระบุ (เช่น Development Build )
5. อัปโหลด LICENSE.txt และไฟล์ jar ใดๆ เป็นเนื้อหาที่เผยแพร่
6. ทำเครื่องหมายรุ่นนี้เป็น pre-release

คุณสามารถดูตัวอย่างการทำงานของเวิร์กโฟลว์นี้ได้ที่ marvinpinto/actions

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

สร้าง GitHub ใหม่เมื่อมีการพุชแท็กไปยังที่เก็บ

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

1. สร้างบันทึกการเปลี่ยนแปลงจากการกระทำทั้งหมดระหว่างแท็กนี้กับแท็กที่ดูเป็นเซมเวอร์ก่อนหน้า
2. สร้างรุ่นใหม่และเชื่อมโยงกับแท็กนี้
3. อัปโหลด LICENSE.txt และไฟล์ jar ใดๆ เป็นเนื้อหาที่เผยแพร่

มีตัวอย่างเรื่องนี้อีกครั้งที่ marvinpinto/actions

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

พารามิเตอร์ที่รองรับ

พารามิเตอร์	คำอธิบาย	ค่าเริ่มต้น
repo_token **	โทเค็นการดำเนินการ GitHub เช่น "${{ secrets.GITHUB_TOKEN }}"	null
draft	ทำเครื่องหมายรุ่นนี้ว่าเป็นฉบับร่างใช่ไหม	false
prerelease	ทำเครื่องหมายรุ่นนี้ว่าเป็นรุ่นก่อนเผยแพร่ใช่ไหม	true
automatic_release_tag	ชื่อแท็กที่จะใช้สำหรับการเผยแพร่อัตโนมัติ เช่น latest	null
title	ชื่อที่วางจำหน่าย; ค่าเริ่มต้นเป็นชื่อแท็กหากไม่มีการระบุ	ชื่อแท็ก
files	ไฟล์ที่จะอัปโหลดโดยเป็นส่วนหนึ่งของเนื้อหาที่เผยแพร่	null

เอาท์พุต

ค่าเอาต์พุตต่อไปนี้สามารถเข้าถึงได้ผ่าน ${{ steps..outputs. }} :

ชื่อ	คำอธิบาย	พิมพ์
automatic_releases_tag	แท็กปล่อยการกระทำนี้เพิ่งประมวลผล	เชือก
upload_url	URL สำหรับการอัปโหลดเนื้อหาเพิ่มเติมเพื่อเผยแพร่	เชือก

หมายเหตุ:

• จำเป็นต้องมีพารามิเตอร์ที่แสดงด้วย **
• พารามิเตอร์ files รองรับรูปแบบ glob หลายบรรทัด ดูตัวอย่างพื้นที่เก็บข้อมูล

ทริกเกอร์เหตุการณ์

เฟรมเวิร์ก GitHub Actions ช่วยให้คุณสามารถทริกเกอร์การดำเนินการนี้ (และอื่นๆ) กับเหตุการณ์ ต่างๆ มากมาย ตัวอย่างเช่น คุณสามารถสร้างเวอร์ชันก่อนเผยแพร่เฉพาะสำหรับแท็กตัวเลือกการเผยแพร่ (เช่น *-rc* ) สร้างการเผยแพร่เมื่อการเปลี่ยนแปลงเข้าสู่หลัก (ตัวอย่างด้านบน) การเผยแพร่ทุกคืน และอื่นๆ อีกมากมาย อ่านไวยากรณ์เวิร์กโฟลว์สำหรับ GitHub Actions เพื่อดูแนวคิดและตัวอย่างขั้นสูง

การกำหนดเวอร์ชัน

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

"">

- uses : " marvinpinto/action-automatic-releases@ " 

จะขอความช่วยเหลือได้อย่างไร

README หลักสำหรับโปรเจ็กต์นี้มีข้อมูลมากมายที่เกี่ยวข้องกับปัญหาการดีบักและการส่ง หากคุณยังคงติดขัดอยู่ ลองติดต่อฉันที่คีย์เบส แล้วฉันจะพยายามช่วยเหลือคุณอย่างเต็มที่

ใบอนุญาต

ซอร์สโค้ดสำหรับโครงการนี้เผยแพร่ภายใต้ใบอนุญาต MIT โครงการนี้ไม่เกี่ยวข้องกับ GitHub