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

اتصال آن چه کمکی به شما می‌کند

اتصال GitHub با یک توکن به یک وب‌سایت امکان می‌دهد از یکی از مخازن شما مستقر شود: کافی است تغییرات را به شاخه ارسال کنید تا وب‌سایت به‌روزرسانی شود. همچنین به ما امکان می‌دهد در صورتی که GitHub Pages را به عنوان میزبان وب‌سایت انتخاب کنید، آن را روی حساب کاربری شما منتشر کنیم.

اگر مخازن شما متعلق به یک سازمان است، ترجیحاً از برنامه Zinn® GitHub استفاده کنید — به بخش نصب برنامه Zinn® GitHub مراجعه کنید. یک توکن متعلق به یک فرد است و با خروج او از کار می‌افتد.

پیش از شروع

یک حساب کاربری GitHub با دسترسی به مخازنی که می‌خواهید مستقر کنید. اگر آن‌ها متعلق به یک سازمان باشند، ممکن است یکی از مالکان مجبور باشد توکن‌های با دسترسی جزئی (fine-grained) را برای آن تأیید کند.

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

در GitHub، روی تصویر نمایه خود کلیک کنید، سپس به مسیر Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token بروید. به آن نامی بدهید و زمان انقضایی را انتخاب کنید. در قسمت Repository access، گزینه Only select repositories را انتخاب کرده و مخازنی را که می‌خواهید مستقر کنید برگزینید — محدودترین دسترسی ممکن که کار کند.

در قسمت Repository permissions دسترسی Read and write را برای موارد زیر اعطا کنید:

• Contents
• Pages
• Administration

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

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

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

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

بعد از آن چه اتفاقی می‌افتد

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

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

یک مخزن نمایش داده نمی‌شود. دسترسی مخزنِ توکن شامل آن نمی‌شود. توکن را در GitHub ویرایش کنید و مخزن را اضافه کنید.

اتصال کار کرد و سپس متوقف شد. توکن‌های با دسترسی جزئی در تاریخی که انتخاب کرده‌اید منقضی می‌شوند. یک توکن جدید ایجاد کنید و آن را متصل کنید؛ GitHub پیش از انقضای توکن به شما ایمیل می‌زند.

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

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

قطع اتصال

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

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