خپل د Azure Static Web Apps حساب ته یو سټاټیک سایټ ځای پرځای کړئ

د دې نښلول ستاسو لپاره څه کوي

د خپل Azure Static Web Apps حساب نښلول تاسو ته اجازه درکوي چې له خپل Zinn® ډېشبورډ څخه خپل د Azure Static Web Apps حساب ته یو سټاټیک سایټ خپور کړئ. تاسو د پروژې او د بل مالکان یاست؛ موږ د پلي کولو (deploy)، دودیز ډومین او د DNS ریکارډونو چاره کوو.

مخکې له دې چې تاسو یې پیل کړئ

د Azure یو ګډون (subscription)، د سایټونو لپاره یو د سرچینو ګروپ (resource group)، او یو نښلول شوی GitHub، GitLab یا Bitbucket حساب چې کوډ پکې وي — Azure Static Web Apps له یوه مخزن (repository) څخه جوړیږي. د Azure وړیا پلان د سوداګریزې کارونې او د هر اپلیکیشن لپاره د دوو دودیزو ډومینونو اجازه ورکوي.

۱. په Azure Static Web Apps کې کلي جوړه کړئ

Azure دې ته یو service principal وايي. د Microsoft Entra admin center کې Entra ID → App registrations → New registration پرانیزئ، یو نوم ورته وټاکئ او Register یې کړئ. د اپلیکیشن د عمومي لید (overview) په پاڼه کې 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 وپلټئ).

۲. دلته یې ونښلوئ

په خپل ډېشبورډ کې 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 کوئ). هغه کلي چې کار نه کوي هېڅکله نه ساتل کیږي، او ځواب وايي چې په هغې کې څه ستونزه وه. هغه کلي چې کار کوي زموږ د پټو کلمو په خوندي ځای (secrets vault) کې په کوډ شوې (encrypted) بڼه ساتل کیږي — هېڅکله زموږ په ډیټابیس کې نه — او بیا هېڅکله نه ښودل کیږي، حتی تاسو ته هم نه.

وروسته څه پېښیږي

• کله چې تاسو یو سټاټیک سایټ جوړوئ یا یې لېږدوئ، دا حساب د پلي کولو (deploy) د هدف په توګه ښکاري.

Azure Static Web Apps له یوه مخزن څخه جوړیږي — دا د اپلوډ شوي بِلډ د منلو کومه لاره نه لري — نو د سایټ کوډ باید له یوه نښلول شوي GitHub، GitLab یا Bitbucket مخزن څخه راشي. که تاسو تر اوسه نه وي نښلولی، لومړی یو ونښلوئ.

• موږ ستاسو په حساب کې خدمت جوړوو، هغه مخزن ته برابروو، ستاسو دودیز ډومین ورسره نښلوو او پلي کول (deploys) پیلوو. د ډومین پاڼه هر هغه د DNS ریکارډ ښیي چې Azure Static Web Apps ورته اړتیا لري.
• کارونه او بیلینګ ستاسو په حساب کې دي، چې ستاسو د خپل پلورونکي (vendor) په ډېشبورډ کې د لیدلو وړ دي.
• یو apex ډومین د TXT ریکارډ په واسطه او یو فرعي ډومین (subdomain) د هغې د CNAME په واسطه تایید کیږي؛ د ډومین پاڼه ښیي چې ستاسو ډومین کوم یوه ته اړتیا لري.

که دا ونښلول شي

Azure د service principal رد کړ. یا د پیرودونکي پټه کلمه (client secret) پای ته رسېدلې ده — هغوی تل پای ته رسېږي، په هغه موده کې چې تاسو ټاکلې وي — یا اپلیکیشن نور د سرچینو په ګروپ کې Contributor رول نه لري. دا دوه پیغامونه ورته ښکاري، نو د نوې پټې کلمې جوړولو دمخه د رول سپارښتنه وګورئ.

هېڅ ونه موندل شو. وګورئ چې Subscription ID او Resource group همغه دي چې تاسو پرې رول ټاکلی، او دا چې Tenant ID همغه ډایرکټري ده چې اپلیکیشن پکې ثبت شوی دی.

دا وايي چې کلي رد شوه. تقریبا تل د دریو شیانو څخه یو وي: ورسره یو ځای یوه خالي فاصله (space) یا د کرښې ماتول (line break) کاپي شوي، یوه کلي چې پای ته رسېدلې، یا یوه کلي چې وروسته له دې چې تاسو کاپي کړې وه فسخه شوې یا بیا جوړه شوې وي. نوې کلي جوړه کړئ او بیا یې دلته وټومبئ (paste کړئ).

دا نښلي، مګر وروسته یو څه ناکامیږي. کلي تایید (authenticate) کیږي خو هغه اجازه نه لري چې دا عمل ورته اړتیا لري. د هغو اجازو سره چې پورته ذکر شوي یوه نوې کلي جوړه کړئ، بیا پخوانی پیوستون پرې کړئ او نوې کلي ونښلوئ.

د پیوستون پرې کول

Integrations پرانیزئ، حساب ومومئ او Disconnect ووهئ. دا کار خوندي شوې کلي سمدلاسه حذف کوي. هر هغه څه چې دا یې کاروله په خپل راتلونکي عمل کې ودریږي، او هغه پردې چې پدې پورې تړلې وې د خاموشه پاتې کیدو پرځای به دا خبره په ډاګه کړي.

د پیوستون پرې کول هغه څه نه باطلوي چې دمخه ترسره شوي وو — ریکارډونه، پلي کول یا هغه تنظیمات چې موږ ستاسو په حساب کې بدل کړي دي هماغسې پاتې کیږي. که تاسو فکر کوئ چې پخپله کلي ممکن افشا شوې وي، هغه د پلورونکي سره هم لغوه کړئ؛ د پیوستون پرې کول زموږ کاپي لیرې کوي، نه د هغوی.