چگونه از Yarn برای مدیریت بسته‌های خصوصی استفاده کنیم؟

اگر تا به حال روی یک خط لباس بافتنی سفارشی یا یک پروژه نساجی خاص مشتری کار کرده‌اید، می‌دانید که مدیریت موجودی نخ‌های خود چقدر دشوار است - به خصوص زمانی که نیاز دارید بسته‌های نخ خصوصی و داخلی را به جریان‌های کاری تولید خود ببندید بدون اینکه رجیستری‌های عمومی npm را مسدود کنید. به‌عنوان کسی که 12 سال گذشته را صرف تهیه نخ‌های درجه یک برای پروژه‌های نساجی سفارشی و لباس‌های بافتنی کوچک کرده است، از نزدیک دیدم که وقتی تیم‌ها بسته‌های npm عمومی را با وابستگی‌های نخ خصوصی مخلوط می‌کنند، که منجر به تأخیر، مسائل مربوط به انطباق و حتی تعطیلی تولید می‌شود، چقدر آشفته است. به همین دلیل است که می‌خواهم دقیقاً نحوه استفاده از Yarn برای مدیریت بسته‌های نخ خصوصی را توضیح دهم - متناسب با نیازهای تامین‌کنندگان، برندهای لباس بافتنی، و تیم‌های تولیدی که به مواد سفارشی و خصوصی متکی هستند.

ابتدا، بیایید توضیح دهیم که بسته های نخ خصوصی در این زمینه به چه معنا هستند. برای تامین‌کننده نساجی مانند من، بسته‌بندی نخ خصوصی ممکن است یک ترکیب سفارشی باشد که ما منحصراً برای یک برند تولید کرده‌ایم - مثلاً یک مخلوط پشمی ضخیم و پایدار که برای خط زمستانی آنها طراحی شده است، یا یک نخ گیاهی رنگ‌شده با رنگدانه‌های غیر سمی و مخصوص برند که نمی‌خواهند رقبای عمومی به آن دسترسی داشته باشند. این بسته‌ها فقط یک کد نیستند (صبر کنید، نه - برای کسانی از شما که از Yarn برای وابستگی‌های پروژه استفاده می‌کنید، یک بسته نخ خصوصی را به عنوان مجموعه‌ای انتخاب‌شده و غیرعمومی از مواد نخ مرتبط با یک SKU یا دوره تولید خاص در نظر بگیرید). صبر کنید، برای اینکه این موضوع برای هر مخاطبی قابل ارتباط باشد - چه توسعه‌دهنده‌ای باشید که از Yarn برای کد استفاده می‌کند، چه یک طراح لباس بافتنی و یا یک مدیر تولید که موجودی را ردیابی می‌کند - بیایید این شکاف را پر کنیم: Yarn، مدیر بسته محبوب، زمانی که بسته‌های خصوصی خود را به عنوان مجموعه‌های نسخه‌شده و با دسترسی محدود ساختار می‌دهید، هم برای کد نرم‌افزار و هم برای کالاهای فیزیکی کار می‌کند. این زاویه‌ای است که من در اینجا روی آن تمرکز می‌کنم، زیرا این دقیقاً همان موردی است که تیم خودمان روزانه با آن سروکار دارد.

