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

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

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

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

قبل از شروع

یک حساب GitHub با دسترسی به مخازنی که می‌خواهید مستقر کنید. اگر آن‌ها متعلق به یک سازمان باشند، ممکن است لازم باشد مالک آن، توکن‌های با دسترسی دقیق را برای آن تأیید کند.

۱. ایجاد کلید در 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 کلیک کنید. این کار کلید ذخیره‌شده را فوراً حذف می‌کند. هر چیزی که از آن استفاده می‌کرد در اقدام بعدی خود متوقف می‌شود، و صفحاتی که به آن وابسته بودند به جای خطای بی‌صدا، این موضوع را گزارش می‌دهند.

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