حساب GitLab خود را متصل کنید تا سایت‌های شما از یک مخزن مستقر شوند

مزایای اتصال آن

اتصال GitLab به یک وب‌سایت امکان می‌دهد تا از یکی از مخازن GitLab شما مستقیماً مستقر شود و به ما اجازه می‌دهد در صورت انتخاب به‌عنوان میزبان وب‌سایت، محتوا را در حساب شما روی GitLab Pages منتشر کنیم.

پیش از شروع

یک حساب GitLab با دسترسی به پروژه‌هایی که می‌خواهید مستقر کنید.

۱. ایجاد کلید در GitLab

در GitLab، روی آواتار خود در بالا سمت راست کلیک کرده، سپس Edit profile → Access → Personal access tokens را انتخاب کنید و یک توکن جدید بسازید (ممکن است GitLab در منوی Generate token این مورد را با برچسب Legacy token نشان دهد). به آن نامی بدهید، تاریخ انقضایی تعیین کنید و این دامنه‌های دسترسی (scopes) را علامت بزنید:

• api
• write_repository

روی Generate token کلیک کرده و آن را کپی کنید — GitLab آن را فقط یک بار نمایش می‌دهد.

۲. اتصال آن در اینجا

بخش Integrations را در داشبورد خود باز کرده و Connect an account را انتخاب کنید. گزینه Code hosting را به عنوان گروه و GitLab را به عنوان حساب انتخاب کنید، فیلد API token را پر کنید و روی Connect account کلیک کنید.

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

مراحل بعدی

• یک وب‌سایت می‌تواند مستقیماً از مخزنی روی این حساب مستقر شود: آن را در بخش اتصال مخزن وب‌سایت انتخاب کنید، مخزن و شاخه (branch) را مشخص کنید تا با هر بار ارسال (push) استقرار انجام شود.
• هر شاخه دیگری می‌تواند پیش‌نمایش مختص به خود را داشته باشد، بنابراین می‌توانید تغییرات را پیش از رسیدن به سایت اصلی بررسی کنید.
• میزبان‌های استاتیک مبتنی بر Git مانند Render و Azure Static Web Apps از این اتصال به عنوان منبع کد وب‌سایت استفاده می‌کنند.

اگر اتصال برقرار نشد

کار کرد و سپس متوقف شد. توکنی‌های GitLab همیشه منقضی می‌شوند — معمولاً حداکثر یک سال پس از ایجاد — و GitLab پیش از آن به شما ایمیل می‌زند. یک توکن جدید بسازید و آن را متصل کنید.

دامنه دسترسی (scope) گم شده است. دامنه‌های دسترسی یک توکن پس از ایجاد قابل تغییر نیستند؛ توکن جدیدی با هر دو دامنه دسترسی علامت‌گذاری‌شده بسازید.

پیام رد شدن کلید نمایش داده می‌شود. تقریباً همیشه یکی از این سه مورد است: وجود فاصله یا شکست خط در متن کپی‌شده، منقضی شدن کلید، یا لغو/بازسازی کلید پس از کپی کردن آن. یک کلید تازه بسازید و دوباره آن را جای‌گذاری کنید.

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

قطع اتصال

بخش Integrations را باز کنید، حساب مورد نظر را پیدا کرده و روی Disconnect کلیک کنید. این کار کلید ذخیره‌شده را بلافاصله حذف می‌کند. هر فرآیندی که از آن استفاده می‌کرده در اقدام بعدی متوقف می‌شود و صفحات وابسته به آن به جای شکست بی‌صدا، این موضوع را اعلام می‌کنند.

قطع اتصال کارهایی را که قبلاً انجام شده است لغو نمی‌کند — سوابق، استقرارها یا تنظیماتی که در حساب شما تغییر داده‌ایم به همان شکل باقی می‌مانند. اگر فکر می‌کنید ممکن است خود کلید افشا شده باشد، آن را در سایت ارائه‌دهنده نیز لغو کنید؛ قطع اتصال فقط نسخه ما را حذف می‌کند، نه نسخه آن‌ها را.