פרוס אתר סטטי בחשבון 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 מבצע בנייה מתוך מאגר קוד — אין לו דרך לקבל תוצר בנייה (build) שהועלה — ולכן קוד האתר חייב להגיע ממאגר 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. פעולה זו מוחקת את המפתח השמור באופן מיידי. כל רכיב שהשתמש בו ייעצר בפעולה הבאה שלו, והמסכים שהסתמכו עליו יציגו הודעה מתאימה במקום להיכשל באופן שקט.

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