Деплойване на статичен сайт към вашия собствен 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 отворете Entra ID → Регистрации на приложения → Нова регистрация, дайте му име и го Регистрирайте. На страницата за преглед на приложението копирайте ID на приложението (клиент) и ID на директорията (тенант). След това отворете Сертификати и секрети → Клиентски секрети → Нов клиентски секрет, изберете продължителност и го Добавете — копирайте стойността на секрета веднага, Azure я показва само веднъж.

В портала на Azure отворете ресурсната група, която искате да използваме, след което изберете Контрол на достъпа (IAM) → Добавяне → Добавяне на ролево присвояване. Изберете ролята Сътрудник (Contributor), присвоете я на Потребител, група или службен обект, намерете приложението по име и изберете Преглед и присвояване. Забележете името на ресурсната група и ID на абонамента, към който тя принадлежи (потърсете Абонаменти в портала).

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

Отворете Интеграции в таблото си за управление и изберете Свързване на акаунт. Изберете Статичен хостинг (Netlify, Vercel) като група и Azure Static Web Apps като акаунт, попълнете Клиентски ID, Клиентски секрет, ID на тенант, ID на абонамент и Ресурсна група, след което натиснете Свързване на акаунт.

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

Какво се случва след това

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

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

• Създаваме услугата във вашия акаунт, насочваме я към хранилището, прикачваме вашия персонализиран домейн и стартираме внедряванията. Страницата на домейна показва всички DNS записи, от които Azure Static Web Apps се нуждае.
• Използването и таксуването са за ваша сметка, видими в собственото ви табло за управление при доставчика.
• Основният домейн (apex domain) се потвърждава с TXT запис, а поддомейнът – с CNAME запис; страницата на домейна показва от кой от тях се нуждае вашият домейн.

Ако не се свърже

Azure отхвърли службения обект. Или клиентският секрет е изтекъл — те винаги го правят след избраната от вас продължителност — или приложението вече няма права на Сътрудник върху ресурсната група. Двете съобщения изглеждат сходни, затова проверете присвояването на ролята, преди да създадете нов секрет.

Нищо не е намерено. Проверете дали ID на абонамента и Ресурсната група са тези, на които сте присвоили ролята, и дали ID на тенант е директорията, в която е регистрирано приложението.

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

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

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

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

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