بنابراین، مرحله اول: یک رجیستری Yarn خصوصی راه‌اندازی کنید که فقط شرکا، برندها یا تیم‌های داخلی مورد تایید شما می‌توانند به آن دسترسی داشته باشند. برای اکثر تامین کنندگان نساجی (و حتی استودیوهای طراحی کوچک)، این نیاز به سرمایه گذاری هنگفتی ندارد. در دسترس ترین گزینه برای ما یک رجیستری خود میزبان با استفاده از ابزارهایی مانند Verdaccio است—نرم افزار منبع باز که به شما امکان می دهد بسته های Yarn خصوصی خود را روی سرور خود میزبانی کنید، بنابراین شما کنترل می کنید که چه کسی می تواند آنها را بکشد. برخلاف ثبت‌های عمومی، که هر کسی می‌تواند آنها را مرور کند، یک رجیستری خصوصی به شما امکان می‌دهد نقش‌های کاربری را تنظیم کنید: مدیر تولید یک برند می‌تواند ترکیب انحصاری پشم ترمه پشمی خود را (به هر حال، نخ ترکیبی پشمی پشمی عملی ما - فقط برای مشتریان از قبل تأیید شده با قراردادهای سفارشی در دسترس است) بدون اینکه به طور عمومی در فهرست کپی‌های عمومی قرار گیرد. اگر عرضه‌کننده یا برند کوچک‌تری هستید که نمی‌خواهید یک سرور کامل داشته باشید، رجیستری‌های خصوصی مدیریت‌شده نیز وجود دارند، مانند بسته‌های GitHub یا بسته‌های GitLab که به‌طور یکپارچه با Yarn ادغام می‌شوند. ما از هر دو استفاده می‌کنیم: Verdaccio برای موجودی نخ‌های خام داخلی و بسته‌های GitHub برای SKUهای نخ بافتنی منحصر به فرد شریکمان.

هنگامی که رجیستری خصوصی شما راه اندازی شد، به جای رجیستری عمومی npm پیش فرض، باید Yarn را طوری پیکربندی کنید که به آن اشاره کند. این مرحله ای است که بسیاری از کاربران جدید را جذب می کند - به خصوص اگر آنها فقط به دویدن عادت داشته باشنداضافه کردن نخبرای بسته های عمومی برای تنظیم این، خود را ویرایش کنید.yarnrc.ymlفایل (اگر از Yarn 2 یا 3 استفاده می کنید که ما در اینجا در تیم تامین کننده خود استانداردسازی کرده ایم) یا قدیمیnpmrcفایل برای نخ 1. برای راه‌اندازی خود، دو محدوده اضافه کردیم: یکی برای مواد خام نخ و دیگری برای بسته‌های مخصوص بافتنی تمام شده. پیکربندی چیزی شبیه به این است:

npmScopes: our-supplier-name: npmRegistryServer: "https://registry.oursupplier.com" npmAlwaysAuth: true npmAuthToken: "${NPM_AUTH_TOKEN}"

این به Yarn می‌گوید که پیشوند هر بسته با@our-supplier-name/باید از رجیستری خصوصی ما خارج شود نه از ثبت عمومی. به این ترتیب، وقتی یک برند می خواهد نخ انحصاری خود را به کتابخانه تولیدی خود اضافه کند، فقط اجرا می کندنخ اضافه @our-supplier-name/practical-wool-cashmere-blend-yarnو مستقیماً از رجیستری خصوصی ما خارج می شود، بدون نیاز به دسترسی عمومی.

بعد، چگونه بسته های نخ خصوصی خود را در رجیستری منتشر می کنید؟ این جایی است که ما طی سال‌ها فرآیند خود را اصلاح کرده‌ایم، بنابراین سریع و بدون خطا است. ابتدا مطمئن شوید که بسته شما به درستی نسخه شده است. برای نخ‌های خام مانند نخ 100% Silk Raw Yarn ما از نسخه‌سازی معنایی استفاده می‌کنیم:1.0.0برای دسته تولید اولیه،1.1.0برای یک تنظیم جزئی رنگ،1.0.1برای یک تغییر کوچک در قدرت پیچش. به این ترتیب، اگر خط تولید یک برند به یک نسخه خاص متکی باشد، آنها به طور تصادفی دسته‌ای دریافت نمی‌کنند که با الگوی آن‌ها مطابقت ندارد (مانند ژاکت‌های کریسمس با الگوهای روشنایی که نیاز به یک گیج نخ بسیار خاص دارند).

