பதிப்பு வெளியிடுதல்

சோதிக்கப்பட்ட build-ஐ ஒரு பதிப்பாக மாற்றவும். இந்தப் பக்கம் பராமரிப்பாளர்களுக்கானது.

Caution

பராமரிப்பாளர் மட்டுமே ஒரு பதிப்பைத் தொடங்குவார். நீங்களாக tag போடவோ, வெளியிடவோ, image tag-ஐ நகர்த்தவோ வேண்டாம்.

தொடங்கும் முன்

• சோதனை பக்கத்தில் உள்ள ஒவ்வொரு சோதனையும் தேறுகிறது, முழு end-to-end இயக்கம், நீண்ட மற்றும் fault இயக்கங்கள் உட்பட.
• CHANGELOG.md-இல் புதிய பதிப்பு உள்ளது.
• பதிப்பு வெளியீட்டு scripts-க்கு Python 3 நிறுவப்பட்டுள்ளது.

ஒரு பதிப்பைத் தயாரித்தல்

1. releases/notes-<version>.toml என்பதை எழுதவும், எடுத்துக்காட்டாக releases/notes-1.0.0.toml. வெளியீட்டுக் குறிப்புக் கோப்பு பகுதியைப் பார்க்கவும்.

2. அதைச் சரிபார்க்கவும்:

   python deploy/release/notes.py 1.0.0 --check

   எந்தப் பிழையும் தெரியக்கூடாது. தடைசெய்யப்பட்ட சொல், em dash, தேதி, launch பேச்சு, அல்லது மீண்டும் வரும் highlight issue இருந்தால் அது 1 என்று வெளியேறும்.

3. வெளியீட்டு உரைகளை உருவாக்கவும்:

   python deploy/release/notes.py 1.0.0

   releases/out/1.0.0/-இல் 7 கோப்புகள் இருக்கும்.

4. Image-ஐ உருவாக்கி, புதிய கட்டமைவு அடைவுடன் தொடங்கவும்:

   docker build --file deploy/Dockerfile .

   முதல் இயக்க wizard தெரியும்.

5. சோதனை பக்கத்தில் உள்ள ஒவ்வொரு சோதனையையும் உங்கள் கணினியில் இயக்கவும். சோதனைகள் உள்ளூரில் ஓடும், GitHub-இல் அல்ல.

6. பதிப்பைப் பராமரிப்பாளரிடம் ஒப்படைக்கவும். பராமரிப்பாளர் main-இல் பதிப்பு tag-ஐ push செய்வார், அதுவே பதிப்பு வெளியீட்டைத் தொடங்கும்.

தேர்வுகள்

பதிப்பு மற்றும் tag பெயர்கள்

விஷயம்	பெயர்
Git tag (பராமரிப்பாளர் push செய்வது)	1.0.0 (வெறும் எண்கள், v இல்லை)
Image tag மற்றும் குறிப்புகளின் version	1.0.0

Workflow X.Y.Z tag-க்கு மட்டுமே தொடங்கும், tag VERSION கோப்பிலிருந்து வேறுபட்டால் நின்றுவிடும்.

Image tag-கள்

ஒவ்வொரு பதிப்பும் தன் பதிப்பு tag-ஐயும் :latest-ஐயும் push செய்யும்.

ஒரு பதிப்பைத் திரும்பப் பெறுதல்

1. திருத்தத்துடன் அடுத்த பதிப்பை push செய்யவும்.
2. நிறுவல்கள் அதை வழங்காதபடி, புதுப்பிப்புப் பட்டியலில் மோசமான பதிப்பைக் குறிக்கவும்.
3. Tag-ஐ அப்படியே வைக்கவும்.

இது வேலை செய்யவில்லை என்றால்

அறிகுறி. notes.py --check 1 என்று வெளியேறுகிறது. காரணம். குறிப்புக் கோப்பு ஒரு விதியை மீறுகிறது. செய்தி அந்த வரியைக் குறிப்பிடும். தீர்வு. குறிப்புக் கோப்பைத் திருத்தவும், releases/out-இல் உள்ள கோப்புகளை ஒருபோதும் திருத்த வேண்டாம், பிறகு மீண்டும் இயக்கவும்.

அறிகுறி. Workflow VERSION says என்று சொல்லி நின்றுவிடுகிறது. காரணம். Tag-உம் VERSION கோப்பும் வேறுபடுகின்றன. தீர்வு. main-இல் VERSION-ஐத் திருத்தி, அடுத்த பதிப்பு tag-ஐ push செய்யவும்.

நிபுணர்களுக்கு

வெளியீட்டுக் குறிப்புக் கோப்பு

ஒவ்வொரு வெளியீட்டு உரையும் ஒரே கோப்பிலிருந்து வருகிறது. அது உருவாக்குவதைக் கையால் திருத்த வேண்டாம்.

