ஒரு கோப்பிலிருந்து விசைகளை இறக்குமதி செய்தல்

அமைவு

உங்கள் மூலங்கள், பதிவிறக்கிகள், media server-கள், வசனத் தளங்கள், அஞ்சல் ஆகியவற்றை ஒரே கோப்பில் நிரப்பி, இறக்குமதி செய்து, ஒவ்வொரு விசையையும் Settings-இல் தட்டச்சு செய்வதைத் தவிர்க்கவும்.

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

HolyArrs Docker-இல் இயங்குகிறது, அதன் கட்டமைவு /config-இல் உள்ளது.
Settings > API > API keys (அமைப்புகள் > API > API விசைகள்) பகுதியில் உரிமையாளர் API விசையை உருவாக்க முடியும்.

கோப்பை இறக்குமதி செய்தல்

holyarrs-secrets.template.yaml கோப்பை holyarrs-secrets.yaml என்று நகலெடுக்கவும்.
நீங்கள் பயன்படுத்துபவற்றை நிரப்பவும். மீதியைக் காலியாக விடவும்; காலி என்றால் தவிர்.
அதை உங்களால் மட்டுமே படிக்கும்படி அமைக்கவும்:
Terminal window
```
chmod 600 holyarrs-secrets.yaml
```

அதை read-only ஆக container-க்குள் mount செய்யவும்:

volumes:
  - /srv/holyarrs/config:/config
  - /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro

Settings > API > API keys பகுதியில் admin scope உள்ள உரிமையாளர் API விசையை உருவாக்கவும். அதைக் கோப்பின் holyarrs பகுதியில், http://127.0.0.1:6262 முகவரியுடன் வைக்கவும்.
ஒரு சோதனை ஓட்டம் முயலவும். இது எதையும் மாற்றாது:
Terminal window
```
docker exec holyarrs /holyarrs import-secrets -file /run/secrets/holyarrs.yaml -dry-run
```
ஒவ்வொரு உருப்படிக்கும் ஒரு would set வரி தெரியும்.
உண்மையாக இயக்கவும் (-dry-run இல்லாமல் அதே கட்டளை). set வரிகளும் exit code 0-உம் தெரியும்.
புதிய மூலங்களையும் பதிவிறக்கிகளையும் சரிபார்த்து, பிறகு அவற்றைத் தொடரவும். புதிய media server-களையும் அறிவிப்புகளையும் சோதித்து, பிறகு இயக்கவும்.
Host-இல் கோப்பை அழிக்கவும் (கோப்பை அழித்தல் பகுதியைப் பார்க்கவும்). இனி தேவையில்லை என்றால் API விசையையும் அழிக்கவும்.

ஒவ்வொரு பகுதியும் எதுவாகிறது

கோப்பில்	ஆவது
`trakt.client_id`	Trakt app விசை (Settings > Outside lists, வெளிப்புறப் பட்டியல்கள்).
`tmdb`, `tvdb`	பழைய கோப்புகளிலிருந்து ஏற்கப்படும். Metadata-வுக்கு விசைகள் தேவையில்லை.
`opensubtitles`, `subdl`	உங்கள் கணக்குடன் ஒரு வசனத் தளம்.
`addic7ed`	ஒரு Addic7ed வசனத் தளம், தொடர்களுக்கு மட்டும்.
`indexers`	ஒரு உருப்படிக்கு ஒரு மூலம், paused (இடைநிறுத்தப்பட்டது).
`jackett`, `prowlarr`	அவற்றின் விசை, அதே முகவரியில் விசை இல்லாத ஒவ்வொரு `indexers` உருப்படியையும் நிரப்பும்.
`qbittorrent`, `sabnzbd`	ஒரு பதிவிறக்கி, paused.
`nzbget`, `transmission`, `deluge`	தவிர்க்கப்படும். இறக்குமதியால் இவற்றை இன்னும் அமைக்க முடியாது; Settings > Downloaders-இல் சேர்க்கவும்.
`jellyfin`, `emby`, `plex`	ஒரு media server, நீங்கள் சோதிக்கும் வரை off (அணைந்தது).
`smtp`, `discord`, `webhook`	“Email”, “Discord”, “Webhook” அறிவிப்புகள், நீங்கள் சோதிக்கும் வரை off.
`radarr`, `sonarr`, `lidarr`, `prowlarr`, `bazarr`, `seerr`	Import from other apps (பிற பயன்பாடுகளிலிருந்து இறக்குமதி) என்பதற்காகச் சேமிக்கப்பட்ட ஒரு விசை.
`holyarrs`	HolyArrs இயங்கும்போது அதை அணுக மட்டுமே பயன்படும். ஒருபோதும் சேமிக்கப்படாது.

