ຈຸດປະສົງຂອງການກວດສອບ

ເພື່ອໃຫ້ຮູບພາບຄອນເທນເນີແບບຊັ້ນ (Container Layered Image) ໃໝ່ຖືກເພີ່ມເຂົ້າໃນ Fedora, ຮູບພາບຄອນເທນເນີນັ້ນຕ້ອງຜ່ານການກວດສອບຢ່າງເປັນທາງການ ຄືກັນກັບ ຂະບວນການກວດສອບແພັກເກດ RPM.

ຈຸດປະສົງຂອງການກວດສອບຢ່າງເປັນທາງການນີ້ ແມ່ນເພື່ອຮັບປະກັນວ່າ ຮູບພາບຄອນເທນເນີແບບຊັ້ນ ເປັນໄປຕາມຂໍ້ກຳນົດການຄວບຄຸມຄຸນນະພາບຂອງ Fedora.

ປະຈຸບັນ ການກວດສອບແມ່ນເຮັດສຳລັບຮູບພາບຄອນເທນເນີແບບຊັ້ນໃໝ່ທັງໝົດ, ການປ່ຽນຊື່ຮູບພາບຄອນເທນເນີ, ຮູບພາບເກົ່າທີ່ເຄີຍຖືກຍົກເລີກໄປແລ້ວນຳກັບມາໃຊ້ໃໝ່, ແລະ ຄອນເທນເນີທີ່ຮວມມາຈາກຄັງເກັບຮູບພາບ Fedora ເກົ່າ.

ຮູບພາບຄອນເທນເນີແບບຊັ້ນ ບໍ່ຈຳເປັນຕ້ອງມີຄວາມສຳພັນແບບ 1:1 ກັບແພັກເກດ RPM ແຕ່ສາມາດສົ່ງມອບຫຼາຍແພັກເກດ RPM (ເຊັ່ນ ໂຕເພິ່ງພາ/dependencies) ເພື່ອໃຫ້ເປັນຄອນເທນເນີທີ່ເຮັດວຽກໄດ້ຢ່າງສົມບູນ. ແນວໃດກໍຕາມ ການຕັ້ງຊື່ຄອນເທນເນີຄວນອີງຕາມບໍລິການຫຼັກ ຫຼື ຊອບແວທີ່ມັນຕ້ອງການສົ່ງມອບ.

ມີສອງບົດບາດໃນຂະບວນການກວດສອບ ຄື: ຜູ້ປະກອບສ່ວນ ແລະ ຜູ້ກວດສອບ. ໃນເອກະສານນີ້, ພວກເຮົາຈະສະເໜີໃຫ້ເຫັນທັງສອງມຸມມອງ.

ຜູ້ປະກອບສ່ວນ

ຜູ້ປະກອບສ່ວນ ແມ່ນຜູ້ທີ່ຕ້ອງການສົ່ງ (ແລະ ດູແລ) ຮູບພາບຄອນເທນເນີແບບຊັ້ນໃໝ່ໃນ Fedora. ເພື່ອຈະມາເປັນຜູ້ປະກອບສ່ວນ, ທ່ານຕ້ອງປະຕິບັດຕາມຄຳແນະນຳຢ່າງລະອຽດທີ່ ການເຂົ້າຮ່ວມເປັນຜູ້ດູແລແພັກເກດ.

ໃນຖານະຜູ້ປະກອບສ່ວນ, ທ່ານຄວນສ້າງຄອນເທນເນີຈາກຊອບແວທີ່ມີຢູ່ແລ້ວໃນຄັງເກັບ Fedora RPM ເຊິ່ງປະຕິບັດຕາມ ແນວທາງການປະຕິບັດ.

