بتل کد Battle Codeدارد باز می‌شود…

خط تولید نرم‌افزار

از لحظه‌ای که کد را push می‌کنی تا وقتی به دست کاربر برسد، یک خط تولید خودکار در کار است. این هشت کلمه قدم‌ها و قاعده‌های همین خط‌اند، از CI تا شماره‌ی نسخه و یادداشت انتشار.

صفت‌های ‎-ous و قیدهای ‎-ly

continuous صفت است (پیوسته) و continuously قید (به‌طور پیوسته): «continuous integration» ولی «we deploy continuously». قاعده‌ی کلی: ‎-ly به آخر صفت که اضافه شود، قید می‌سازد و قید فعل را توصیف می‌کند، نه اسم را. مثال دیگر: automatic و automatically.

هشت کلمه‌ی این درس

continuous integration (کانتینیوئِس اینتِگرِیشِن): یکپارچه‌سازی پیوسته؛ ساخت و تست خودکار هر تغییر کد

continuous یعنی پیوسته و بی‌وقفه، و integration یعنی یکی کردن کار چند نفر. در continuous integration هر برنامه‌نویس تغییرهای کوچکش را زود و چند بار در روز به شاخه‌ی اصلی می‌فرستد و هر بار یک سرور خودکار کد را build می‌کند و همه‌ی تست‌ها را اجرا می‌کند. اگر چیزی خراب شود، همان چند دقیقه بعد معلوم می‌شود، نه یک ماه بعد که پیدا کردن مقصر سخت است.

Our continuous integration runs the tests on every push.

یکپارچه‌سازی پیوسته‌ی ما با هر push تست‌ها را اجرا می‌کند.

continuous delivery (کانتینیوئِس دیلیوِری): تحویل پیوسته؛ کدی که همیشه آماده‌ی انتشار است

delivery یعنی تحویل، مثل تحویل بسته‌ی پستی. continuous delivery قدم بعد از CI است: هر تغییری که تست‌ها را رد کند، خودکار آماده‌ی انتشار می‌شود، طوری که هر لحظه بتوانی با یک دکمه آن را روی سایت واقعی ببری. وقتی همان آخرین قدم هم خودکار شود و بدون دکمه منتشر شود، به آن continuous deployment می‌گویند.

With continuous delivery, we can release on any day, not only on Fridays.

با تحویل پیوسته می‌توانیم هر روزی منتشر کنیم، نه فقط جمعه‌ها.

workflow (وُرک‌فلو): گردش کار؛ زنجیره‌ی قدم‌هایی که پشت سر هم انجام می‌شوند

work یعنی کار و flow یعنی جریان، مثل جریان آب؛ workflow یعنی کارها به چه ترتیبی از دستی به دست دیگر جریان پیدا می‌کنند. در گفت‌وگوی روزمره یعنی روش کار یک تیم (مثلا «اول branch بساز، بعد pull request بده»). در ابزارهایی مثل GitHub Actions، workflow یک فایل YAML است که می‌گوید با چه اتفاقی چه قدم‌هایی خودکار اجرا شوند.

The deploy workflow starts when a new tag is pushed.

گردش کار deploy وقتی شروع می‌شود که یک tag تازه push شود.

build step (بیلد اِستِپ): یکی از قدم‌های خط ساخت و آماده‌سازی برنامه

step یعنی قدم یا پله. خط ساخت (pipeline) از چند build step پشت سر هم ساخته شده: گرفتن کد، نصب وابستگی‌ها، lint، اجرای تست‌ها، ساختن خروجی نهایی و ارسال آن. هر step اسم و دستور خودش را دارد و اگر یکی شکست بخورد، معمولا بقیه اجرا نمی‌شوند. مثل خط تولید کارخانه: هر ایستگاه کار خودش را می‌کند و محصول را به ایستگاه بعد می‌دهد.

The lint build step failed, so the tests did not run.

قدم lint شکست خورد، برای همین تست‌ها اجرا نشدند.

release candidate (ریلیس کَندیدِیت): نامزد انتشار؛ نسخه‌ای که اگر باگ نداشته باشد منتشر می‌شود

