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

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

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

پیش از شروع

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

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

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

• یک توکن دسترسی (access token) برای یک مخزن، پروژه یا فضای کاری که از تنظیمات اختصاصی همان مخزن، پروژه یا فضای کاری در بخش Access tokens ایجاد شده باشد. این توکن به‌جای یک فرد، به آن مخزن، پروژه یا فضای کاری وابسته است. به آن دسترسی خواندن (read) به مخازن بدهید.
• یک توکن 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 از این اتصال به‌عنوان منبع کد سایت استفاده می‌کنند.

در صورت متصل نشدن

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

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

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

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

قطع اتصال

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

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