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

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

اتصال Bitbucket به یک وب‌سایت اجازه می‌دهد تا از یکی از مخازن Bitbucket Cloud شما مستقر شود: تغییرات را به شاخه ارسال (push) کنید و وب‌سایت به‌روزرسانی می‌شود.

پیش از شروع

یک حساب Bitbucket Cloud با دسترسی به مخازنی که می‌خواهید مستقر کنید.

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

Bitbucket دو نوع اعتبارنامه ارائه می‌دهد و هر دو کار می‌کنند:

• یک توکن دسترسی برای یک مخزن، پروژه یا فضای کاری، که از تنظیمات خودِ آن مخزن، پروژه یا فضای کاری در بخش Access tokens ایجاد شده است. این توکن به‌جای یک شخص، به همان مخزن، پروژه یا فضای کاری گره خورده است. به آن دسترسی خواندن به مخازن بدهید.
• یک توکن API در حساب Atlassian شما. نمایه خود را انتخاب کنید، سپس به Account settings → Security → Create and manage API tokens → Create API token with scopes بروید. آن را نام‌گذاری کنید، یک تاریخ انقضا تعیین کنید، Bitbucket را به عنوان اپلیکیشن انتخاب کنید و دسترسی خواندن به مخازن را فعال کنید. Bitbucket توکن را فقط یک بار نشان می‌دهد؛ آن را در همان زمان کپی کنید.

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

بخش Integrations را در داشبورد خود باز کنید و Connect an account را انتخاب کنید. گزینه Code hosting را به عنوان گروه و Bitbucket را به عنوان حساب انتخاب کنید، فیلد API token را پر کنید — و اگر توکن را در حساب Atlassian خود ایجاد کرده‌اید و نه به عنوان یک توکن دسترسی، فیلد Account username را نیز پر کنید، سپس روی Connect account کلیک کنید.

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

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

در ادامه چه اتفاقی می‌افتد

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

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

یک مخزن وجود ندارد. توکن دسترسی فقط به مخزن، پروژه یا فضای کاری که در آن ایجاد شده است دسترسی دارد. یک توکن در سطحی ایجاد کنید که تمامی مخازن مورد نیاز شما را پوشش دهد.

اتصال برقرار شد و سپس متوقف شد. هر دو نوع توکن ممکن است منقضی شوند. یک توکن جدید ایجاد کنید و آن را متصل کنید.

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

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

قطع اتصال

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

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