புலம்	உள்ளடக்கம்
version	வெறும் X.Y.Z
theme	ஒரு வரி
images	{registry, name} பட்டியல். Docker Hub holyarrs/holyarrs மட்டும்
docs_url	விருப்பத்துக்குரியது. காலி என்றால் Docs இணைப்பு இல்லை
[[highlights]]	சரியாக 3, ஒவ்வொன்றிலும் line, issues, shot. அவற்றின் issues எந்தக் குழு வரியிலும் வராது
[groups]	இடத்துக்கு ஏற்ற வரிகள். New என்பது இயல்புநிலை. மற்றவை Changed: , Fixed: அல்லது Docs: என்று தொடங்கும். ஒவ்வொன்றும் (#46) போல தன் issue-வுடன் முடியும். 3-க்குக் குறைவான வரிகள் உள்ள இடம் Also new-இன் கீழ் போகும்
விருப்பத்துக்குரியவை	[before_you_update] (breaking, manual_steps, backup, rollback), security, known_issues, credits, [stats]. காலிப் பகுதிகள் மறைக்கப்படும்

GitHub login தெரிந்தால் மட்டுமே, குறிப்புக் கோப்பிலோ releases/credits-map.json-இலோ பயன்படுத்தவும்.

உடல் வரிசை: theme, Highlights, இடங்கள் (Requests, Library, Downloads, Indexers, Accounts, Health, Setup, Install), Also new, Security, Known issues, Before you update, Image, Thanks, stats வரி.

releases/out/<version>/-இல் வெளியீடு	பயன்படுவது
changelog.md	Changelog பதிவு
github.md	GitHub வெளியீட்டு உடல்
update-notes.json	பயன்பாடு காட்டும் குறிப்புகள்
reddit.txt	Reddit பதிவு
discord-dm.txt, discord-announce.md	Discord. ஒவ்வொன்றும் 1,000 எழுத்துகளுக்குள் இருக்கும்
roadmap-card.json	Roadmap அட்டை

notes.py --file (வேறொரு குறிப்புக் கோப்பு), --map (வேறொரு credits map), --out (வேறொரு வெளியீட்டு அடைவு), --date ஆகியவற்றை எடுக்கும். --check நீண்ட வரிகளையும் கிட்டத்தட்ட மீண்டும் வருவனவற்றையும் எச்சரிக்கும்.

Image workflow

பதிப்பு tag push செய்யப்படும்போது HolyArrs - Release workflow தொடங்கும். அதில் மூன்று படிகள் உள்ளன:

1. linux/amd64, linux/arm64, linux/arm/v7 ஆகியவற்றுக்கு image-ஐ உருவாக்கி, பதிப்பு tag-உடனும் latest-உடனும் push செய்யவும்.
2. README.md-இலிருந்து Docker Hub விளக்கத்தைப் புதுப்பிக்கவும்.
3. இந்தப் பதிப்பின் CHANGELOG.md பகுதியுடன் GitHub வெளியீட்டை வெளியிடவும்.

புதுப்பிப்புப் பட்டியல்

பயன்பாடு கையொப்பமிட்ட புதுப்பிப்புப் பட்டியலைப் படிக்கிறது. ஒவ்வொரு பதிப்பும் தன் பதிவைச் சேர்த்துக் கையொப்பமிடும். கையொப்ப விசை repo-வில் ஒருபோதும் இருக்காது. சரிபார்க்க முடியாத பட்டியலை HolyArrs ஏற்காது.

ஒரு பதிப்புக்குப் பிறகு, image-இன் பதிப்பு label tag-உடன் பொருந்துகிறதா என்று சரிபார்க்கவும், முதல் நாள் புதிய issues-ஐக் கவனிக்கவும்:

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Unraid சோதனை template

deploy/release/nas-template.py ஒரு குறிப்பிட்ட image-க்கான Unraid பயனர் template-ஐ எழுதும். இது எதையும் pull செய்வதோ, நிறுவுவதோ, வெளியிடுவதோ இல்லை.

python deploy/release/nas-template.py --image 'holyarrs/holyarrs@sha256:<digest>' --config '/mnt/<pool>/appdata/holyarrs-test' --movies /mnt/user/holyarrs-test-data/movies --downloads /mnt/user/holyarrs-test-data/downloads --port 6262 --output holyarrs-test.xml

<digest>, <pool> ஆகியவற்றை மாற்றவும்.

Flag	குறிப்புகள்
--image	Registry manifest digest, Docker image ID அல்ல
--config	ஒரு pool பாதை. கருவி /mnt/user, /mnt/user0 ஆகியவற்றை ஏற்காது
--movies, --tv, --music, --downloads	விருப்பத்துக்குரியவை. தனித்தனிப் பாதைகள் தனித்தனி mount-கள், அதனால் இறக்குமதிகள் நகலெடுக்கும்
--port	இயல்பாக 6262
--allowed-hosts	விருப்பத்துக்குரியது, கமாவால் பிரித்த host பெயர்கள்
--output	எழுத வேண்டிய XML கோப்பு

Template PUID=99, PGID=100, UMASK=022 என்று அமைக்கும். அந்தக் கணக்குக்குச் சோதனை ஊடகத்தில் எழுத்து அணுகல் கொடுக்கவும். கோப்பை /boot/config/plugins/dockerMan/templates-user/-இல் வைத்து, Docker > Add Container > Template (Docker > container சேர் > template) என்பதன் கீழ் அதைத் தேர்ந்தெடுக்கவும்.

தொடர்புடையவை

• சோதனை
• பங்களிப்பு
• புதுப்பிப்புகள்