Dockerfiles

  • ວາງ Dockerfile ຂອງທ່ານ, ໄຟລ໌ກຳນົດຄ່າຕ່າງໆ, ແລະ ສະຄຣິບຄວບຄຸມໄວ້ບ່ອນໃດບ່ອນໜຶ່ງໃນອິນເຕີເນັດທີ່ສາມາດດາວໂຫຼດໄດ້ໂດຍກົງ (ພຽງແຕ່ HTTP(s), ກະລຸນາຢ່າໃຊ້ໜ້າລົງທະບຽນ ຫຼື ວິທີການດາວໂຫຼດແບບພິເສດ). ຖ້າທ່ານບໍ່ມີບ່ອນຝາກໄຟລ໌ເລີຍ ແລະ ຕ້ອງການພື້ນທີ່, ກະລຸນາເຂົ້າໄປທີ່ ລະບົບຕົວສຳຮອງ (Sponsors ticket system), ເຂົ້າສູ່ລະບົບ, ແລະ ສ້າງ ticket ດ້ວຍອົງປະກອບ "Initial package hosting request". ທ່ານຈະໄດ້ຮັບສິດເຂົ້າໃຊ້ Fedorapeople.

  • ຕື່ມຂໍ້ມູນໃສ່ ແບບຟອມຮ້ອງຂໍການກວດສອບໃນ bugzilla. ຊ່ອງ Summary ຕ້ອງຢູ່ໃນຮູບແບບ Container Review Request:... ຖ້າຕົກຫຼົ່ນເຄື່ອງໝາຍ : ເຄື່ອງມື fedpkg ຈະແຈ້ງເຕືອນຂໍ້ຜິດພາດ.

  • ຖ້າທ່ານຍັງບໍ່ມີແພັກເກດ ຫຼື ຮູບພາບຄອນເທນເນີແບບຊັ້ນໃນ Fedora ເທື່ອ, ນັ້ນໝາຍຄວາມວ່າທ່ານຕ້ອງການຜູ້ສະໜັບສະໜູນ (sponsor) ແລະ ຕ້ອງເພີ່ມ FE-NEEDSPONSOR (Bugzilla id:177841) ເຂົ້າໃນ bug ທີ່ຖືກບລັອກໂດຍການຮ້ອງຂໍການກວດສອບຂອງທ່ານ. ສຳລັບຂໍ້ມູນເພີ່ມເຕີມ ໃຫ້ອ່ານທີ່ໜ້າ ວິທີການຮັບການສະໜັບສະໜູນເຂົ້າໃນກຸ່ມຜູ້ສ້າງແພັກເກດ.

  • ລໍຖ້າໃຫ້ໃຜບາງຄົນມາກວດສອບ Dockerfile ຂອງທ່ານ! ໃນຂັ້ນຕອນນີ້, '''fedora-review flag''' ຈະວ່າງຢູ່, ເຊິ່ງໝາຍຄວາມວ່າຍັງບໍ່ມີຜູ້ກວດສອບຖືກມອບໝາຍເທື່ອ.

