npm reyestri paket sahəsinə görə seçsin, VPN-ə görə yox

VPN-ə qoşulmaq npm-in reyestr parametrini gündə iki dəfə redaktə etmək demək olmamalıdır. Layihə səviyyəsindəki konfiqurasiya faylındakı sahə qeydi şirkət paketlərini bir reyestrə, qalan hər şeyi isə açıq reyestrə göndərə bilər, nə keçid, nə də cümə günü axşamı geridə qalan bir ləğv olmadan. İncə məqam budur ki, bu yalnız adlandırmanı həll edir; marşrutlaşdırma, etimad məlumatları və konfiqurasiya prioriteti hər biri öz qaydasında uğursuz olan üç ayrı şeydir.

İki ad, iki təyinat

npm paket adının ya sahəsi var, ya yox. Sahəli ad @ işarəsi və sahə identifikatoru ilə başlayır və konfiqurasiyanın xəritələyə bildiyi məhz həmin identifikatordur. Paketlə bağlı başqa heç nə xəritələmə üçün əhəmiyyətli deyil. Reyestr paketin daxili və ya açıq olmasına görə heç vaxt sorğu görmür; o yalnız ad görür.

Beləliklə, aşağıdakı fayl üç sətirdə iki niyyət ifadə edir: açıq paketlər açıq reyestrə gedir, şirkət sahəsi altındakı paketlər isə həmin host üçün tokenlə birlikdə şirkət reyestrinə gedir.

registry=https://registry.npmjs.org/
@acme:registry=https://packages.corp.example/
//packages.corp.example/:_authToken=${NPM_TOKEN}

Sahəni, hostu və dəyişən adını təşkilatın həqiqətən təmin etdiyi ilə əvəz edin. Əhəmiyyətli olan strukturdur, nümunə dəyərlər deyil. İki sətir konfiqurasiya bütün siyasəti daşıyır, buna görə də onları kopyalamaq əvəzinə başa düşməyə dəyər.

Xəritələməni və şəbəkəni beyninizdə ayrı bölmələrdə saxlayın. Sahə qeydi əlçatmaz hostu əlçatan edə bilməz və işləyən tunel npm-ə paketin hansı reyestrə aid olduğunu deyə bilməz.

Faylı düzgün ardıcıllıqla yazın

npm bir neçə fayl oxusa da, düşüncənizdə layihə faylını birinci qoyun. Layihə qovluğundakı .npmrc həmkarlarınızın repozitoriya vasitəsilə miras aldığı fayldır, ona görə də şəxsi tokeninizi deyil, ortaq siyasəti ifadə etməlidir. Həmin fayl həm də rəyçinin oxuyacağı fayldır. Onu bir baxışda nəzərdən keçiriləcək qədər kiçik saxlayın.

Defolt registry sətrini təşkilat başqa qərar vermədikcə açıq reyestrə işarə edən vəziyyətdə buraxın. Onu silmək maşını istifadəçi səviyyəsindəki faylın dediyindən asılı hala gətirir və bu, iki noutbukda fərqli nəticələr verən məhz həmin gizli asılılıqdır.

Sahə sətri vəhşi kart deyil. Sahə xaricindəki ad defoltdan istifadə etməyə davam edir və bu, özünüz yazmadığınız hər asılılıq üçün istədiyiniz davranışdır.

Faylı təhvil verməzdən əvvəl onun nəyə həll olunduğunu yoxlayın, real quraşdırma əvəzinə birdəfəlik paket adı ilə, belə ki səhv heç nəyə başa gəlməsin.

Etimad məlumatları layihəyə deyil, hosta aiddir

Doğrulama qeydləri reyestr hostuna və reyestrin tələb etdiyi yerdə bir yola bağlanır. Buna görə token sətri sahə ilə deyil, ikiqat maili xətt və hostla başlayır. Hostu o mövqedə gördükdən sonra sətrin qalanı təsadüfi durğu işarələri kimi görünməyi dayandırır. Bu bir ünvandır və token ona bağlanıb.

Mühit dəyişənindən istifadə hərfi tokeni repozitoriyadakı fayldan kənarda saxlayır. Bu, tokeni hər yerdə görünməz etmir; o, yenə proses mühitində görünür və konfiqurasiyanı çap edən əmr onu aşkara çıxara bilər.

Dəyişəni təşkilatın təsdiqlədiyi hər hansı yerli və ya CI etimad mexanizmi vasitəsilə təmin edin və sənədlərə kopyalana biləcək bir nümunəyə heç vaxt real token yapışdırmayın.

Əgər iki reyestr iştirak edirsə, hər biri öz qeydini alır. Tək bir kvalifikasiyasız token parametri ən yaxşı halda qeyri-müəyyəndir, ən pis halda isə səhv hosta göndərilir.

Səhv reyestr qalib gələndə

Konfiqurasiya qat-qatdır və qüvvədə olan dəyər yenicə redaktə etdiyiniz fayldakı dəyər olmaya bilər. Layihə parametrləri, istifadəçi parametrləri, qlobal parametrlər və mühit dəyişənləri hamısı iştirak edir. Bu qatlılıq düzəlişin sizin maşınınızda işləyib həmkarınızın konteynerində işləməməsinin səbəbidir. Həm də buna görə effektiv dəyəri mübahisə etməzdən əvvəl çap etməyə dəyər.

Mühit dəyişəni CI-da adi günahkardır: iş reyestri bir dəfə qurur və hər sonrakı addım onu miras alır. İkinci ən çox rast gəlinən hal tərtibatçının maşınındakı istifadəçi səviyyəsindəki faylın repozitoriyanın dediyini üstələməsidir.

Başqa heç nəyi sazlamadan əvvəl effektiv konfiqurasiyanı və bir sahəli, bir sahəsiz ad üçün həll olunmuş reyestri çap edin. Bu iki cavab gözlədiyiniz kimidirsə, problem şəbəkədədir; deyilsə, problem konfiqurasiyadadır və nə qədər VPN işi kömək etməyəcək.

Təhvil verməzdən əvvəl yoxlama siyahısı

Sahə adının həqiqətən dərc olunmuş paketlərə uyğun olduğunu, defolt reyestrin açıq şəkildə göstərildiyini və token sətrinin düzgün hostu adlandırdığını təsdiqləyin. Sahədəki yazı səhvi ən qəribə uğursuzluğu yaradır, çünki paket açıq reyestrdən həll olunur və eyni adlı başqasının modulunu qaytarır. Tokeni sazlamadan əvvəl adı yoxlayın.

Özəl reyestrin quraşdırmanı işlədən kontekstdəki maşından əlçatan olduğunu təsdiqləyin, sadəcə brauzerinizdən deyil. Bu fərq proxy və ya konteynerin qabığınızdan fərqli marşrutlaşdırması olduqda əhəmiyyətli olur.

Sonra keşlənmiş paketlər olmayan təmiz çıxarışda davranışı təsdiqləyin. Təzə quraşdırma yeni həmkarınızın nə yaşayacağını göstərən yeganə sınaqdır.