صبر کنید، بیایید آن را بتن کنیم. سه ماهه گذشته، مشتری به ما مراجعه کرد که برای خط ژاکت های کریسمس سفارشی خود به نخ نیاز داشت – به ویژه، نخی که می توانست چراغ های LED کوچک دوخته شده را بدون کشش یا شکستن نگه دارد. ما یک ترکیب نخ خصوصی را به طور انحصاری برای آنها ایجاد کردیم، با نسبت اندازه گیری و کشش منحصر به فرد. به‌جای اینکه آن نخ را در سایت عمومی خود فهرست کنیم، آن را به‌عنوان یک بسته Yarn خصوصی در رجیستری خود منتشر کردیم و به تیم برند دسترسی وسیعی دادیم. وقتی آنها دویدندyarn add @our-supplier-name/christmas-lights-yarn، دقیقاً نسخه مناسب را کشید و هیچ مارک دیگری نتوانست به آن دسترسی پیدا کند. این قدرت بسته‌های خصوصی برای تامین‌کنندگان نساجی است: شما فقط یک محصول را نمی‌فروشید، بلکه از فرمول‌های سفارشی و طرح‌های منحصربه‌فرد مشتریانتان محافظت می‌کنید.

برای انتشار یک بسته نخ خصوصی، ابتدا با استفاده از رجیستری خود احراز هویت کنیدyarn login --registry=https://registry.oursupplier.com. با این کار یک نام کاربری و رمز از شما می‌خواهد—یک توکن منحصر به فرد برای هر تیم یا برندی که با آن کار می‌کنید ایجاد کنید، بنابراین می‌توانید در صورت پایان شراکت، در هر زمانی دسترسی را لغو کنید. پس از احراز هویت، به دایرکتوری بسته خود بروید (برای نخ خام ابریشم 100% ما، این پوشه با مشخصات فنی، شماره دسته و جزئیات مواد است) و اجرا کنید.نخ انتشار --registry=https://registry.oursupplier.com. این بسته شما را بسته بندی می کند، نسخه را اختصاص می دهد و آن را فقط به رجیستری خصوصی شما منتقل می کند. هیچ کس خارج از لیست کاربران تایید شده شما نمی تواند آن را ببیند یا دانلود کند.

اکنون، بیایید در مورد مدیریت دسترسی صحبت کنیم، که اگر تامین کننده ای هستید که با چندین برند کار می کنید بسیار مهم است. شما نمی خواهید یک شریک جدید به طور تصادفی به پکیج نخ انحصاری برند دیگری دسترسی پیدا کند، درست است؟ با رجیستری‌های خصوصی Yarn، می‌توانید مجوزهای دانه‌بندی را تنظیم کنید: برای مثال، برای بسته‌های GitHub، می‌توانید حساب GitHub یک نام تجاری را به‌عنوان همکار تنها در بسته‌های نخ خاص آن‌ها اضافه کنید. برای Verdaccio، می‌توانید گروه‌های کاربری ایجاد کنید—ما گروه‌هایی مانند این داریمشرکای تایید شده،تولید داخلی،دسته های آزمایشی، و غیره. گروه شرکای بافتنی می‌تواند به تمام بسته‌های نخ بافتنی خصوصی ما دسترسی داشته باشد (مانند ژاکت بافتنی ژاکت‌آستین بلند ژاکت مردانه ژاکت یکنواخت، که یک SKU خصوصی محبوب برای مارک‌های لباس مردانه است)، اما نمی‌تواند به موجودی نخ خام ما برای صنایع دیگر، مانند اثاثه یا لوازم داخلی خودرو دسترسی داشته باشد. این سطح از کنترل به همین دلیل است که بسته‌های خصوصی برای تامین‌کنندگان نساجی بسیار خوب کار می‌کنند—شما دسترسی به نیازهای هر مشتری را تنظیم می‌کنید، بدون اشتراک‌گذاری بیش از حد.

