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