פריסת אתר סטטי לחשבון Azure Static Web Apps שלך

מה החיבור מעניק לכם

חיבור חשבון Azure Static Web Apps משלכם מאפשר לכם לפרסם אתר סטטי לחשבון ה-Azure Static Web Apps שלכם מתוך לוח הבקרה של Zinn®. הפרויקט והחיוב הם בבעלותכם; אנו מטפלים בפריסה, בדומיין המותאם האישית וברשומות ה-DNS.

לפני שמתחילים

מנוי Azure, קבוצת משאבים (resource group) עבור האתרים, וחשבון GitHub, GitLab או Bitbucket מחובר המכיל את הקוד — Azure Static Web Apps מבצע בנייה מתוך מאגר קוד (repository). המסלול החינמי של 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 — העתיקו את ערך ה-secret מיד, 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. או שתוקף ה-client secret תפוג — דבר שקורא תמיד, לפי התקופה שבחרתם — או שלפרויקט אין עוד הרשאת Contributor בקבוצת המשאבים. שתי ההודעות נראות דומות, לכן בדקו את שיוך התפקיד לפני יצירת secret חדש.

לא נמצא דבר. בדקו שה-Subscription ID וה-Resource group הם אלה שלהם שייכתם את התפקיד, וש-Tenant ID הוא הספריייה שבה האפליקציה רשומה.

מופיעה הודעה שהמפתח נדחה. כמעט תמיד מדובר באחד משלושה דברים: רווח או מעבר שורה שהועתקו איתו, מפתח שפג תוקפו, או מפתח שבוטל או נוצר מחדש לאחר שהעתקתם אותו. צרו מפתח חדש והדביקו אותו שוב.

החיבור מצליח, אך יש כשל בשלב מאוחר יותר. המפתח מבצע אימות אך חסרה לו הרשאה שהפעולה דורשת. צרו מפתח חדש עם ההרשאות הרשומות לעיל, ולאחר מכן נתקו את החיבור הישן וחברו את המפתח החדש.

ניתוק

פתחו את Integrations, אגרו את החשבון ולחצו Disconnect. פעולה זו מוחקת את המפתח השמור מיד. כל גורם שהשתמש בו ייעצר בפעולה הבאה שלו, והמסכים שהיו תלויים בו יודיעו על כך במקום להיכשל בשקט.

הניתוק אינו מבטל את מה שכבר בוצע — רשומות, פריסות או הגדרות ששינינו בחור החשבון שלכם יישארו כפי שהם. אם אתם חושדים שהמפתח עצמו דלף, בטלו אותו גם אצל הספק; הניתוק מסיר את העותק שלנו, ולא את שלהם.