ຖ້າບໍ່ມີໃຜອອກຄວາມເຫັນໃນການຮ້ອງຂໍຂອງທ່ານ, ທ່ານອາດຈະສົ່ງອີເມລຫາ mailing list (devel@list.fedoraproject.org) ເພື່ອຂໍ "ແລກປ່ຽນການກວດສອບ (review swap)". ນີ້ແມ່ນການສະເໜີຕົວເພື່ອກວດສອບ Dockerfile ຂອງຄົນອື່ນ ເພື່ອແລກກັບການໃຫ້ເຂົາເຈົ້າມາກວດສອບ Dockerfile ຂອງທ່ານ. ໂດຍປົກກະຕິແລ້ວແມ່ນແບບຕົວຕໍ່ຕົວ, ຫຼື ອາດຈະເປັນການຕົກລົງສ່ວນຕົວອື່ນໆ ຂຶ້ນກັບຄວາມຍາກງ່າຍຂອງແພັກເກດນັ້ນໆ.

  • ອາດມີຄວາມຄິດເຫັນຈາກຜູ້ທີ່ບໍ່ໄດ້ເປັນຜູ້ກວດສອບຢ່າງເປັນທາງການ, ເຂົາເຈົ້າອາດເພີ່ມ NotReady ເຂົ້າໃນຊ່ອງ Whiteboard ເພື່ອບົ່ງບອກວ່າການຮ້ອງຂໍນັ້ນຍັງບໍ່ພ້ອມ, ເນື່ອງຈາກບັນຫາບາງຢ່າງທີ່ເຂົາເຈົ້າລາຍງານ. ຫຼັງຈາກທີ່ທ່ານແກ້ໄຂແລ້ວ, ກະລຸນາໂພສ URL ຂອງ Dockerfile ທີ່ອັບເດດແລ້ວ ແລະ ໄຟລ໌ທີ່ກ່ຽວຂ້ອງ ພ້ອມທັງລຶບມັນອອກຈາກ Whiteboard. ທ່ານຄວນຕອບສະໜອງຕໍ່ຄວາມຄິດເຫັນ, ລວມທັງການອັບເດດສິ່ງທີ່ສົ່ງໄປເພື່ອແກ້ໄຂບັນຫານັ້ນ; ຖ້າທ່ານບໍ່ເຮັດ, ticket ຂອງທ່ານຈະຖືກປິດ.

  • ຜູ້ກວດສອບຈະຮັບໜ້າທີ່ໃນການກວດສອບແພັກເກດຂອງທ່ານ. ເຂົາເຈົ້າຈະຕັ້ງ '''fedora-review flag''' ເປັນ '''?'''

  • ຜູ້ກວດສອບຈະກວດສອບ Dockerfile ຂອງທ່ານ. ທ່ານຄວນແກ້ໄຂສິ່ງທີ່ຂັດຂ້ອງ (blockers) ທີ່ຜູ້ກວດສອບລະບຸໄວ້. ເມື່ອຜູ້ກວດສອບພໍໃຈກັບແພັກເກດແລ້ວ, flag '''fedora-review''' ຈະຖືກຕັ້ງເປັນ '''+''', ເຊິ່ງບົ່ງບອກວ່າແພັກເກດຜ່ານການກວດສອບແລ້ວ.

  • ໃນຂັ້ນຕອນນີ້, ທ່ານຈຳເປັນຕ້ອງເຮັດ ຄຳຮ້ອງຂໍຜູ້ດູແລ SCM ສຳລັບຮູບພາບຄອນເທນເນີແບບຊັ້ນທີ່ໄດ້ຮັບການອະນຸມັດໃໝ່ຂອງທ່ານ. ຖ້າທ່ານຍັງບໍ່ໄດ້ຮັບການສະໜັບສະໜູນ (sponsor), ທ່ານຈະບໍ່ສາມາດດຳເນີນການຕໍ່ຈາກຂັ້ນຕອນນີ້ໄດ້. (ທ່ານຕ້ອງໝັ້ນໃຈວ່າໄດ້ຮ້ອງຂໍ namespace ຂອງຄອນເທນເນີໃນ src.fedorproject.org)

  • Checkout ແພັກເກດໂດຍໃຊ້ຄຳສັ່ງ "fedpkg clone container/<container-name>" ແລະ ກວດສອບ Dockerfile ແລະ ອື່ນໆ ເປັນຄັ້ງສຸດທ້າຍ.

  • ເມື່ອສຳເລັດແລ້ວ, ທ່ານສາມາດເພີ່ມໄຟລ໌ຄອນເທນເນີທີ່ກ່ຽວຂ້ອງເຂົ້າໃນ SCM. ໄຟລ໌ທີ່ຈຳເປັນມີດັ່ງນີ້:

  • Dockerfile

  • ໄຟລ໌ help.md

  • ຮ້ອງຂໍການ build ໂດຍການລັນຄຳສັ່ງ "fedpkg container-build".

  • ເຮັດຊ້ຳຂະບວນການນີ້ສຳລັບສາຂາ (branches) ອື່ນໆທີ່ທ່ານອາດຈະຮ້ອງຂໍ. (ໝາຍເຫດ: ແຖວ FROM ໃນ Dockerfile ສຳລັບແຕ່ລະສາຂາ ຈະຕ້ອງສະແດງໃຫ້ເຫັນວ່າເປັນ distgit branch ຂອງ Fedora ເວີຊັນໃດ ບໍ່ດັ່ງນັ້ນການ build ຈະເກີດການຕຳກັນໃນ koji)

  • ທ່ານຄວນກວດສອບໃຫ້ແນ່ໃຈວ່າ ticket ການກວດສອບໄດ້ຖືກປິດແລ້ວ. ທ່ານສາມາດປິດມັນໄດ້ຫຼັງຈາກ ຮູບພາບຄອນເທນເນີແບບຊັ້ນຖືກ build ໃນສາຂາທີ່ຮ້ອງຂໍແລ້ວ, ຫຼື ຖ້າທ່ານ build ສຳລັບສາຂາ Fedora release ທ່ານສາມາດຂໍໃຫ້ Bodhi ປິດ ticket ໃຫ້ທ່ານເມື່ອຂະບວນການສຳເລັດ. ຖ້າທ່ານປິດ ticket ດ້ວຍຕົນເອງ, ໃຫ້ໃຊ້ '''NEXTRELEASE''' ເປັນການແກ້ໄຂ (resolution).

ທ່ານບໍ່ຈຳເປັນຕ້ອງຜ່ານຂະບວນການກວດສອບອີກຄັ້ງ ສຳລັບການປ່ຽນແປງຮູບພາບຄອນເທນເນີແບບຊັ້ນໃນຄັ້ງຕໍ່ໆໄປຂອງຮູບພາບນີ້.

ຜູ້ກວດສອບ

ຜູ້ກວດສອບ ແມ່ນບຸກຄົນທີ່ເລືອກຈະກວດສອບແພັກເກດ.

