ลบและคืนค่าแพคเกจ

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

การทําความเข้าใจเกี่ยวกับสิทธิ์การลบ

คุณสามารถ ลบแพ็คเกจ ออกจาก GitHub ได้หากคุณมีสิทธิ์ การเข้าถึงที่จําเป็น:

สิ่งที่ลบได้

แพ็คเกจส่วนตัว:

• แพ็คเกจส่วนตัวทั้งหมด: ลบทุกเวอร์ชันพร้อมกัน
• รุ่นเฉพาะ: เลือกเอาแต่ละเวอร์ชันออก

แพ็คเกจสาธารณะ (มีข้อจํากัด):

• แพ็คเกจสาธารณะทั้งหมด: เฉพาะในกรณีที่มีการดาวน์โหลดเวอร์ชันใดก็ได้ไม่เกิน 5,000 ครั้ง
• รุ่นเฉพาะ: เฉพาะในกรณีที่เวอร์ชันนั้นมีการ ดาวน์โหลดไม่เกิน 5,000 ครั้ง

จำเป็นต้องมีสิทธิ์

แพ็กเกจขอบเขตที่เก็บ:

• สิทธิ์ของผู้ดูแลระบบ: คุณต้องมีสิทธิ์การเข้าถึงระดับผู้ดูแลระบบไปยังที่เก็บที่เป็นเจ้าของแพคเกจ
• สิทธิ์ที่สืบทอดมา: สิทธิ์ของแพคเกจเป็นไปตามการควบคุมการเข้าถึงที่เก็บ

แพคเกจที่กําหนดขอบเขตผู้ใช้หรือองค์กร (รีจิสทรีคอนเทนเนอร์):

• บทบาทผู้ดูแลระบบแพ็กเกจ: การเข้าถึงแพ็คเกจของผู้ดูแลระบบโดยตรง
• เจ้าขององค์กร: เข้าถึงแพ็คเกจองค์กรทั้งหมดได้อย่างเต็มที่

ข้อกําหนดในการฟื้นฟู

คุณสามารถ กู้คืนแพ็กเกจที่ถูกลบ ได้ภายใต้เงื่อนไขเฉพาะ:

เงื่อนไขการฟื้นฟู

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

เมื่อไม่สามารถกู้คืนได้ ให้ทําดังนี้

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

การใช้ REST API

คุณสามารถใช้ GitHub REST API เพื่อจัดการแพ็คเกจ โดยทางโปรแกรม ได้:

ความสามารถของ API:

• รายการแพ็คเกจ: รับแพ็คเกจทั้งหมดสําหรับผู้ใช้หรือองค์กร
• ดูรายละเอียดแพ็กเกจ: ดึงข้อมูลเมตาสําหรับแพ็คเกจเฉพาะ
• ลบเวอร์ชันแพ็คเกจ: ลบเวอร์ชันที่ระบุ
• ลบแพ็กเกจทั้งหมด: ลบทุกเวอร์ชัน
• กู้คืนเวอร์ชันแพ็คเกจ: กู้คืนเวอร์ชันที่ถูกลบ
• แสดงรายการเวอร์ชันแพ็คเกจ: ดูเวอร์ชันที่มีทั้งหมด

สําหรับข้อมูลเพิ่มเติม โปรดดู GitHub Packages API

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

ลบเวอร์ชันแพ็กเกจ:

curl -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.github.com/user/packages/npm/PACKAGE_NAME/versions/VERSION_ID

คืนค่าเวอร์ชันแพ็คเกจ:

curl -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.github.com/user/packages/npm/PACKAGE_NAME/versions/VERSION_ID/restore

การลบเวอร์ชันแพคเกจ

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

ตัวเลือกขอบเขตการลบ

เวอร์ชันแพ็คเกจสามารถลบได้ในขอบเขตต่างๆ:

• แพ็คเกจขอบเขตที่เก็บบน GitHub: ใช้เว็บอินเตอร์เฟสสําหรับแพ็คเกจที่เชื่อมโยงกับที่เก็บ
• แพ็คเกจขอบเขตที่เก็บด้วย GraphQL: ใช้ API สําหรับการลบแบบเป็นโปรแกรม
• แพ็คเกจขอบเขตผู้ใช้บน GitHub: ลบออกจากบัญชีส่วนตัวของคุณ
• แพ็คเกจขอบเขตองค์กรบน GitHub: ลบออกจากแพคเกจขององค์กร

การลบผ่าน web อินเตอร์เฟซ

เมื่อต้องการลบเวอร์ชันของ แพคเกจขอบเขตที่เก็บ:

ขั้นตอนที่ 1: ไปที่แพ็คเกจ

