Свържете своя Bitbucket акаунт, за да се внедряват сайтовете ви от хранилище

Какво ви дава свързването

Свързването на Bitbucket позволява на даден сайт да се внедрява от някое от вашите хранилища в Bitbucket Cloud: изпратете към клона и сайтът ще се актуализира.

Преди да започнете

Акаунт в Bitbucket Cloud с достъп до хранилищата, които искате да внедрявате.

1. Създайте ключа в Bitbucket

Bitbucket предлага два вида идентификационни данни и всеки от тях върши работа:

• Токен за достъп (access token) за хранилище, проект или работно пространство, създаден от собствените настройки на съответното хранилище, проект или работно пространство под Access tokens. Той е обвързан с това хранилище, проект или работно пространство, а не с конкретно лице. Предоставете му права за четене (read access) на хранилищата.
• API токен във вашия профил в Atlassian. Изберете профила си, след което отидете на Account settings → Security → Create and manage API tokens → Create API token with scopes. Задайте му име, изберете срок на валидност, посочете Bitbucket като приложение и изберете права за четене на хранилищата. Bitbucket показва токена само веднъж; копирайте го тогава.

2. Свържете го тук

Отворете Integrations във вашето табло за управление и изберете Connect an account. Изберете Code hosting като група и Bitbucket като акаунт, попълнете API token — и ако сте създали токен в профила си в Atlassian, а не токен за достъп, попълнете също и Account username, след което натиснете Connect account.

Преди да бъде запазено каквото и да било, ние тестваме това, което сте поставили. Неработещ ключ никога не се съхранява, а отговорът показва какъв е бил проблемът с него. Работещ ключ се съхранява криптиран в нашето защитено хранилище за тайни (secrets vault) — никога в нашата база данни — и никога повече не се показва, дори и на вас.

Потребителското име определя как изпращаме токена, затова го въвеждайте само за токен за акаунт. Токен за достъп, въведен с потребителско име, или токен за акаунт без такова, се отхвърля.

Какво следва

• Сайтът може да се внедрява директно от хранилище в този акаунт: изберете го във връзката към хранилището на сайта, изберете хранилището и клона, и всяко изпращане ще стартира внедряване.
• Всеки друг клон може да получи свой собствен преглед (preview), така че да можете да проверите дадена промяна, преди тя да достигне до работещия сайт.
• Статични хостинг платформи, управлявани чрез Git, като Render и Azure Static Web Apps, използват тази връзка като източник на кода за сайта.

Ако не се свързва

Липсва хранилище. Токенът за достъп достига само до хранилището, проекта или работното пространство, в което е бил създаден. Създайте такъв на нивото, което обхваща всяко хранилище, от което се нуждаете.

Работеше, но след това спря. И двата вида токени могат да изтекат. Създайте нов и го свържете.

Показва се съобщение, че ключът е отхвърлен. Почти винаги причината е една от три: интервал или нов ред, копиран заедно с него, ключ с изтекъл срок на валидност или ключ, който е бил отменен или прегенериран след копирането му. Създайте нов и го поставете отново.

Свързва се, но по-късно нещо се проваля. Ключът се удостоверява успешно, но няма необходимото за действието разрешение. Създайте нов ключ с изброените по-горе разрешения, след това прекъснете старата връзка и свържете новия ключ.

Прекъсване на връзката

Отворете Integrations, намерете акаунта и натиснете Disconnect. Това незабавно изтрива съхранения ключ. Всичко, което го е използвало, спира при следващото си действие, а екраните, които са зависели от него, съобщават за това, вместо да се провалят без предупреждение.

Прекъсването на връзката не отменя вече извършеното — записите, внедряванията или настройките, които сме променили във вашия акаунт, остават такива, каквито са. Ако смятате, че самият ключ може да е изтекъл, отменете го и при доставчика; прекъсването на връзката премахва нашето копие, а не тяхното.