ຄົນອື່ນໆກໍໄດ້ຮັບການສະໜັບສະໜູນໃຫ້ອອກຄວາມເຫັນໃນການຮ້ອງຂໍການກວດສອບເຊັ່ນກັນ. ໂດຍສະເພາະຜູ້ທີ່ກຳລັງຊອກຫາ ຜູ້ສະໜັບສະໜູນ (sponsorship) ຄວນອອກຄວາມເຫັນໃນການຮ້ອງຂໍອື່ນໆ ເພື່ອສະແດງໃຫ້ເຫັນວ່າພວກເຂົາຮູ້ຈັກ ແນວທາງການປະຕິບັດຄອນເທນເນີ.

ຜູ້ກວດສອບສາມາດເປັນຜູ້ຖືບັນຊີ Fedora ໃດກໍໄດ້ທີ່ເປັນສະມາຊິກຂອງ ກຸ່ມຜູ້ສ້າງແພັກເກດ. (ຖ້າຜູ້ປະກອບສ່ວນຍັງບໍ່ທັນໄດ້ຮັບການສະໜັບສະໜູນ, ການກວດສອບຍັງສາມາດດຳເນີນຕໍ່ໄປຈົນສຳເລັດ ແຕ່ພວກເຂົາຈະຕ້ອງຊອກຫາຜູ້ສະໜັບສະໜູນໃນພາຍຫຼັງ.)

  • ຄົ້ນຫາການຮ້ອງຂໍການກວດສອບທີ່ຕ້ອງການຜູ້ກວດສອບ: https://bugzilla.redhat.com/buglist.cgi?component=Container%20Review&list_id=9912775&product=Fedora%20Container%20Images

  • ຖ້າທ່ານສັງເກດເຫັນບາງບັນຫາທີ່ຕ້ອງໄດ້ຮັບການແກ້ໄຂກ່ອນທີ່ທ່ານຈະເລີ່ມການກວດສອບຢ່າງເປັນທາງການ, ໃຫ້ເພີ່ມບັນຫາເຫຼົ່ານັ້ນໃນຄວາມຄິດເຫັນ ແລະ ຕັ້ງ Whiteboard ຂອງ bug ໃຫ້ມີຄຳວ່າ NotReady. ນີ້ຈະຊ່ວຍໃຫ້ຜູ້ກວດສອບຄົນອື່ນໆຮູ້ວ່າການຮ້ອງຂໍການກວດສອບນີ້ຍັງບໍ່ພ້ອມສຳລັບຂັ້ນຕອນການກວດສອບຕໍ່ໄປ.

  • ຖ້າທ່ານຕ້ອງການກວດສອບ Dockerfile ຢ່າງເປັນທາງການ, ໃຫ້ຕັ້ງ flag '''fedora-review''' ເປັນ '''?''' ແລະ ມອບໝາຍ bug ນັ້ນໃຫ້ກັບຕົວທ່ານເອງ.

ຖ້າທ່ານຕ້ອງການຖອນຕົວອອກຈາກການກວດສອບດ້ວຍເຫດຜົນໃດກໍຕາມ, ໃຫ້ຕັ້ງຄ່າ <code>fedora-review</code> ຄືນໃຫ້ວ່າງເປົ່າ '''ແລະ''' ມອບໝາຍ bug ຄືນໃຫ້ກັບເຈົ້າຂອງເລີ່ມຕົ້ນຂອງອົງປະກອບ, ເຊິ່ງກໍຄື '''nobody@fedoraproject.org'''

ກວດສອບແພັກເກດ

  • ກວດສອບລາຍການທີ່ 'ຕ້ອງເຮັດ' (MUST) ທີ່ລະບຸໄວ້ໃນ ແນວທາງການປະຕິບັດຄອນເທນເນີ.

  • ກວດສອບລາຍການທີ່ 'ຄວນເຮັດ' (SHOULD) ໃນ ແນວທາງການປະຕິບັດຄອນເທນເນີ.

  • ໃສ່ຂໍ້ຄວາມການກວດສອບຂອງທ່ານໃນຄວາມຄິດເຫັນຂອງ ticket. ເພື່ອໃຫ້ອ່ານງ່າຍ, ໃຫ້ໃຊ້ພຽງແຕ່ຄວາມຄິດເຫັນທຳມະດາແທນການແນບໄຟລ໌.

  • ເລືອກດຳເນີນການຢ່າງໃດຢ່າງໜຶ່ງດັ່ງຕໍ່ໄປນີ້:

  • '''ACCEPT''' - ຖ້າຮູບພາບຄອນເທນເນີແບບຊັ້ນດີແລ້ວ, ໃຫ້ຕັ້ງ flag '''fedora-review''' ເປັນ '''+'''

