Внедрете статичен сайт във вашия собствен акаунт в Azure Static Web Apps

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

Свързването на Вашия собствен акаунт в Azure Static Web Apps Ви позволява да публикувате статичен сайт към Вашия акаунт в Azure Static Web Apps от Вашето Zinn® табло. Вие притежавате проекта и сметката; ние поемаме внедряването, персонализирания домейн и DNS записите.

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

Абонамент за Azure, група ресурси за сайтовете и свързан акаунт в GitHub, GitLab или Bitbucket, съдържащ кода — Azure Static Web Apps компилира от хранилище. Безплатният план на Azure позволява търговска употреба и два персонализирани домейна на приложение.

1. Създайте ключа в Azure Static Web Apps

Azure нарича това service principal (принципал на услуга). В Microsoft Entra admin center отворете Entra ID → App registrations → New registration, задайте му име и изберете Register. На страницата с общ преглед на приложението копирайте Application (client) ID и Directory (tenant) ID. След това отворете Certificates & secrets → Client secrets → New client secret, изберете валидност и го добавете чрез Add — копирайте стойността на тайната веднага, тъй като Azure я показва само веднъж.

В портала на Azure отворете групата ресурси, която искате да използваме, след което Access control (IAM) → Add → Add role assignment. Изберете ролята Contributor, задайте я на User, group, or service principal, потърсете приложението по име и завършете с Review + assign. Запишете името на групата ресурси и съответния Subscription ID, към който тя принадлежи (потърсете Subscriptions в портала).

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

Отворете Integrations във Вашето табло и изберете Connect an account. Изберете Static hosting (Netlify, Vercel) като група и Azure Static Web Apps като акаунт, попълнете Client ID, Client secret, Tenant ID, Subscription ID и Resource group, след което натиснете Connect account.

Тестваме това, което поставяте, преди да бъде записано каквото и да било. Ключ, който не работи, никога не се запазва, а отговорът посочва какво не е наред с него. Работещият ключ се съхранява криптиран в нашия трезор за тайни — никога в нашата база данни — и никога повече не се показва, дори на Вас.

Какво следва

• Когато създавате или местите статичен сайт, този акаунт ще се показва като целева дестинация за

внедряване. Azure Static Web Apps компилира от хранилище — няма начин да приеме качен компилиран билд — така че кодът на сайта трябва да идва от свързано хранилище в GitHub, GitLab или Bitbucket. Свържете такова първо, ако все още не сте.

• Ние създаваме услугата във Вашия акаунт, насочваме я към хранилището, прикачваме Вашия персонализиран домейн

и задействаме внедряванията. Страницата на домейна показва всеки DNS запис, необходим на Azure Static Web Apps.

• Потреблението и таксуването са към Вашия акаунт и са видими в собственото Ви табло при доставчика.
• Основният домейн (apex domain) се потвърждава чрез TXT запис, а поддомейнът — чрез своя CNAME; страницата на домейна показва

кой от тях е необходим за Вашия домейн.

Ако свързването е неуспешно

Azure отказа принципала на услугата (service principal). Или клиентската тайна е изтекла — те винаги изтичат според избраната от Вас валидност — или приложението вече няма права на Contributor за групата ресурси. Двете съобщения си приличат, така че проверете присвоената роля, преди да създадете нова тайна.

Нищо не е открито. Проверете дали Subscription ID и Resource group са точно тези, за които сте присвоили ролята, както и дали Tenant ID съответства на директорията, в която е регистрирано приложението.

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

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

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

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

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