اتصال آن چه کمکی به شما میکند
اتصال GitLab امکان استقرار یک سایت از یکی از مخازن GitLab شما را فراهم میسازد، و در صورتی که آن را به عنوان میزبان سایت انتخاب کنید، به ما اجازه میدهد در حساب شما روی GitLab Pages منتشر کنیم.
قبل از شروع
یک حساب GitLab با دسترسی به پروژههایی که میخواهید مستقر کنید.
۱. کلید را در GitLab بسازید
در GitLab، آواتار خود را در بالا سمت راست انتخاب کنید، سپس به مسیر Edit profile → Access → Personal access tokens بروید، و یک توکن جدید ایجاد نمایید (GitLab ممکن است در منوی Generate token این مورد را با عنوان Legacy token مشخص کند). نامی برای آن تعیین کنید، یک تاریخ انقضا قرار دهید، و این محدودهها (scopes) را علامت بزنید:
روی Generate token کلیک کرده و آن را کپی کنید — GitLab فقط یک بار آن را نمایش میدهد.
۲. آن را در اینجا متصل کنید
بخش ادغامها را در داشبورد خود باز کرده و اتصال یک حساب را انتخاب نمایید. میزبانی کد را به عنوان گروه و GitLab را به عنوان حساب انتخاب کنید، توکن API را وارد نمایید، و روی اتصال حساب کلیک کنید.
ما پیش از ذخیره شدن هر چیزی، آنچه را جایگذاری میکنید آزمایش میکنیم. کلیدی که کار نمیکند هرگز ذخیره نمیشود، و پاسخ سیستم توضیح میدهد که اشکال آن چه بوده است. کلیدی که کار میکند بهصورت رمزگذاریشده در گاوصندوق اسرار ما نگهداری میشود — هرگز در پایگاه داده ما ذخیره نخواهد شد — و دیگر هرگز، حتی به شما، نشان داده نمیشود.
در ادامه چه رخ میدهد
- یک سایت میتواند مستقیماً از مخزنی روی این حساب مستقر شود: آن را در اتصال مخزن سایت انتخاب نمایید، مخزن و شاخه را تعیین کنید، و یک push فرآیند استقرار را انجام میدهد.
- هر شاخه دیگری میتواند پیشنمایش اختصاصی خود را داشته باشد، بنابراین میتوانید تغییرات را قبل از رسیدن به سایت فعال بررسی کنید.
- میزبانهای استاتیک مبتنی بر گیت مانند Render و Azure Static Web Apps از این اتصال به عنوان منبع کد سایت استفاده میکنند.
اگر متصل نشد
قبلاً کار میکرد و متوقف شد. توکنهای GitLab همیشه منقضی میشوند — معمولاً حداکثر یک سال پس از ساخت آنها — و GitLab قبل از انقضا به شما ایمیل میزند. یک توکن جدید ایجاد کرده و آن را متصل کنید.
یک scope وجود ندارد. محدودههای یک توکن پس از ایجاد قابل تغییر نیستند؛ یک توکن جدید ایجاد کنید که هر دو scope در آن علامت خورده باشند.
اعلام میشود که کلید رد شده است. تقریباً همیشه یکی از این سه مورد است: یک فاصله یا شکست خط همراه آن کپی شده، کلید منقضی شده، یا کلید پس از کپی کردن باطل شده یا دوباره ایجاد شده است. یک کلید جدید بسازید و دوباره آن را جایگذاری نمایید.
متصل میشود، اما بعداً مشکلی رخ میدهد. کلید احراز هویت میشود اما فاقد مجوزی است که اقدام مورد نظر نیاز دارد. یک کلید جدید با مجوزهای ذکرشده در بالا ایجاد کنید، سپس اتصال قدیمی را قطع نموده و کلید جدید را متصل کنید.
قطع اتصال
بخش ادغامها را باز کنید، حساب را بیابید و روی قطع اتصال کلیک نمایید. این کار کلید ذخیرهشده را فوراً حذف میکند. هر چیزی که از آن استفاده میکرده در اقدام بعدی خود متوقف میشود، و صفحاتی که به آن وابسته بودهاند به جای شکست بیصدا، این وضعیت را اعلام میکنند.
قطع اتصال کارهایی را که قبلاً انجام شده باطل نمیکند — سوابق، استقرارها یا تنظیماتی که در حساب شما تغییر دادهایم همانطور که هستند باقی میمانند. اگر فکر میکنید خود کلید ممکن است لو رفته باشد، آن را در ارائهدهنده نیز باطل کنید؛ قطع اتصال فقط نسخه ما را حذف میکند، نه نسخه آنها را.