1. เมื่อ GitHub.com ให้ไปที่ หน้าหลักของ ที่เก็บ
2. ทางด้านขวาของรายการไฟล์ ให้คลิก แพ็กเกจ
3. ค้นหาและ เลือกแพ็กเกจของคุณ

ขั้นตอนที่ 2: เข้าถึงการจัดการเวอร์ชัน

1. ที่ด้านขวาบนของหน้า Landing Page ของแพ็กเกจ ให้คลิก การตั้งค่าแพ็กเกจ
2. ที่แถบด้านข้างด้านซ้าย ให้คลิก จัดการเวอร์ชัน

ขั้นตอนที่ 3: ลบเวอร์ชัน

1. ทางด้านขวาของเวอร์ชันที่ต้องการลบ ให้คลิกเมนู ⋯ แล้วเลือก "ลบเวอร์ชัน"
2. หากต้องการยืนยันการลบ ให้พิมพ์ ชื่อแพ็คเกจ แล้วคลิก ฉันเข้าใจผลที่ตามมา ลบเวอร์ชันนี้

แนวทางปฏิบัติที่ดีที่สุดสําหรับการลบเวอร์ชัน

ก่อนลบเวอร์ชัน:

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

การลบทั้งแพคเกจ

คุณสามารถลบ เวอร์ชัน ทั้งหมดของแพ็คเกจพร้อมกันได้ การดําเนินการนี้จะลบแพ็คเกจออกจากแพ็คเกจ GitHub โดยสิ้นเชิง

ตัวเลือกขอบเขตการลบ

แพ็คเกจทั้งหมดสามารถลบได้ในขอบเขตที่แตกต่างกัน:

• แพ็คเกจขอบเขตที่เก็บบน GitHub: ลบออกจากแพคเกจที่เก็บ
• แพ็คเกจขอบเขตผู้ใช้บน GitHub: ลบออกจากบัญชีส่วนตัว
• แพ็คเกจขอบเขตองค์กรบน GitHub: ลบออกจากแพคเกจขององค์กร

การลบผ่าน web อินเตอร์เฟซ

หากต้องการลบ แพ็กเกจที่มีขอบเขตที่เก็บทั้งหมด:

ขั้นตอนที่ 1: ไปที่แพ็คเกจ

1. เมื่อ GitHub.com ให้ไปที่ หน้าหลักของ ที่เก็บ
2. ทางด้านขวาของรายการไฟล์ ให้คลิก แพ็กเกจ
3. ค้นหาและ เลือกแพ็กเกจของคุณ

ขั้นตอนที่ 2: เข้าถึงการตั้งค่าแพ็กเกจ

1. ที่ด้านขวาบนของหน้า Landing Page ของแพ็กเกจ ให้คลิก การตั้งค่าแพ็กเกจ

ขั้นตอนที่ 3: ลบแพ็กเกจ

1. เลื่อนลงไปที่ส่วนโซนอันตราย
2. คลิก ลบแพ็กเกจนี้
3. ตรวจสอบข้อความยืนยันอย่างละเอียด
4. กรอก ชื่อแพ็กเกจ ของคุณเพื่อยืนยัน
5. คลิก ฉันเข้าใจ ลบแพ็กเกจนี้

เมื่อใดที่ควรลบแพ็กเกจทั้งหมด

สถานการณ์ที่เหมาะสม:

• โครงการที่ถูกทิ้งร้าง: แพ็คเกจไม่ได้รับการบํารุงรักษาหรือจําเป็นอีกต่อไป
• แทนที่ด้วยทางเลือกอื่น: แพ็กเกจใหม่แทนที่แพ็กเกจเก่า
• ปัญหาด้านความปลอดภัย: แพ็คเกจมีช่องโหว่ที่แก้ไขไม่ได้
• ข้อกําหนดการปฏิบัติตามข้อกําหนด: เหตุผลทางกฎหมายหรือข้อบังคับ
• ที่เก็บไม่ถูกต้อง: แพคเกจถูกเผยแพร่ไปยังตําแหน่งที่ไม่ถูกต้อง

ทางเลือกในการลบ:

• ประกาศการเลิกใช้งาน: ทําเครื่องหมายแพ็คเกจว่าเลิกใช้แล้วโดยไม่ลบ
• ที่เก็บถาวร: รักษาบรรจุภัณฑ์ แต่ส่งสัญญาณการหมดอายุการใช้งาน
• ทัศนวิสัยส่วนตัว: เปลี่ยนเป็นส่วนตัวแทนการลบ
• การอัปเดตเอกสาร: เพิ่มคําเตือนเกี่ยวกับการไม่ใช้แพ็กเกจ

การคืนค่าเวอร์ชันแพคเกจ

