Portable build

அமைவு

Linux அல்லது Windows-இல் HolyArrs-ஐ Docker இல்லாமல் ஒரு சாதாரண நிரலாக இயக்கவும். இயக்குவதற்கான முதன்மை வழி Docker-தான்.

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

உருவாக்கும் கணினியில் Python 3, Git, Docker.
ஒரு சாதாரணத் திட்ட build-இலிருந்து நிரப்பப்பட்ட Go module cache, மற்றும் app/frontend/package-lock.json-இலிருந்து நிறுவப்பட்ட frontend சார்புகள்.
உருவாக்கப்பட்ட web app commit செய்யப்பட்டிருக்க வேண்டும். build commit செய்த மூலத்தை மட்டுமே பயன்படுத்தும்; commit செய்யாத திருத்தங்கள் விடப்படும்.

உருவாக்கி இயக்குதல்

checkout-இலிருந்து காப்பகங்களை உருவாக்கவும்:
Terminal window
```
python deploy/release/package.py --ref HEAD --version 1.0.0 --output /srv/holyarrs-archives/1.0.0 --web-node-modules app/frontend/node_modules --module-cache /home/you/go/pkg/mod
```
checkout-க்கு வெளியே ஒரு புதிய output அடைவைப் பயன்படுத்தவும். ஒவ்வொரு target-க்கும் ஒரு காப்பகமும் ஒரு SHA256SUMS கோப்பும் தெரியும்.
காப்பகத்தை SHA256SUMS-உடன் சரிபார்க்கவும்.
அதை ஒரு புதிய அடைவில் பிரித்தெடுக்கவும். நிரலையும் கட்டமைவையும் தனித்தனி அடைவுகளில் வைக்கவும்.
உங்கள் சொந்த கட்டமைவுப் பாதையுடன் தொடங்கவும்:
Terminal window
```
./holyarrs -config /srv/holyarrs/config -addr :6262
```
Windows PowerShell-இல்:
Terminal window
```
.\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'
```
http://your-server:6262 திறக்கவும். முதல் இயக்க wizard தெரியும். உடனே உரிமையாளர் கணக்கை உருவாக்கவும்; முதலில் வருபவர் உரிமையாளர் ஆகிவிடுவார்.

தேர்வுகள்

யார் இயக்குவது

HolyArrs-ஐ அதற்கென்று தனிக் கணக்கின் கீழ் இயக்கவும்; கட்டமைவு அடைவுக்கும் உங்கள் மீடியாவுக்கும் மட்டுமே எழுத்து அணுகல் இருக்கட்டும்.

container-க்கு வெளியே root ஆக, PUID, PGID இல்லாமல் இயக்கினால், “started as root outside a container” என்று சொல்லி நின்றுவிடும்.
PUID, PGID அமைத்தால், அது கட்டமைவு அடைவை அந்தப் பயனருக்கு ஒப்படைத்து, அவருக்கு மாறும்.
Windows-இல், அந்தக் கணக்குக்கான NTFS அனுமதியால் கட்டமைவு அடைவைப் பாதுகாக்கவும்.

மறுதொடக்கங்களும் வரம்புகளும்

காப்பகம் எந்த service-ஐயும் நிறுவாது. auto-restart-ஐயும் கடுமையான நினைவக வரம்புகளையும் உங்கள் சொந்த service மேலாளரில் (systemd, NSSM, Task Scheduler) அமைக்கவும். பயன்பாட்டில் செய்யும் மறுதொடக்கமும் backup மீட்டமைப்பும் வெளியேறி, மீண்டும் தொடங்கப்படும் என எதிர்பார்க்கின்றன.

புதுப்பித்தலும் பழையதுக்குத் திரும்புதலும்

பயன்பாட்டை நிறுத்தும் முன் புதிய காப்பகத்தைச் சரிபார்க்கவும்.
HolyArrs-ஐ நிறுத்தி, முதன்மை விசை உட்பட முழு கட்டமைவு அடைவையும் நகலெடுக்கவும். அல்லது பயன்பாட்டில் ஒரு backup எடுத்து, அதன் விசையைத் தனியாக வைக்கவும்.
புதிய நிரலை வேறொரு அடைவில் பிரித்தெடுக்கவும். பழைய நிரலையும் பழைய கட்டமைவு நகலையும் வைத்திருக்கவும்.
புதிய நிரலை உங்கள் கட்டமைவில் தொடங்கவும். நீங்கள் உள்நுழைய முடியும், /health running எனக் காட்டும்.

Backup-கள் பார்க்கவும்.

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