ஒவ்வொரு விசையும், Settings-இல் தட்டச்சு செய்ததைப் போலவே, குறியாக்கம் செய்யப்பட்ட vault-க்குள் போகும்.

தேர்வுகள்

உள்ளூர் வலையமைப்பு சுவிட்ச்

முகவரி உள்ள ஒவ்வொரு பகுதியும் allow_local_network: true எடுக்கலாம். அது அந்த உருப்படியை இந்தக் கணினியை அல்லது உங்கள் வீட்டு வலையமைப்பை (192.168.x.x, 10.x.x.x, ஒரு container பெயர்) அணுக விடும். அது இல்லாவிட்டால் அந்த உருப்படி இணையத்தை மட்டுமே அணுகும், அதனால் வீட்டில் உள்ள பதிவிறக்கி பதிலளிக்காது. இதை HolyArrs முகவரியிலிருந்து ஒருபோதும் ஊகிக்காது. இது Settings-இல் உள்ள May reach the local network (உள்ளூர் வலையமைப்பை அணுகலாம்) என்ற அதே சுவிட்ச்.

HolyArrs நிறுத்தப்பட்ட நிலையில்

அதே கட்டமைவில் ஒரு முறை மட்டும் இயங்கும் container-ஐ இயக்கவும். அது நேரடியாக config அடைவில் சேமிக்கும், holyarrs பகுதி தேவையில்லை:

docker stop holyarrs
docker run --rm -e PUID=1000 -e PGID=1000 \
  -v /srv/holyarrs/config:/config \
  -v /srv/holyarrs/holyarrs-secrets.yaml:/run/secrets/holyarrs.yaml:ro \
  holyarrs/holyarrs:latest import-secrets -file /run/secrets/holyarrs.yaml
docker start holyarrs

பயன்பாட்டில் உள்ள அதே PUID, PGID-ஐப் பயன்படுத்தவும், இல்லாவிட்டால் config அடைவு 1000:1000-க்கு மாற்றப்படும். PUID பயனரால் கோப்பைப் படிக்க முடிய வேண்டும். HOLYARRS_MASTER_KEY_FILE பயன்படுத்தினால், ஒருமுறை இயங்கும் container-க்கும் அதே மாறியையும் mount-ஐயும் கொடுக்கவும்.

மீண்டும் இயக்குதல்

மீண்டும் இயக்குவது பாதுகாப்பானது. பொருந்தும் உருப்படிகள் unchanged என்று சொல்லும்; மாறியவை மட்டுமே சேமிக்கப்படும்.

உருப்படி	எதன் மூலம் பொருத்தப்படுகிறது
மூலங்கள்	பெயர்
பதிவிறக்கிகள், media server-கள்	வகையும் முகவரியும்
அறிவிப்புகள்	பெயரும் வகையும்
வசனத் தளங்கள், முந்தைய பயன்பாடுகள்	வகை

முகவரியோ விசையோ மாறிய மூலமோ பதிவிறக்கியோ மீண்டும் இடைநிறுத்தப்படும். நீங்களே ஒன்றைத் தொடர்ந்த பிறகு, மீண்டும் இயக்கினால் அது ஓடிக்கொண்டே இருக்கும். indexers உருப்படியில் காலி api_key சேமித்த விசையை வைத்திருக்கும்; அதை நீக்க clear_key: true சேர்க்கவும்.

