اپنے Azure Static Web Apps اکاؤنٹ پر ایک اسٹیٹک سائٹ ڈیپلائے کریں

اسے منسلک کرنے سے آپ کو کیا فائدہ حاصل ہوتا ہے

اپنا Azure Static Web Apps اکاؤنٹ منسلک کرنے سے آپ اپنے Zinn® ڈیش بورڈ سے اپنے Azure Static Web Apps اکاؤنٹ پر اسٹیٹک سائٹ شائع کر سکتے ہیں۔ پروجیکٹ اور بل کے مالک آپ ہیں؛ ہم ڈیپلائے، کسٹم ڈومین اور DNS ریکارڈز کو سنبھالتے ہیں۔

شروع کرنے سے پہلے

ایک Azure سبسکرپشن، سائٹس کے لیے ایک ریسورس گروپ، اور کوڈ کا حامل ایک منسلک GitHub، GitLab یا Bitbucket اکاؤنٹ — Azure Static Web Apps ایک ریپوزیٹری سے بلڈ کرتا ہے۔ Azure کا مفت پلان تجارتی استعمال اور فی ایپ دو کسٹم ڈومینز کی اجازت دیتا ہے۔

1. Azure Static Web Apps پر کلید (key) بنائیں

Azure اسے service principal کہتا ہے۔ Microsoft Entra admin center میں Entra ID ← App registrations ← New registration کھولیں، اسے ایک نام دیں اور اسے Register کریں۔ ایپ کے اوور ویو پیج پر Application (client) ID اور Directory (tenant) ID کاپی کریں۔ پھر Certificates & secrets ← Client secrets ← New client secret کھولیں، ایک مدّت منتخب کریں اور اسے Add کریں — سیکرٹ کی قیمت (value) کو فوراً کاپی کریں، 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 پر کلک کریں۔

کچھ بھی محفوظ ہونے سے پہلے ہم آپ کے چسپاں (paste) کیے گئے ڈیٹا کو ٹیسٹ کرتے ہیں۔ کام نہ کرنے والی کلید کبھی بھی محفوظ نہیں کی جاتی، اور جواب بتاتا ہے کہ اس میں کیا خرابی تھی۔ کام کرنے والی کلید کو ہمارے سیکرٹس والٹ میں انکرپٹڈ رکھا جاتا ہے — ہمارے ڈیٹا بیس میں کبھی نہیں — اور اسے دوبارہ کبھی نہیں دکھایا جاتا، آپ کو بھی نہیں۔

آگے کیا ہوگا

• جب آپ کوئی اسٹیٹک سائٹ بناتے ہیں یا منتقل کرتے ہیں، تو یہ اکاؤنٹ ڈیپلائے ٹارگٹ کے طور پر ظاہر ہوتا ہے۔

Azure Static Web Apps ایک ریپوزیٹری سے بلڈ کرتا ہے — اس کے پاس اپ لوڈ کردہ بلڈ قبول کرنے کا کوئی طریقہ نہیں ہے — لہٰذا سائٹ کا کوڈ ایک منسلک GitHub، GitLab یا Bitbucket ریپوزیٹری سے آنا چاہیے۔ اگر آپ نے ابھی تک منسلک نہیں کیا ہے تو پہلے ایک ریپوزیٹری منسلک کریں۔

• ہم آپ کے اکاؤنٹ پر سروس بناتے ہیں، اسے ریپوزیٹری کی طرف نشان زد کرتے ہیں، آپ کا کسٹم ڈومین منسلک کرتے ہیں اور ڈیپلائمنٹ شروع کرتے ہیں۔ ڈومین کا صفحہ وہ تمام DNS ریکارڈز دکھاتا ہے جن کی Azure Static Web Apps کو ضرورت ہے۔
• استعمال اور بلنگ آپ کے اکاؤنٹ پر ہیں، جو آپ کے اپنے وینڈر ڈیش بورڈ میں قابلِ دید ہیں۔
• ایک ایپیکس ڈومین کو TXT ریکارڈ کے ذریعے اور سب ڈومین کو اس کے CNAME کے ذریعے تصدیق شدہ کیا جاتا ہے؛ ڈومین کا صفحہ دکھاتا ہے کہ آپ کے ڈومین کو کس کی ضرورت ہے۔

اگر یہ منسلک نہ ہو

Azure نے service principal کو مسترد کر دیا۔ یا تو کلائنٹ سیکرٹ کی میعاد ختم ہو چکی ہے — وہ آپ کی منتخب کردہ مدّت کے مطابق ہمیشہ ختم ہو جاتی ہے — یا ایپ کے پاس اب ریسورس گروپ پر Contributor کا رول نہیں رہا۔ دونوں پیغامات ایک جیسے دکھائی دیتے ہیں، لہٰذا نیا سیکرٹ بنانے سے پہلے رول کی تفویض (role assignment) کو چیک کریں۔

کچھ بھی نہیں ملا۔ چیک کریں کہ Subscription ID اور Resource group وہی ہیں جن پر آپ نے رول تفویض کیا تھا، اور Tenant ID وہ ڈائریکٹری ہے جس میں ایپ رجسٹرڈ ہے۔

یہ کہتا ہے کہ کلید مسترد کر دی گئی۔ تقریباً ہمیشہ تین میں سے ایک بات ہوتی ہے: اس کے ساتھ کاپی ہونے والا اسپیس یا لائن بریک، ایک ایسی کلید جس کی میعاد ختم ہو چکی ہے، یا ایک ایسی کلید جسے آپ کے کاپی کرنے کے بعد منسوخ یا دوبارہ جنریٹ کیا گیا تھا۔ ایک نئی کلید بنائیں اور اسے دوبارہ چسپاں کریں۔

یہ منسلک ہو جاتا ہے، لیکن بعد میں کچھ ناکام ہو جاتا ہے۔ کلید کی تصدیق ہو جاتی ہے لیکن اس میں اس اجازت کی کمی ہوتی ہے جس کی کارروائی کو ضرورت ہے۔ اوپر درج اجازتوں کے ساتھ ایک نئی کلید بنائیں، پھر پرانے کنکشن کو منقطع کریں اور نئی کلید کو منسلک کریں۔

منقطع کرنا (Disconnecting)

Integrations کھولیں، اکاؤنٹ تلاش کریں اور Disconnect پر کلک کریں۔ یہ محفوظ شدہ کلید کو فوراً حذف کر دیتا ہے۔ جو بھی چیز اسے استعمال کر رہی تھی وہ اپنی اگلی کارروائی پر رک جاتی ہے، اور اس پر منحصر اسکرینز خاموشی سے ناکام ہونے کے بجائے اس کی اطلاع دیتی ہیں۔

منقطع کرنے سے وہ کام واپس نہیں ہوتا جو پہلے ہی ہو چکا ہے — وہ ریکارڈز، ڈیپلائمنٹس یا سیٹنگز جو ہم نے آپ کے اکاؤنٹ پر تبدیل کی تھیں، ویسے ہی رہتے ہیں۔ اگر آپ کو لگتا ہے کہ خود کلید افشا ہو گئی ہے، تو اسے وینڈر کے ہاں بھی منسوخ کریں؛ منقطع کرنے سے ہماری کاپی ہٹتی ہے، ان کی نہیں۔