اشتباه رایجی که می بینیم تامین کنندگان جدید مرتکب می شوند، ترکیب بسته های خصوصی و عمومی بدون محدوده مناسب است. به عنوان مثال، اگر یک نخ عمومی را در سایت عمومی خود فهرست کنید، اما همان نخ را به عنوان یک بسته خصوصی منتشر کنید، می توانید با عدم تطابق نسخه ها مواجه شوید. ما این مشکل را با جدا کردن تمام نخ‌های سفارشی و خاص خود در بسته‌های Yarn خصوصی و نخ‌های خارج از قفسه (که به هر مشتری فروخته می‌شود) به بسته‌های عمومی برطرف کردیم. به این ترتیب، وقتی مشتری نخ ترکیبی ترمه پشمی کاربردی ما را از سایت عمومی ما خریداری می‌کند، این یک بسته عمومی است، و وقتی یک برند یک ترکیب سفارشی با همان پایه ترمه پشمی دارد، یک بسته خصوصی با یک نسخه منحصر به فرد و مشخصات اضافه شده است. بدون سردرگمی، بدون خطا.

یکی دیگر از مزایای بزرگ استفاده از Yarn برای بسته های نخ خصوصی این است که با ابزار تولید و موجودی شما یکپارچه می شود. ما از ویژگی lockfile Yarn برای ردیابی دقیق اینکه هر دوره تولیدی از کدام نسخه نخ استفاده می کند استفاده می کنیم. بنابراین، وقتی تیم تولید یک برند اجرا می شودنصب نخ، فایل قفل تضمین می کند که آنها دقیقا همان دسته نخی را که ما مشخص کرده ایم دریافت می کنند - بدون جایگزین، بدون تغییر، که برای لباس بافتنی که حتی یک تغییر 5٪ در گیج می تواند یک خط کامل را خراب کند، بسیار بزرگ است. برای مثال، زمانی که یک برند در حال کار بر روی ژاکت زنانه کنتراست آستین بلند کریسمس بود، فایل قفل آنها بسته نخ خصوصی ما را به نسخه سنجاق کرد.1.2.0، که کشش دقیق مورد نیاز برای کاف های کنتراست را داشت. وقتی نسخه جدید را منتشر کردیم1.2.1با یک تنظیم جزئی رنگ، آنها آن را دریافت نکردند مگر اینکه به صراحت اجرا کنندارتقاء نخ، که دقیقاً همان چیزی است که ما برای یک محصول سفارشی می خواستیم.

اکنون، بیایید عیب‌یابی را پوشش دهیم، زیرا حتی با یک راه‌اندازی محکم، همه چیز اشتباه می‌شود. رایج‌ترین مشکلی که با آن مواجه می‌شویم، خرابی‌های احراز هویت هنگام کشیدن یک بسته خصوصی است. اگر تیم یک برند هنگام اجرا با خطایی مانند «401 غیر مجاز» مواجه شوداضافه کردن نخ، تقریباً همیشه به این معنی است که رمز تأیید اعتبار آنها منقضی شده است یا به آن بسته خاص دسترسی ندارند. ما ارسال توکن منحصربه‌فرد هر برند را از طریق یک کانال امن مشخص می‌کنیم و 30 روز قبل از انقضای یک توکن به آنها اطلاع می‌دهیم تا بتوانند یک توکن جدید درخواست کنند. یکی دیگر از مشکلات رایج، دامنه نادرست در پیکربندی Yarn است - اگر تیمی فراموش کند که آن را اضافه کند@our-supplier-name/پیشوند، Yarn سعی خواهد کرد نسخه عمومی را که با محصول سفارشی آنها مطابقت ندارد، بکشد. ما یک راهنمای سریع در سایت داخلی خود داریم که تیم ها را از طریق بررسی آنها راهنمایی می کند.yarnrc.ymlفایل، و ما همه بسته‌های خصوصی خود را قبل از راه‌اندازی با یک حساب نام تجاری آزمایشی آزمایش می‌کنیم.