கோப்பை அழித்தல்

-delete உடன், எதுவும் தோல்வியடையாத ஓட்டத்துக்குப் பிறகு மட்டுமே, கட்டளை கோப்பைப் பூஜ்ஜியங்களால் மேலெழுதி அதை நீக்கும். Read-only mount-ஐ container-க்குள் இருந்து அழிக்க முடியாது, அதனால் host-இல் அழிக்கவும்:

அமைப்பு	கட்டளை
Linux	`shred -u holyarrs-secrets.yaml`
macOS	`rm -P holyarrs-secrets.yaml`
Windows	`Remove-Item holyarrs-secrets.yaml`, பிறகு Recycle Bin-ஐக் காலி செய்யவும்.

SSD-களிலும் copy-on-write கோப்பு முறைமைகளிலும், பழைய block-கள் வட்டில் இருக்கலாம். விசைகள் இப்போது குறியாக்கம் செய்யப்பட்ட vault-இல் உள்ளன.

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

அறிகுறி	காரணம்	தீர்வு
கோப்பை மற்ற பயனர்களும் படிக்க முடியும்	அனுமதிகள் மிகத் தளர்வு.	`chmod 600` இயக்கவும். Windows-இல், உங்களால் மட்டுமே திறக்கக்கூடிய அடைவில் வைக்கவும்.
தெரியாத விசை இறக்குமதியை நிறுத்தியது	எழுத்துப்பிழை அல்லது பெயரிடப்பட்ட வரியில் ஒரு tab.	அந்த வரியைச் சரிசெய்யவும். எதுவும் சேமிக்கப்படவில்லை.
Plain http மறுக்கப்பட்டது	`holyarrs` முகவரி இந்தக் கணினியில் இல்லை.	`http://127.0.0.1:6262` உடன் container-க்குள் இயக்கவும், அல்லது https பயன்படுத்தவும்.
வீட்டில் உள்ள பதிவிறக்கி பதிலளிக்கவில்லை	உள்ளூர் வலையமைப்பு அனுமதி இல்லை.	அந்தப் பகுதியில் `allow_local_network: true` அமைக்கவும்.
ஒருமுறை இயங்கும் container அடைவு உரிமையாளர்களை மாற்றியது	வேறு `PUID`/`PGID`.	பயன்பாட்டின் `PUID`, `PGID`-ஐப் பயன்படுத்தவும்.
`-delete` எதுவும் செய்யவில்லை	ஏதோ தோல்வியடைந்தது, அல்லது mount read-only.	Host-இல் அழிக்கவும்.

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

Flag-களும் exit code-களும்

Flag	செய்வது	இயல்புநிலை
`-file <path>`	ரகசியக் கோப்பு.	இல்லை
`-dry-run`	எவை அமைக்கப்படும் என்று மட்டும் சொல்லும்.	off
`-config <folder>`	Config அடைவு.	`/config`
`-delete`	தோல்விகள் இல்லாத ஓட்டத்துக்குப் பிறகு, கோப்பைப் பூஜ்ஜியங்களால் மேலெழுதி அழிக்கும்.	off
`-forget-move-credentials`	சேமித்த ஒவ்வொரு பழைய-பயன்பாட்டு விசையையும் அழித்து, பிறகு நிறுத்தும்.	off
`-allow-http-lan`	வீட்டு வலையமைப்பு முகவரிக்கு plain `http://`-ஐ அனுமதிக்கும். எச்சரிக்கையை அச்சிடும்.	off
`-allow-readable-file`	மற்ற பயனர்கள் படிக்கக்கூடிய கோப்பை ஏற்கும். Windows-இல் Docker Desktop ஒவ்வொரு கோப்பையும் படிக்கக்கூடியதாகக் காட்டும்.	off