คุณสามารถกู้คืนแพ็กเกจที่ถูกลบได้ภายในกรอบเวลาการกู้คืน 30 วัน วิธีนี้ช่วยให้คุณสามารถกู้คืนจากการลบโดยไม่ได้ตั้งใจ

ขั้นตอนการฟื้นฟู

เมื่อต้องการคืนค่า เวอร์ชันแพ็กเกจที่ถูกลบ:

ขั้นตอนที่ 1: ไปที่แพ็คเกจ

1. ไปที่ หน้า Landing Page ของพัสดุของคุณ
2. ทางด้านขวา ให้คลิก การตั้งค่าแพ็กเกจ

ขั้นตอนที่ 2: ค้นหาเวอร์ชันที่ถูกลบ

1. ที่แถบด้านข้างด้านซ้าย ให้คลิก จัดการเวอร์ชัน
2. ใช้เมนูดรอปดาวน์ เวอร์ชัน ที่ด้านขวาบน
3. เลือก ลบ เพื่อแสดงเฉพาะเวอร์ชันที่ถูกลบ

ขั้นตอนที่ 3: กู้คืนเวอร์ชัน

1. ถัดจากเวอร์ชันแพ็กเกจที่ถูกลบที่คุณต้องการกู้คืน ให้คลิก กู้คืน
2. เพื่อยืนยัน ให้คลิก ฉันเข้าใจผลที่ตามมา กู้คืนเวอร์ชันนี้

สถานการณ์การฟื้นฟู

กรณีการใช้งานการกู้คืนทั่วไป:

• การลบโดยไม่ได้ตั้งใจ: กู้คืนเวอร์ชันที่ถูกลบโดยไม่ได้ตั้งใจ
• การกู้คืนการพึ่งพา: ผู้บริโภคต้องการเวอร์ชันที่ถูกลบไปก่อนหน้านี้
• การตัดสินใจย้อนกลับ: ตัดสินใจที่จะไม่ลบเวอร์ชันหลังจากทั้งหมด
• วัตถุประสงค์ในการทดสอบ: ต้องการเวอร์ชันเก่าสําหรับการทดสอบเปรียบเทียบ
• ข้อกําหนดการปฏิบัติตามข้อกําหนด: ต้องเก็บเวอร์ชันในอดีตไว้

ขั้นตอนหลังการกู้คืน

หลังจากกู้คืนแพ็คเกจ:

1. ตรวจสอบฟังก์ชันการทํางาน: ทดสอบว่าแพ็คเกจที่กู้คืนทํางานอย่างถูกต้อง
2. อัปเดตเอกสารประกอบ: เพิ่มบันทึกเกี่ยวกับการลบและการกู้คืน
3. แจ้งผู้บริโภค: แจ้งให้ผู้ใช้ทราบว่าแพ็คเกจพร้อมใช้งานอีกครั้ง
4. ตรวจสอบสิทธิ์: ตรวจสอบให้แน่ใจว่าการควบคุมการเข้าถึงยังคงเหมาะสม
5. พิจารณาทางเลือกอื่น: ประเมินว่าการลบเป็นแนวทางที่ถูกต้องหรือไม่

การจัดการวงจรชีวิตของแพ็คเกจ

แนวทางปฏิบัติที่ดีที่สุดสําหรับการจัดการแพ็คเกจ:

• การเลิกใช้งานก่อน: ทําเครื่องหมายเวอร์ชันว่าเลิกใช้แล้วก่อนลบ
• แผนการสื่อสาร: แจ้งให้ผู้บริโภคทราบล่วงหน้า
• ระยะเวลาผ่อนผัน: ให้เวลาผู้บริโภคในการย้ายข้อมูล
• การเก็บรักษาเวอร์ชัน: เก็บเวอร์ชันขั้นต่ําที่ใช้งานได้
• เส้นทางการตรวจสอบ: บันทึกการตัดสินใจลบทั้งหมด
• การล้างข้อมูลอัตโนมัติ: ใช้นโยบายเพื่อลบเวอร์ชันเก่าอย่างเป็นระบบ

แหล่งข้อมูลเพิ่มเติม

สําหรับข้อมูลเพิ่มเติม โปรดดู:

• การลบและการกู้คืนแพ็คเกจ - GitHub Docs - คู่มือการลบและการกู้คืนฉบับสมบูรณ์
• การทํางานกับรีจิสทรีแพคเกจ GitHub - การดําเนินการเฉพาะรีจิสทรี
• การทํางานกับรีจิสทรี NuGet - ขั้นตอนการลบเฉพาะ NuGet
• การทํางานกับรีจิสทรี npm - ขั้นตอนการลบเฉพาะ npm
• สิทธิ์ที่จําเป็น - การทําความเข้าใจข้อกําหนดสิทธิ์สําหรับการดําเนินการแพคเกจ