Wdróż witrynę statyczną na własnym koncie Azure Static Web Apps

Co daje połączenie konta

Połączenie własnego konta Azure Static Web Apps pozwala publikować witrynę statyczną na Pana/Pani koncie Azure Static Web Apps bezpośrednio z panelu Zinn®. Projekt oraz rachunki pozostają pod Pana/Pani kontrolą; my zajmujemy się wdrożeniem, domeną niestandardową i rekordami DNS.

Zanim zaczniesz

Subskrypcja Azure, grupa zasobów dla witryn oraz połączone konto GitHub, GitLab lub Bitbucket zawierające kod — Azure Static Web Apps buduje witrynę z repozytorium. Bezpłatny plan Azure zezwala na użytek komercyjny oraz dwie domeny niestandardowe na aplikację.

1. Wygeneruj klucz w usłudze Azure Static Web Apps

Platforma Azure określa go jako jednostkę usługi (service principal). W centrum administracyjnym Microsoft Entra proszę otworzyć Entra ID → App registrations → New registration, nadać jej nazwę i kliknąć Register. Na stronie przeglądu aplikacji proszę skopiować Application (client) ID oraz Directory (tenant) ID. Następnie proszę otworzyć Certificates & secrets → Client secrets → New client secret, wybrać okres ważności i kliknąć Add — wartość klucza tajnego należy skopiować od razu, ponieważ Azure wyświetla ją tylko raz.

W portalu Azure proszę otworzyć grupę zasobów, która ma zostać przez nas użyta, a następnie przejść do Access control (IAM) → Add → Add role assignment. Proszę wybrać rolę Contributor, przypisać ją do opcji User, group, or service principal, wyszukać aplikację po nazwie i kliknąć Review + assign. Proszę zanotować nazwę grupy zasobów oraz Subscription ID, do którego ona należy (w portalu należy wyszukać hasło Subscriptions).

2. Połącz konto w tym miejscu

W swoim panelu proszę otworzyć sekcję Integrations i wybrać opcję Connect an account. Proszę wybrać Static hosting (Netlify, Vercel) jako grupę oraz Azure Static Web Apps jako konto, wypełnić pola Client ID, Client secret, Tenant ID, Subscription ID oraz Resource group, a następnie kliknąć Connect account.

Wklejone dane testujemy przed zapisaniem jakichkolwiek informacji. Klucz, który nie działa, nie jest nigdy zapisywany, a odpowiedź wyjaśnia przyczynę błędu. Działający klucz jest przechowywany w postaci zaszyfrowanej w naszym magazynie wpisów tajnych — nigdy w naszej bazie danych — i nie zostanie wyświetlony ponownie, nawet Panu/Pani.

Co dzieje się dalej

• Podczas tworzenia lub przenoszenia witryny statycznej to konto pojawi się jako cel

wdrożenia. Azure Static Web Apps kompiluje dane z repozytorium — usługa nie umożliwia przesłania gotowej kompilacji — dlatego kod witryny musi pochodzić z połączonego repozytorium GitHub, GitLab lub Bitbucket. Proszę najpierw połączyć jedno z nich, jeśli jeszcze tego nie zrobiono.

• Tworzymy usługę na Pana/Pani koncie, wskazujemy ją na repozytorium, podpinamy domenę niestandardową

i uruchamiamy wdrożenia. Strona domeny wyświetla wszystkie rekordy DNS wymagane przez Azure Static Web Apps.

• Użycie oraz rozliczenia znajdują się na Pana/Pani koncie i są widoczne w panelu u danego dostawcy.
• Domena główna (apex) jest weryfikowana za pomocą rekordu TXT, a subdomena za pomocą rekordu CNAME; strona domeny wskazuje,

którego z nich wymaga dana domena.

Jeśli połączenie nie powiodło się

Platforma Azure odrzuciła jednostkę usługi. Albo klucz tajny klienta wygasł — co zawsze następuje po wybranym okresie ważności — albo aplikacja nie ma już roli Contributor w danej grupie zasobów. Oba komunikaty wyglądają podobnie, dlatego przed wygenerowaniem nowego klucza tajnego należy sprawdzić przypisanie ról.

Nic nie znaleziono. Proszę sprawdzić, czy identyfikatory Subscription ID i Resource group są tymi samymi, do których przypisano rolę, oraz czy Tenant ID jest katalogiem, w którym zarejestrowano aplikację.

Pojawia się komunikat o odrzuceniu klucza. Prawie zawsze wynika to z jednej z trzech przyczyn: skopiowania spacji lub znaku końca linii wraz z kluczem, wygaśnięcia klucza albo odwołania bądź ponownego wygenerowania klucza po jego skopiowaniu. Proszę wygenerować nowy klucz i wkleić go ponownie.

Połączenie powiodło się, ale późniejsza operacja kończy się błędem. Klucz został pomyślnie uwierzytelniony, lecz brakuje mu uprawnienia wymaganego do danej czynności. Należy utworzyć nowy klucz z uprawnieniami wymienionymi powyżej, a następnie odłączyć stare połączenie i połączyć nowy klucz.

Odłączanie

Proszę otworzyć sekcję Integrations, odnaleźć konto i kliknąć Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystkie procesy korzystające z niego zostaną zatrzymane przy następnej operacji, a ekrany, które od niego zależały, wyświetlą odpowiedni komunikat zamiast nieoczekiwanego przerwania pracy.

Odłączenie nie cofa wcześniej wykonanych czynności — rekordy, wdrożenia lub ustawienia zmienione na Pana/Pani koncie pozostają bez zmian. W przypadku podejrzenia, że sam klucz mógł wyciec, należy go również unieważnić u dostawcy; odłączenie usuwa wyłącznie naszą kopię, a nie kopię dostawcy.