برای تامین‌کنندگان کوچک یا استودیوهای طراحی که نمی‌خواهند یک رجیستری خصوصی کامل را مدیریت کنند، یک جایگزین ساده‌تر وجود دارد: میزبانی بسته‌های نخ خصوصی در یک مخزن خصوصی GitHub. Yarn می‌تواند بسته‌ها را مستقیماً از GitHub با استفاده از URL مانند بکشدhttps://github.com/our-supplier-name/private-yarn-package#1.0.0. این برای تیم های کوچکتر عالی کار می کند، زیرا نیازی به راه اندازی یک سرور رجیستری جداگانه ندارید. ما از این برای کوچکترین مشتریانمان، مانند طراحان لباس بافتنی مستقل، که فقط به یک یا دو بسته نخ خصوصی نیاز دارند، استفاده کرده ایم. نکته منفی این است که GitHub همان کنترل های دسترسی گرانول را به عنوان یک رجیستری اختصاصی ارائه نمی دهد، بنابراین باید مراقب باشید که به چه کسانی به مخزن دسترسی می دهید.

حالا بیایید به این موضوع برگردیم که چرا این برای همه مهم است. به عنوان یک تامین کننده نخ، وظیفه ما فقط فروش مواد نیست - بلکه کمک به مشتریانمان است که طرح های منحصر به فرد خود را بدون نگرانی در مورد کپی برداری از فرمول های رقبا یا تاخیر در تولید از دسته های نخ اشتباه، زنده کنند. استفاده از Yarn برای مدیریت بسته‌های خصوصی به ما امکان می‌دهد این کار را انجام دهیم: ما کنترل می‌کنیم که چه کسی به کدام نخ دسترسی دارد، نسخه‌ها را برای سازگاری دنبال می‌کنیم، و فرآیند را برای مشتریانمان ساده می‌کنیم تا دقیقاً آنچه را که نیاز دارند به دست آورند. اگر برندی هستید که به دنبال محافظت از طرح‌های بافتنی سفارشی خود هستید، یا عرضه‌کننده‌ای هستید که می‌خواهد SKUهای خصوصی را بدون دردسر صفحه‌گسترده یا ردیابی دستی موجودی ارائه دهد، سیستم بسته‌های خصوصی Yarn یک تغییر دهنده بازی است.

اگر آماده راه‌اندازی بسته‌های خصوصی نخ برای محصولات نخ یا پروژه‌های نساجی سفارشی خود هستید، تیم ما اینجاست تا به شما کمک کند. ما با برندهای لباس بافتنی، استودیوهای طراحی و تولیدکنندگان پارچه کار می‌کنیم تا هم نخ‌های خصوصی و هم بدون قفسه عرضه کنیم، و می‌توانیم شما را در راه‌اندازی دسترسی، مدیریت نسخه‌ها و ادغام بسته‌های خصوصی در جریان کار تولیدتان راهنمایی کنیم. امروز با تیم ما تماس بگیرید تا در مورد نیازهای خاص خود صحبت کنید، چه به دنبال یک ترکیب سفارشی، یک SKU خصوصی از پیش تأیید شده یا راهنمایی در مورد راه اندازی رجیستری Yarn خصوصی خود باشید.

مراجع

1. مستندات رسمی نخ. (دوم). بسته های خصوصی برگرفته از https://yarnpkg.com/features/private-packages
2. رجیستری متن باز Verdaccio. (دوم). شروع کار با بسته های نخ خصوصی. برگرفته از https://verdaccio.org/docs/
3. npm Inc. (nd). محدوده های npm و بسته های خصوصی. برگرفته از https://docs.npmjs.com/about-scopes
4. مجله دنیای نساجی. (2023). مدیریت موجودی نخ سفارشی برای تولید دسته‌ای کوچک. برگرفته از https://textileworld.com/articles/managing-custom-yarn-inventory