ຖ້າຜູ້ກວດສອບເຮັດໜ້າທີ່ເປັນຜູ້ສະໜັບສະໜູນ (Sponsor) ໃຫ້ກັບຜູ້ປະກອບສ່ວນນຳ, ນີ້ຄືເວລາທີ່ຈະໃຫ້ການສະໜັບສະໜູນຜູ້ປະກອບສ່ວນ.

  • '''FAIL, LEGAL''' - ຖ້າຮູບພາບຄອນເທນເນີແບບຊັ້ນມີຄວາມສ່ຽງທາງດ້ານກົດໝາຍດ້ວຍເຫດຜົນໃດກໍຕາມ (ການລະເມີດສິດທິບັດ ຫຼື ລິຂະສິດ, ບັນຫາເຄື່ອງໝາຍການຄ້າ) ໃຫ້ປິດ bug ເປັນ WONTFIX ແລະ ຖິ້ມຄວາມຄິດເຫັນທີ່ເໝາະສົມໄວ້ (ເຊັ່ນ: ພວກເຮົາບໍ່ໄດ້ເຜີຍແຜ່ mp3). ຕັ້ງ flag '''fedora-review''' ເປັນ '''-''', ແລະ ໃຫ້ ticket ການກວດສອບນັ້ນບລັອກ FE-Legal.

  • '''FAIL, OTHER''' - ຖ້າຮູບພາບຄອນເທນເນີແບບຊັ້ນບໍ່ຖືກຕ້ອງ ຫຼື ບໍ່ເໝາະສົມດ້ວຍເຫດຜົນອື່ນໆ, ແລະ ບໍ່ມີການແກ້ໄຂທີ່ງ່າຍດາຍ, ໃຫ້ປິດ bug ເປັນ WONTFIX ແລະ ຖິ້ມຄວາມຄິດເຫັນທີ່ເໝາະສົມໄວ້ (ເຊັ່ນ: ຂໍໂທດ, ພວກເຮົາບໍ່ໄດ້ເຮັດແພັກເກດສິ່ງລາມົກເພື່ອເຜີຍແຜ່. ຫຼື, ນີ້ບໍ່ແມ່ນ specfile, ມັນແມ່ນເມນູອາຫານຂອງ McDonald, ຂໍໂທດດ້ວຍ.) ຕັ້ງ flag '''fedora-review''' ເປັນ '''-'''.

  • '''NEEDSWORK''' - ສິ່ງໃດກໍຕາມທີ່ບໍ່ໄດ້ຖືກລະບຸວ່າບໍ່ຜ່ານຢ່າງຊັດເຈນ ຄວນຖືກເປີດໄວ້ໃນຂະນະທີ່ຜູ້ສົ່ງ ແລະ ຜູ້ກວດສອບເຮັດວຽກຮ່ວມກັນເພື່ອແກ້ໄຂບັນຫາທີ່ອາດຈະເກີດຂຶ້ນ. ໝາຍ bug ເປັນ NEEDINFO ໃນຂະນະທີ່ລໍຖ້າໃຫ້ຜູ້ກວດສອບຕອບສະໜອງຕໍ່ຄຳຮ້ອງຂໍການປັບປຸງ; ນີ້ເຮັດໃຫ້ຜູ້ກວດສອບຄົນອື່ນໆຊອກຫາການກວດສອບທີ່ຍັງເປີດຢູ່ ເຊິ່ງຕ້ອງການຂໍ້ມູນຈາກພວກເຂົາໄດ້ງ່າຍຂຶ້ນ.

  • ເມື່ອແພັກເກດຖືກຕັ້ງ flag ເປັນ '''fedora-review +''' (ຫຼື '''-''') ແລ້ວ, ວຽກຂອງຜູ້ກວດສອບກໍຖືວ່າສຳເລັດ ເຖິງແມ່ນວ່າພວກເຂົາອາດຈະຖືກຮ້ອງຂໍໃຫ້ຊ່ວຍເຫຼືອຜູ້ປະກອບສ່ວນໃນຂະບວນການນຳເຂົ້າ/build/ອັບເດດ ແລະ ເພື່ອຮັບປະກັນວ່າຜູ້ປະກອບສ່ວນໄດ້ປິດ ticket ເມື່ອຂະບວນການສຳເລັດແລ້ວ.

Want to help? Learn how to contribute to Fedora Docs ›