Розгорніть статичний сайт у власному обліковому записі 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 → 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) перевіряється за допомогою запису TXT, а піддомен — за допомогою його CNAME; на сторінці домену

показано, який саме з них потрібен вашому домену.

Якщо підключення не вдається

Azure відхилив суб'єкт-службу (service principal). Або закінчився термін дії секретного ключа клієнта (client secret) — це завжди трапляється після обраного вами терміну, — або програма більше не має ролі Contributor у групі ресурсів. Ці два повідомлення схожі, тому перевірте призначення ролей, перш ніж створювати новий секретний ключ.

Нічого не знайдено. Переконайтеся, що Subscription ID та Resource group — це саме ті, для яких ви призначили роль, а Tenant ID відповідає каталогу, у якому зареєстрована програма.

Повідомляється, що ключ було відхилено. Майже завжди причина в одному з трьох факторів: разом із ключем було скопійовано пробіл або розрив рядка, термін дії ключа закінчився або ключ було відкликано чи згенеровано заново після того, як ви його скопіювали. Створіть новий ключ і вставте його знову.

Підключення відбувається, але пізніше виникає помилка. Ключ проходить автентифікацію, але не має дозволу, необхідного для цієї дії. Створіть новий ключ із зазначеними вище дозволами, потім відключіть старе з'єднання та підключіть новий ключ.

Відключення

Відкрийте Integrations, знайдіть потрібний обліковий запис і натисніть Disconnect. Це негайно видалить збережений ключ. Усе, що його використовувало, зупиниться під час наступної дії, а на екранах, які залежали від нього, з'явиться відповідне повідомлення замість непомітного збою.

Відключення не скасовує того, що вже було зроблено — записи, розгортання чи налаштування, які ми змінили у вашому обліковому записі, залишаються без змін. Якщо ви вважаєте, що сам ключ міг бути скомпрометований, також відкличте його в постачальника; відключення видаляє нашу копію, але не їхню.