candidate یعنی نامزد، مثل نامزد یک انتخابات یا کسی که برای کاری مصاحبه می‌دهد. release candidate نسخه‌ای است که فکر می‌کنیم آماده‌ی انتشار است؛ همه‌ی ویژگی‌ها کامل شده‌اند و حالا فقط آزمایش می‌شود. اگر باگ مهمی پیدا نشود، همین نسخه بدون تغییر منتشر می‌شود. اگر پیدا شود، درستش می‌کنند و RC بعدی را می‌دهند.

Please test the release candidate and report any bugs before Monday.

لطفا نامزد انتشار را آزمایش کن و تا قبل از دوشنبه هر باگی بود گزارش بده.

version control (وِرژِن کَنترول): کنترل نسخه؛ نگه داشتن تاریخچه‌ی همه‌ی تغییرهای کد

version یعنی نسخه و control یعنی در اختیار داشتن. version control سیستمی است که هر تغییر فایل‌ها را با نام نویسنده، زمان و توضیح نگه می‌دارد، تا بتوانی ببینی چه کسی چه چیزی را کی عوض کرد، به هر نسخه‌ی قبلی برگردی و چند نفر همزمان روی یک پروژه کار کنند. مثل «تاریخچه‌ی نسخه‌ها»ی یک سند مشترک، ولی بسیار قوی‌تر. Git معروف‌ترین سیستم کنترل نسخه است.

Keep your config files under version control too.

فایل‌های تنظیماتت را هم زیر کنترل نسخه نگه دار.

semantic versioning (سِمَنتیک وِرژِنینگ): نسخه‌گذاری معنایی؛ شماره‌ی نسخه به شکل MAJOR.MINOR.PATCH

semantic یعنی «مربوط به معنی». در semantic versioning هر عدد شماره‌ی نسخه معنی دارد: در 2.5.1 عدد اول (major) وقتی بالا می‌رود که تغییری ناسازگار آمده و ممکن است کد کاربرها خراب شود، عدد دوم (minor) برای ویژگی تازه‌ای که چیزی را خراب نمی‌کند، و عدد سوم (patch) فقط برای رفع باگ. پس با دیدن شماره می‌فهمی به‌روزرسانی چقدر خطر دارد.

We follow semantic versioning, so 3.0.0 includes breaking changes.

ما نسخه‌گذاری معنایی را رعایت می‌کنیم، پس 3.0.0 تغییرهای ناسازگار دارد.

release notes (ریلیس نوتس): یادداشت انتشار؛ توضیح تغییرهای یک نسخه برای کاربرها

notes یعنی یادداشت‌ها. release notes متنی است که همراه هر نسخه‌ی تازه منتشر می‌شود و به زبان ساده می‌گوید چه چیزی اضافه شده، چه باگ‌هایی رفع شده و چه چیزی تغییر کرده که باید حواست به آن باشد. با changelog فرق کوچکی دارد: changelog فهرست کامل و فنی همه‌ی تغییرهاست ولی release notes برای خواننده‌ی معمولی نوشته می‌شود و مهم‌ها را می‌گوید.

Read the release notes before you upgrade to version 4.

قبل از ارتقا به نسخه‌ی ۴، یادداشت انتشار را بخوان.

یادداشت انتشار نسخه‌ی 3.2.0-rc.1

This is a release candidate. Please try it and report bugs before the final release next week.

We follow semantic versioning: this is a minor update, so nothing should break.

What changed:
- Our continuous integration workflow now runs the tests on Windows too.
- A new build step checks the size of the bundle.
- Continuous delivery: every merged pull request is ready to release.

The full list of changes is in version control. These release notes only show the important ones.

این یک نامزد انتشار است. لطفا امتحانش کنید و قبل از انتشار نهایی هفته‌ی بعد، باگ‌ها را گزارش بدهید.

ما نسخه‌گذاری معنایی را رعایت می‌کنیم: این یک به‌روزرسانی minor است، پس نباید چیزی خراب شود.

چه چیزهایی عوض شد:
- گردش کار یکپارچه‌سازی پیوسته‌ی ما حالا تست‌ها را روی ویندوز هم اجرا می‌کند.
- یک قدم ساخت تازه اندازه‌ی bundle را بررسی می‌کند.
- تحویل پیوسته: هر pull request که merge شود آماده‌ی انتشار است.

فهرست کامل تغییرها در سیستم کنترل نسخه هست. این یادداشت انتشار فقط مهم‌ها را نشان می‌دهد.