با integration بین Postman و GitLab می‌توانید Postman Collectionهای خود را در یک GitLab project بکاپ بگیرید. GitLab یک ابزار Git repository manager است و می‌تواند collectionها و کد پروژه را کنار هم نگه دارد.
برای راه‌اندازی این integration باید یک GitLab personal access token داشته باشید و تنظیم کنید collectionها چطور در project ذخیره شوند.
ساخت GitLab Personal Access Token
- وارد GitLab شوید.
- اگر personal access token ندارید، از dashboard گیت‌لب یک token جدید بسازید.
- token را کپی کنید تا هنگام ساخت integration در Postman استفاده شود.
بکاپ گرفتن از Postman Collections در GitLab
- در صفحه Home پستمن وارد Integrations شوید. سپس Browse All Integrations را انتخاب کنید و GitLab را باز کنید.
- برای گزینه Backup a collection روی Add Integration کلیک کنید.
- GitLab personal access token را وارد کنید و روی Authenticate and Proceed کلیک کنید.
- در صفحه Configure یک nickname وارد کنید و workspace شامل collection مورد نظر را انتخاب کنید.
- Postman Collection، GitLab project و filename بکاپ را انتخاب یا وارد کنید.
- در Enter Directory (optional) یک directory سفارشی وارد کنید یا مقدار پیش‌فرض Postman Collections را نگه دارید.
- در Enter Branch (optional) یک branch برای commit مشخص کنید. اگر چیزی وارد نکنید، branch پیش‌فرض repository استفاده می‌شود.
- روی Add Integration کلیک کنید.
collection شما با نام فایلی که مشخص کرده‌اید، به شکل یک فایل JSON در GitLab project ذخیره می‌شود. Postman به صورت دوره‌ای collection را بررسی می‌کند و اگر تغییری ببیند، تغییرات را خودکار در repository commit می‌کند.
بکاپ گرفتن در GitLab روی دامنه سفارشی
اگر GitLab شما روی custom domain یا self-hosted است و شبکه پشت firewall قرار دارد، باید IP ثابت Postman را allowlist کنید:
- US East:
3.212.102.200
بعد از allowlist کردن این IP، integration می‌تواند به شبکه شما وصل شود.
- در Postman وارد Integrations شوید، Browse All Integrations را بزنید و GitLab را انتخاب کنید.
- برای Backup a collection (custom domain) روی Add Integration کلیک کنید.
- GitLab personal access token و دامنه GitLab سفارشی یا self-hosted خود را وارد کنید و روی Authenticate and Proceed کلیک کنید.
- collection موجود، GitLab Project و filename بکاپ را تنظیم کنید.
- در صورت نیاز directory و branch را مشخص کنید. branch مقصد باید از قبل وجود داشته باشد.
- روی Add Integration کلیک کنید.
بعد از راه‌اندازی، collection در directory مشخص‌شده و به صورت یک فایل JSON ذخیره می‌شود. می‌توانید وارد دامنه GitLab خود شوید و فایل‌های بکاپ‌شده را بررسی کنید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.