اتصال آن چه کمکی به شما میکند
نصب برنامه GitHub متعلق به Zinn® به یک سایت اجازه میدهد از مخازن شما مستقر شود — و یک برد پروژه با GitHub همگام بماند — بدون اینکه توکن شخصی خود را در اختیار ما قرار دهید. ما فقط شماره نصب برنامه را نگهداری میکنیم که به خودی خود بیفایده است، و هر بار که نیاز داشته باشیم یک توکن با اعتبار یک ساعته صادر میکنیم. این گزینه انتخاب بهتری برای یک سازمان است، زیرا به هیچ شخص خاصی تعلق ندارد و با خروج یک فرد از کار نمیافتد.
پیش از شروع
یک حساب GitHub، یا دسترسیهای مالک در سازمانی که میخواهید برنامه را در آن نصب کنید. سازمانهایی که برنامههای شخص ثالث را ممنوع کردهاند به یک مالک برای مجاز کردن آن نیاز دارند؛ اگر این امر ممکن نیست، در عوض از یک توکن با دسترسیهای دقیق (اتصال حساب GitHub شما) استفاده کنید.
۱. ایجاد کلید در GitHub
هیچ کلیدی برای ایجاد وجود ندارد. برنامه GitHub متعلق به Zinn® را روی حساب شخصی یا سازمان خود نصب کنید، و همه مخازن یا تنها مواردی را که میخواهید مستقر کنیم انتخاب نمایید.
سپس شماره نصب را پیدا کنید:
- حساب شخصی — Settings → Applications → Installed GitHub Apps، و سپس Configure در کنار برنامه Zinn®.
- سازمان — Your organizations → Settings → GitHub Apps، و سپس Configure در کنار برنامه Zinn®.
شماره موجود در انتهای نوار آدرس در آن صفحه — برای مثال github.com/settings/installations/12345678 — همان شماره نصب است.
۲. آن را در اینجا متصل کنید
برنامه به جای صفحه «ادغامها»، در همان جایی که استفاده میشود انتخاب میگردد:
- در اتصال مخزن یک سایت، گزینه GitHub (نصب برنامه) را انتخاب کنید.
- در پیوند GitHub یک برد پروژه، گزینه برنامه GitHub متعلق به Zinn® را انتخاب کنید.
شماره نصب را جایگذاری کرده و ادامه دهید. ما پیش از ذخیره هر چیزی، نصب را بررسی میکنیم؛ شمارهای که نتوانیم به آن دسترسی پیدا کنیم هرگز ذخیره نمیشود.
در ادامه چه اتفاقی میافتد
- مخازنی که به برنامه واگذار کردهاید برای استقرار سایت ظاهر میشوند، و یک پوش آن را مستقر میکند.
- هر اقدامی که انجام میدهیم در گزارش بازرسی نصب در GitHub تحت نام برنامه نمایش داده میشود، نه نام شما.
- برای دادن مخازن بیشتر به ما، دسترسی مخزن برنامه را در همان صفحه Configure تغییر دهید — نیازی به اتصال مجدد هیچ چیزی نیست.
اگر متصل نشد
یک مخزن وجود ندارد. فرایند نصب فقط مخازنی را شامل میشود که انتخاب کردهاید. بخش Configure را باز کرده و آن را اضافه کنید.
شماره رد میشود. بررسی کنید که شماره همان شماره نصب از نوار آدرس باشد، نه شناسه خود برنامه، و برنامه همچنان نصب باشد — برنامه حذفشده هیچ نصبی ندارد.
پیام میدهد که کلید رد شده است. تقریباً همیشه یکی از سه دلیل زیر است: یک فاصله یا شکست خط همراه آن کپی شده، کلید منقضی شده، یا کلیدی پس از کپی کردن باطل یا بازتولید شده است. یک کلید جدید ایجاد کرده و دوباره آن را جایگذاری کنید.
متصل میشود، اما بعداً مشکلی پیش میآید. کلید احراز هویت میشود اما فاقد مجوزی است که اقدام به آن نیاز دارد. کلید جدیدی با مجوزهای ذکرشده در بالا ایجاد کنید، سپس اتصال قبلی را قطع نموده و کلید جدید را متصل کنید.
قطع اتصال
بخش ادغامها را باز کنید، حساب را بیابید و روی قطع اتصال کلیک کنید. این کار کلید ذخیرهشده را فوراً حذف میکند. هر چیزی که از آن استفاده میکرد در اقدام بعدی خود متوقف میشود، و صفحاتی که به آن وابسته بودند به جای خطای بیصدا، این وضعیت را اعلام میکنند.
قطع اتصال کارهایی را که قبلاً انجام شده باطل نمیکند — رکوردها، استقرارها یا تنظیماتی که در حساب شما تغییر دادهایم همانگونه که هستند باقی میمانند. اگر فکر میکنید خود کلید ممکن است لو رفته باشد، آن را در ارائهدهنده نیز باطل کنید؛ قطع اتصال فقط نسخه ما را حذف میکند، نه نسخه آنها را.