دفترچه

یادداشت‌های کوتاه و عملیاتی ابر رها برای مشتری‌ها

---

این‌جا چیست؟

یادداشت‌های کوتاه فارسی برای کار روزمره با ابزارهایی که زیرساخت شما روی آن‌ها بالاست — Kubernetes، SOPS، Helm و بقیه. هر یادداشت یک PDF یکی‌دو صفحه‌ای است که کنار ترمینال باز می‌ماند: همان چند فرمانی که در یک هفته‌ی عادی لازم می‌شود، با توضیح فارسی و بدون حاشیه.

این‌ها آموزش عمیق نیستند و قرار هم نیست باشند. مرزشان جایی است که کار از روال روزمره خارج می‌شود: عیب‌یابی، وضعیت‌های خراب، تغییر پایدار روی کلاستر و هر چیزی که ریشه‌یابی می‌خواهد، کارِ تیم ابر رهاست. هر یادداشت با همین جمله تمام می‌شود و شماره‌ی تماس ما را همان‌جا دارد.

یادداشت‌ها

یادداشت	موضوع	PDF
note_kubernetes_daily	کار روزمره با kubectl — وضعیت، لاگ، exec، port-forward، ری‌استارت	PDF
note_sops_daily	نگهداری رمزها با SOPS و age — ساختن کلید، خواندن، ویرایش، و یک نمونه‌ی کامل برای Django	PDF
note_helm_daily	دیدن و برگرداندن نصب‌ها با Helm — values، history، rollback	PDF

PDFها در همین مخزن کامیت شده‌اند؛ برای خواندن لازم نیست چیزی build کنید. کافی است روی لینک بزنید یا مخزن را clone کنید.

ساختن PDFها

نیاز به Typst و فونت Vazirmatn:

just               # همه‌ی یادداشت‌ها
just one sops_daily    # فقط یکی
just watch sops_daily  # بازسازی زنده هنگام ویرایش
just verify        # چک این‌که همه کامپایل می‌شوند (همان کاری که CI می‌کند)
just clean         # پاک کردن PDFها

نسخه‌ها

هر تگ v* که push شود، یک release پیش‌نویس می‌سازد و همه‌ی PDFها را — تک‌تک، به‌علاوه‌ی یک daftarche-<tag>.zip از همه‌شان — به آن می‌چسباند:

git tag v1.1.0
git push origin v1.1.0

release پیش‌نویس است، یعنی تا وقتی خودتان در گیت‌هاب منتشرش نکنید جایی دیده نمی‌شود؛ فرصت دارید متن آن را ویرایش کنید. اگر همان تگ را دوباره push کنید، فایل‌های release موجود جایگزین می‌شوند و پیش‌نویس دست‌نخورده می‌ماند.

همان بسته را می‌توانید محلی هم بسازید:

just package v1.1.0   # خروجی در dist/

نوشتن یادداشت تازه

قالب مشترک در lib/note.typ است — نشان ابر رها، رنگ‌های برند، جعبه‌های «نکته» و «مراقب باشید» و «کار ما»، و جعبه‌ی پایانی تماس که خودکار به انتهای هر یادداشت اضافه می‌شود. قواعد نوشتن در CLAUDE.md آمده است.

#import "/lib/note.typ": *
#show: note.with(title: "عنوان یادداشت", tool: "Tool", updated: "۱۴۰۵/۰۶/۰۱")

این سربرگ رسمی شرکت نیست

یادداشت‌ها نشان ابر رها را دارند ولی روی فرم رسمی شرکت (letterhead) نیستند — آن فرم برای نامه، قرارداد و صورتحساب است و در مخزن خصوصی rahacloud/documents می‌ماند. این‌جا یک صفحه‌آرایی سبک‌تر است که فقط برند را حمل می‌کند.

پروانه

Unlicense — این یادداشت‌ها برای استفاده‌ی آزاد مشتری‌ها و هر کس دیگری نوشته شده‌اند.