அறிகுறி	காரணம்	தீர்வு
“started as root outside a container”	root ஆகத் தொடங்கியது	அதைத் தனிப் பயனராக இயக்கவும், அல்லது `PUID`, `PGID` அமைக்கவும்.
மீட்டமைப்புக்குப் பிறகு பயன்பாடு வெளியேறுகிறது	மீட்டமைப்பு தரவைத் தயார்படுத்தி, குறியீடு 75-உடன் வெளியேறும்	அதைப் பொருத்த மீண்டும் தொடங்கவும். உங்கள் service மேலாளர் அதை மறுதொடக்கம் செய்யுமாறு அமைக்கவும்.
Linux-இல் HTTPS அழைப்புகள் தோல்வியடைகின்றன	கணினி CA சான்றிதழ்கள் இல்லை	அவற்றை நிறுவவும்.
output இருக்கிறது என்று build சொல்கிறது	ஏற்கெனவே உள்ள output அடைவுகள் மறுக்கப்படும்	ஒரு புதிய அடைவைத் தேர்ந்தெடுக்கவும்.

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

Build விருப்பங்கள்

விருப்பம்	என்ன செய்கிறது	இயல்புநிலை
`--targets`	உருவாக்க வேண்டியவற்றின் கமாவால் பிரித்த துணைக்குழு	`linux-amd64,linux-arm64,linux-armv7,windows-amd64`
`--low-resource`	ஒவ்வொரு builder container-க்கும் 1 CPU, 2 GiB, 256 செயல்முறைகள்; Go ஒரு நேரத்தில் ஒரு package-ஐ உருவாக்கும். பொதிவு இன்னும் host-இல், அந்த வரம்புகளுக்கு வெளியே நடக்கும்.	off

build திட்டத்தின் பின்செய்யப்பட்ட Go builder image-இல், வலையமைப்பு இல்லாமல் இயங்கும், அதனால் எதையும் பதிவிறக்காது. module cache படிக்க மட்டும் என mount செய்யப்படுகிறது. எந்த target தோல்வியடைந்தாலும், output அடைவு எதுவும் மிஞ்சாது. commit பதிப்பு எண்ணில் சேர்க்கப்பட்டு நிரலுக்குள் உருவாக்கப்படுகிறது; பயன்பாடும் அதன் backup-களும் அதைத் தெரிவிக்கும்.

காப்பகத்தில் என்ன இருக்கிறது

நிரல், உரிமம், மூன்றாம் தரப்பு அறிவிப்புகள், வழிகாட்டிகள், மூல manifest, package அடையாளம். தனி மூலக் காப்பகம் திட்ட மூலத்தையும் Go சார்புகளையும் வைத்திருக்கும்; அதை binary-களின் அருகிலேயே வைத்திருக்கவும்.

SHA256SUMS கோப்புகள் பொருந்துகின்றன என்பதை நிரூபிக்கிறது. அது ஒரு கையொப்பம் அல்ல. அதே commit, பதிப்பு, உள்ளீடுகள் அதே காப்பகங்களைத் தரும், எனவே சரிபார்க்க மீண்டும் உருவாக்கிப் பார்க்கலாம்.

இயக்க நேரக் குறிப்புகள்

தலைப்பு	விவரம்
கட்டமைவுப் பாதை	இயல்புநிலை `/config`. எப்போதும் `-config` கொடுக்கவும், உள்ளூர் வட்டில்.
நினைவக இலக்கு	`GOMEMLIMIT` இல்லாமல் 384 MiB. நீங்கள் கொடுக்கும் நினைவகத்தில் சுமார் 80 சதவீதமாக அமைக்கவும். இது இலக்கு, கடின வரம்பு அல்ல.
குறைந்த நினைவக முறை	Linux-இல், சுமார் 2.5 GiB அல்லது குறைவில் தானாக இயங்கும்; இலக்கு நினைவகத்தின் கால் பங்குக்குக் குறைந்து, 192 முதல் 384 MiB வரை இருக்கும். `HOLYARRS_LOW_MEMORY=1` அல்லது `0` முடிவு செய்யும்.
Node	இயக்க வேண்டியதில்லை.
Hardlink-கள் (கடின இணைப்பு)	பதிவிறக்க அடைவுகளையும் நூலக அடைவுகளையும் ஒரே கோப்பு முறைமையில் வைக்கவும்.

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

HolyArrs இலவசம். இது உங்கள் நேரத்தைச் சேமித்திருந்தால், GitHub-இல் நட்சத்திரம் இடுங்கள், ஆதரவளியுங்கள் அல்லது எனக்கு ஒரு காபி வாங்கித் தாருங்கள்.