holyarrs முகவரி https:// ஆக இருக்க வேண்டும், அல்லது இந்தக் கணினிக்கு மட்டும் plain http:// (127.0.0.1, ::1, localhost). Plain http-இல் உங்கள் உரிமையாளர் விசையும் முழுக் கோப்பும் குறியாக்கமின்றிப் பயணிக்கும்.

Exit code	பொருள்
`0`	ஒவ்வொரு உருப்படியும் நன்றாக முடிந்தது.
`1`	ஒரு உருப்படி தோல்வியடைந்தது. கோப்பைச் சரிசெய்து மீண்டும் இயக்கவும்.
`2`	தவறான கட்டளை வரி அல்லது கோப்பு.

வெளியீடு

ஒவ்வொரு உருப்படிக்கும் ஒரு வரி: set (சோதனை ஓட்டத்தில் would set, சில நேரம் ஒரு குறிப்புடன்), unchanged, skipped (empty), skipped (why) அல்லது failed: why. இது ஒருபோதும் விசை, கடவுச்சொல், token அல்லது முகவரியை அச்சிடாது. வரலாற்றில் எண்ணிக்கைகளுடன் மட்டும் ஒரு நிகழ்வு சேரும். உங்கள் கோப்பிலிருந்து ஒரு மதிப்பைக் காட்டக்கூடிய பிழை, அதற்குப் பதிலாக [hidden] என்று காட்டும்.

கோப்பு வடிவம்

YAML-இன் ஒரு சிறிய, கண்டிப்பான பகுதி:

இடைவெளிகளால் உள்தள்ளிய பகுதிகள், tab-கள் ஒருபோதும் இல்லை; பட்டியல்கள் - உடன்,
மதிப்புகள் எளிய உரையாக, "double quotes" அல்லது 'single quotes' உடன் (single quotes-க்குள் ஒரு ' எழுத இருமுறை எழுதவும்),
# ஒரு comment-ஐத் தொடங்கும், வரியின் தொடக்கத்தில் அல்லது quotes-க்கு வெளியே இடைவெளிக்குப் பிறகு, அதனால் # உள்ள கடவுச்சொல்லை quotes-க்குள் இடவும்,
&, *, !, |, >, [, {, %, @ அல்லது ஒரு backquote-உடன் தொடங்கும் மதிப்பையோ, : உள்ள மதிப்பையோ quotes-க்குள் இடவும்.

தெரியாத விசையோ 256 KB-ஐ விடப் பெரிய கோப்போ எதுவும் சேமிக்கப்படும் முன்பே முழு இறக்குமதியையும் நிறுத்தும்; செய்தி அந்த விசையையும் வரியையும் குறிப்பிடும். கோப்புக்கான இணைப்பு (link) மறுக்கப்படும்.

சிறப்புப் புலங்கள்

புலம்	விதி
SABnzbd	முழு `api_key` தேவை. `nzb_key`, பயனர் பெயர் அல்லது கடவுச்சொல் தவிர்க்கப்பட்டு ஒருபோதும் சேமிக்கப்படாது.
`tvdb.api_key`, `tvdb.unique_user_key`, `trakt.redirect_urls`	ஏற்கப்பட்டுத் தவிர்க்கப்படும்.
`smtp.host`	Server பெயர் மட்டும், scheme அல்லது port இல்லாமல்.
`smtp.port`	1 முதல் 65535. இயல்புநிலை `587`.
`smtp.from`	ஒரு எளிய email முகவரி.
பழைய-பயன்பாட்டுப் பகுதிகள்	Import from other apps-இல் Use the saved key (சேமித்த விசையைப் பயன்படுத்து) உடன் பயன்படும். ஒருபோதும் காட்டப்படாது, உரிமையாளர் மட்டும், ஒரு வெற்றிகரமான வாசிப்புக்குப் பிறகு அழிக்கப்படும்.

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

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