انتخاب npm برای مدیریت انتشار

Summarize this content to 400 words in Persian Lang
سلام!! 👋

وقتی زمان انتخاب یک ابزار انتشار و رجیستری بسته برای پروژه من فرا رسید، npm را انتخاب کردم. فراگیر بودن، سهولت استفاده و ادغام آن با جریان های کاری مدرن CI/CD، آن را به انتخابی ایده آل برای نیازهای من تبدیل کرده است.

ایجاد نسخه: فرآیند گام به گام

در اینجا شرح مفصلی از مراحلی است که من برای ایجاد یک نسخه با npm برای پروژه خود بدون موانع انجام دادم:

1. یک حساب و توکن npm تنظیم کنید

ابتدا یک حساب کاربری در npm ایجاد کردم. پس از ورود به حساب کاربری خود، یک نشانه npm از تنظیمات نمایه خود ایجاد کردم. این توکن برای احراز هویت با npm در طول فرآیند انتشار بسیار مهم است.

سپس این توکن را در مخزن GitHub پروژه خود ذخیره کردم تنظیمات > اسرار و متغیرها > اقدامات > راز مخزن جدید، با استفاده از کلید NPM_TOKEN. این تضمین می‌کند که گردش‌های کاری GitHub Actions من می‌توانند به طور ایمن به توکن دسترسی داشته باشند، بدون اینکه آن را در معرض عموم قرار دهند.

2. یک خط لوله GitHub CD را پیکربندی کنید

بعد، من یک فایل خط لوله اقدامات GitHub ایجاد کردم، cd.yml، در .github/workflows/ دایرکتوری این فایل فرآیند انتشار را خودکار می کند. در اینجا یک مثال ساده از آنچه که خط لوله ممکن است شبیه باشد آورده شده است:

name: CD Pipeline

on:
release:
types: [created]

jobs:
publish:
runs-on: ubuntu-latest

steps:
– name: Checkout code
uses: actions/checkout@v3

– name: Set up Node.js
uses: actions/setup-node@v3
with:
node-version: ’16’
registry-url: ‘https://registry.npmjs.org/’

– name: Install dependencies
run: npm install

– name: Publish to npm
env:
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
run: npm publish

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

3. انتشار را آماده کنید

پس از به روز رسانی پروژه خود، من:

تغییرات من را مرحله بندی و انجام داد:

git add .
git commit -m “Prepare for release”

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

یک تگ نسخه جدید با استفاده از npm ایجاد کرد:

npm version patch

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این به طور خودکار نسخه را به روز می کند package.json و یک تگ Git مربوطه ایجاد می کند.

همه چیز را به مخزن راه دور منتقل کرد:

git push origin main –tags

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

4. یک نسخه GitHub ایجاد کنید

در GitHub، من به آن پیمایش کردم منتشر می کند، کلیک کرد پیش نویس نسخه جدیدو برچسب آخرین نسخه را انتخاب کنید. پس از ارائه توضیحات، انتشار را منتشر کردم. این عمل باعث ایجاد خط لوله CD شد.

5. Release را تأیید کنید

هنگامی که خط لوله با موفقیت کامل شد، بسته من در npm منتشر شد و برای نصب کاربران آماده شد.

درس های آموخته شده

“آها!” لحظه: گم شده NPM_TOKEN

در ابتدا، خط لوله من با یک خطا در بیان آن شکست خورد NPM_TOKEN گم شده بود این به این دلیل بود که من راز GitHub را به درستی تنظیم نکرده بودم. وقتی راز را اضافه کردم، خط لوله به آرامی اجرا شد.

تکرار و اشکال زدایی

من مجبور شدم چندین بار تکرار کنم تا روند درست انجام شود. تعیین ترتیب صحیح مراحل و حصول اطمینان از پیکربندی صحیح همه وابستگی‌ها به آزمون و خطا نیاز داشت. مثلا فراموش کردم موارد اضافی را حذف کنم console.log اظهارات مربوط به موارد آزمایشی در اولین نسخه من، که باعث سردرگمی در طول آزمایش کاربر شد.

تست کاربر

از دوستم پیتر وان خواستم ابزار CLI من را با نصب مستقیم از رجیستری npm آزمایش کند. در ابتدا، او با غیر منتظره مواجه شد console.log خروجی ها پس از رفع این مشکل و انتشار نسخه جدید، پیتر نسخه به روز شده را با موفقیت آزمایش کرد.

این تمرین اهمیت آزمایش و پاکسازی کامل قبل از انتشار را تقویت کرد.

نصب و استفاده از پروژه

اکنون که پروژه منتشر شده است، کاربران می توانند آن را مستقیماً از npm نصب کنند. در اینجا به این صورت است:

بسته را به صورت سراسری نصب کنید:

npm install -g barrierless

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

از ابزار CLI استفاده کنید:

bl-bot -v

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

name: CD Pipeline

on:
  release:
    types: [created]

jobs:
  publish:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '16'
          registry-url: 'https://registry.npmjs.org/'

      - name: Install dependencies
        run: npm install

      - name: Publish to npm
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
        run: npm publish

   git add .
   git commit -m "Prepare for release"

   npm version patch

   git push origin main --tags

   npm install -g barrierless

   bl-bot -v