ໄຟລ໌ຊ່ວຍເຫຼືອ
ເຊັ່ນດຽວກັນກັບແພັກເກັດທົ່ວໄປ, ຄອນເທນເນີ (containers) ຈຳເປັນຕ້ອງມີຂໍ້ມູນ "man page" ກ່ຽວກັບວິທີການນຳໃຊ້, ການຕັ້ງຄ່າ ແລະ ການເຊື່ອມໂຍງເຂົ້າກັບລະບົບທີ່ໃຫຍ່ກວ່າ. ດັ່ງນັ້ນ, ໄຟລ໌ຊ່ວຍເຫຼືອ (Help File) ຈຶ່ງມີຄວາມຈຳເປັນໃນການເປັນສ່ວນໜຶ່ງຂອງແພັກເກັດຄອນເທນເນີຂອງທ່ານ ເວັ້ນເສຍແຕ່ວ່າທ່ານໄດ້ໃຫ້ຄຳສັ່ງ "help" ແທນ. ໄຟລ໌ຊ່ວຍເຫຼືອນີ້ (ຖ້າມີ) ຈະຖືກສະໜອງໃຫ້ເປັນສ່ວນໜຶ່ງຂອງການກວດສອບຄອນເທນເນີ (Container Review). ມັນຕ້ອງເປັນໄຟລ໌ MarkDown ເຊິ່ງຕ້ອງວາງໄວ້ໃນໂຟນເດີຮາກ (root) ຂອງບ່ອນເກັບ DistGit ກ່ອນທີ່ຈະເລີ່ມຕົ້ນການສ້າງ (build) ຄອນເທນເນີຂອງທ່ານ ແລະ ມັນຕ້ອງມີຊື່ດັ່ງນີ້:
-
help.md
OSBS ຈະປ່ຽນໄຟລ໌ນີ້ໃຫ້ເປັນ man page ໂດຍອັດຕະໂນມັດ ແລະ ສຳເນົາມັນໄປໄວ້ທີ່ /help.1 ໃນອິມເມຈ (image) ທີ່ຖືກສ້າງຂຶ້ນ.
ໄຟລ໌ຊ່ວຍເຫຼືອຄວນປະກອບມີຂໍ້ມູນທັງໝົດດັ່ງຕໍ່ໄປນີ້, ຂຶ້ນກັບຄວາມຕ້ອງການຂອງອິມເມຈ:
-
ຄຳອະທິບາຍສັ້ນໆກ່ຽວກັບການບໍລິການ/ຊອບແວທີ່ອິມເມຈນີ້ບັນຈຸຢູ່.
-
ຈຸດປະສົງໃນການນຳໃຊ້ພາຍໃຕ້ໂຄງສ້າງພື້ນຖານທີ່ໃຫຍ່ກວ່າ (ຖ້າມີ).
-
ຫາກສາມາດຕັ້ງຄ່າການບໍລິການທີ່ບັນຈຸຢູ່ນັ້ນໄດ້, ໃນໄຟລ໌ '''ຕ້ອງ''' ມີຄຳແນະນຳກ່ຽວກັບວິທີການເຮັດ.
-
ຫາກຄອນເທນເນີມີການເພິ່ງພາການບໍລິການອື່ນໆ (ຕົວຢ່າງ: ຖານຂໍ້ມູນ), ໃນໄຟລ໌ '''ຕ້ອງ''' ລະບຸລາຍລະອຽດເຫຼົ່ານີ້.
-
ຫາກຄອນເທນເນີມີການໃຊ້ volumes, ໃນໄຟລ໌ '''ຕ້ອງ''' ລະບຸລາຍລະອຽດວ່າແຕ່ລະອັນມີໄວ້ເພື່ອຫຍັງ, ເບິ່ງຄຳແນະນຳ VOLUMES ສຳລັບລາຍລະອຽດເພີ່ມເຕີມ.
-
ຄຳອະທິບາຍກ່ຽວກັບແຕ່ລະ PORT ທີ່ອິມເມຈເປີດຮັບການເຊື່ອມຕໍ່, ລວມທັງໂປຣໂຕຄໍ (protocol) ແລະ ຈຸດປະສົງຂອງມັນ.
-
ລິງກ໌ (Links) ໄປຫາເອກະສານພາຍນອກ ຫຼື ໜ້າໂຄງການຊອບແວ, ຫາກມີໜ້າເວັບດັ່ງກ່າວຢູ່.
-
ຫາກຄອນເທນເນີມີຄວາມຕ້ອງການພິເສດໃດໆ (ເຊັ່ນ: ຕ້ອງການ RAM ຫຼາຍ ຫຼື ການເຂົ້າເຖິງ sound server), ສິ່ງເຫຼົ່ານີ້ '''ຕ້ອງ''' ຖືກລະບຸໄວ້.
-
ຫາກແອັບພລິເຄຊັນມີຮູບແບບຫຼັກໆໃນການສ້າງທີ່ແຕກຕ່າງກັນ, ຂໍ້ມູນກ່ຽວກັບສິ່ງເຫຼົ່ານີ້ (ຕົວຢ່າງ: mod_php ກັບ fastcgi) ແມ່ນ '''ຈຳເປັນ'''.
ຕົວຢ່າງໄຟລ໌ຊ່ວຍເຫຼືອ:
PostgreSQL 9.6 image, for supplying PostgreSQL within a Kubernetes stack.
Includes all of "contrib", but does not include PostGIS or any automated replication management.
Volumes:
pg-config: usually mapped to /etc/postgresql/, contains the configuration files for PostgreSQL,
including postgresql.conf and pg_hba.conf. Read-only within the container.
Should map to local storage.
pg-data: usually mapped to /var/lib/pgsql/data, contains database data. Should be stored in
a persistent volume or network storage of some kind. Requires high-throughput, read-write storage.
Ports:
5432: the PostgreSQL data port using the pgsql protocol.
Documentation:
See https://www.postgresql.org/docs/9.6/static/index.html
Requirements:
This is a transactional database, and requires 256MB of RAM and at
least one dedicated core. If heavily used, can require much greater system resources.
Configuration:
Sample postgresql.conf and pg_hba.conf files are supplied in the image. For further documentation,
please see the PostgreSQL docs. Note that these files must be readable by the "postgres" user
inside the container.
The database system is initialized with the admin user/password of postgres/postgres. If you wish
to override this, supply the ENV vars ADMIN_USER and ADMIN_PASS inside the container at initialization time.
Want to help? Learn how to contribute to Fedora Docs ›