พื้นที่เก็บ community-plugins เป็นสถานที่ที่สมาชิกของชุมชนสามารถโฮสต์ปลั๊กอินหรือชุดปลั๊กอินได้ เป้าหมายของปลั๊กอินชุมชนคือการลดจำนวนคำขอดึงและปัญหาจาก backstage/backstage ซึ่งใหญ่เกินไปตามเวลา
ด้วยการสร้างปลั๊กอินชุมชน เรามอบเครื่องมือทั้งหมดให้กับผู้ดูแลปลั๊กอินเพื่อจัดการและเผยแพร่ปลั๊กอินได้อย่างง่ายดาย
ปลั๊กอินที่สร้างโดยชุมชน Backstage ในวงกว้างสามารถเผยแพร่ในพื้นที่เก็บ community-plugins ได้ เมื่อคุณสนับสนุนปลั๊กอินในพื้นที่เก็บข้อมูลนี้ คุณตกลงที่จะปฏิบัติตามหลักเกณฑ์เฉพาะ รวมถึงกระบวนการเผยแพร่ที่เป็นมาตรฐาน ซึ่งช่วยให้เจ้าของปลั๊กอินสามารถใช้ประโยชน์จากกระบวนการที่สร้างขึ้นและความรู้โดยรวมของชุมชน community-plugins Backstage
สำหรับผู้ที่ต้องการความเป็นอิสระอย่างเต็มที่เหนือวงจรการพัฒนาและการเปิดตัวปลั๊กอิน การโฮสต์ด้วยตนเองยังคงเป็นตัวเลือกที่รองรับและใช้ได้จริง การตัดสินใจที่จะสนับสนุนพื้นที่เก็บข้อมูลของชุมชนหรือโฮสต์ด้วยตนเองจะขึ้นอยู่กับว่าคุณต้องการจัดการการพัฒนาปลั๊กอินอย่างอิสระหรือพัฒนาปลั๊กอินโดยเป็นส่วนหนึ่งของกระบวนการที่ขับเคลื่อนโดยชุมชน ทั้งสองแนวทางมีคุณค่าในระบบนิเวศของ Backstage และมีส่วนช่วยในการเติบโต
ปลั๊กอินที่เป็นกุญแจสำคัญในการทำงานและการทำงานของ Backstage จะยังคงอยู่ในพื้นที่เก็บข้อมูล backstage/backstage เพื่อให้มั่นใจว่าส่วนประกอบส่วนกลางที่สนับสนุนแพลตฟอร์มจะได้รับการจัดการและบำรุงรักษาจากส่วนกลาง
หากต้องการเริ่มต้นสร้างปลั๊กอินใหม่ ให้ทำตามคำแนะนำใน CONTRIBUTING.md
พื้นที่เก็บ community-plugins ถูกสร้างขึ้นโดยชุดของพื้นที่ทำงาน พื้นที่ทำงานเก็บปลั๊กอินหรือชุดปลั๊กอินตามหัวข้อเฉพาะ ตัวอย่างเช่น แค็ตตาล็อก kubernetes และ TechDocs สามารถเรียกได้ว่าเป็นพื้นที่ทำงาน
ปลั๊กอินแต่ละตัวเป็นของพื้นที่ทำงานและพื้นที่ทำงานสามารถพกพาได้เพียงพอที่จะย้ายไปยังที่เก็บของตัวเองได้หากต้องการ แต่ละพื้นที่ทำงานของปลั๊กอินมีชุดการแก้ไขและการเผยแพร่แยกกัน
ปลั๊กอินขึ้นอยู่กับปลั๊กอินอื่นๆ ผ่านการพึ่งพา npm ปกติ โดยไม่คำนึงว่าปลั๊กอินอื่นๆ จะเป็นปลั๊กอินหลัก ปลั๊กอินอื่นๆ ภายในพื้นที่เก็บข้อมูล หรือปลั๊กอินภายนอก
แม้ว่าพื้นที่เก็บข้อมูลชุมชนจะไม่ใช่พื้นที่ทำงานเส้นด้ายในทางเทคนิค" แต่ก็ทำหน้าที่เป็นพื้นที่เก็บข้อมูลที่มีพื้นที่ทำงานเส้นด้ายหลายพื้นที่ โดยแต่ละพื้นที่ทำงานมีไดเร็กทอรี . .changesets ที่เป็นเอกลักษณ์
เมื่อใดก็ตามที่มีการแนะนำเซ็ตการแก้ไขใหม่ PR "Version packages ($workspace_name)" ใหม่จะถูกสร้างขึ้น การรวมแพ็คเกจเวอร์ชัน PR จะทริกเกอร์การเปิดตัวปลั๊กอินทั้งหมดในพื้นที่ทำงาน (เพิ่มชุดการแก้ไขที่ให้มา) และยังอัปเดตไฟล์ CHANGELOG
backstage/backstage ปลั๊กอินจำนวนหนึ่งที่เดิมอยู่ใน monorepo backstage/backstage ได้ย้ายไปยังที่เก็บ backstage/community-plugins นี้
adrairbreakallureanalyticsapache-airflowapollo-explorerazure-devopsazure-sitesbadgesbazaarbitrisecicd-statisticscloudbuildcode-climatecode-coveragecodescenecost-insightsdynatraceentity-feedbackentity-validationexample-todo-listexplorefirehydrantfossagcalendargcp-projectsgit-release-managergithub-actionsgithub-deploymentsgithub-issuesgithub-pull-requests-boardgitops-profilesgocdgraphiqlgraphql-voyagerilertjenkinskafkalighthousemicrosoft-calendarnewrelicnewrelic-dashboardoctopus-deployopencostperiskopplaylistpuppetdbrollbarsentryshortcutssonarqubesplunkstack-overflowstackstormtech-insightstech-radartodovaultxcmetrics การย้ายปลั๊กอินจาก monorepo backstage/backstage ไปยังพื้นที่เก็บข้อมูล community-plugins เป็นไปโดยอัตโนมัติภายใต้เครื่องมือ community-cli
คุณระบุเส้นทางไปยัง monorepo ที่ควรโคลนในเครื่องและ ID ปลั๊กอิน จากนั้นจะสร้างพื้นที่ทำงานใหม่ในพื้นที่เก็บ community-plugins พร้อมปลั๊กอินและโมดูลทั้งหมดที่ล้อมรอบพื้นที่ทำงานนั้น ตัวอย่างเช่น หากฉันใช้ปลั๊กอิน todo เป็น ID มันจะย้ายไปยัง @backstage/plugin-todo โดยอัตโนมัติ เช่นเดียวกับ @backstage/plugin-todo-backend และ -common , -node หรือ -modules อื่นๆ ที่เกี่ยวข้อง
เมื่อคัดลอกโค้ดแล้ว ขอบเขต npm และการอ้างอิงโค้ดทั้งหมดจะได้รับการอัปเดตเพื่อให้สะท้อนถึงขอบเขตใหม่ของ @backstage-community/plugin-* และชุดการแก้ไขจะถูกสร้างขึ้นสำหรับแพ็คเกจที่จะเผยแพร่ เวอร์ชันต่างๆ จะถูกเก็บไว้เหมือนเดิมในตอนนี้ แต่ชุดการแก้ไขที่ได้จะเผยแพร่เวอร์ชันถัดไปไปด้วย ดังนั้นหากแพ็คเกจที่เปิดตัวที่ 1.25.0 คือ 0.10.0 เวอร์ชันใหม่จะเป็น @backstage-community/plugin-todo 0.10.1 .
มีคอมมิตที่สร้างขึ้นใน monorepo บนสาขาที่ระบุเป็น --branch หรือในสาขาใหม่ที่สร้างขึ้นสำหรับการย้ายข้อมูล ในคอมมิตนี้ถือเป็นการเลิกใช้แล้วและชุดการแก้ไขสำหรับแพ็คเกจนี้จะถูกยกเลิก ดังนั้น 0.10.1 ใน @backstage/plugin-todo จะถูกทำเครื่องหมายว่าเลิกใช้แล้วและแทนที่ด้วย @backstage-community/plugin-todo เป็นเวอร์ชันเดียวกัน
