Tura kafaffen shafin yanar gizo zuwa asusunka na Azure Static Web Apps

Abin da haɗa shi zai yi muku

Haɗa asusunku na Azure Static Web Apps yana ba ku damar wallafa shafin static zuwa asusunku na Azure Static Web Apps daga allon sarrafawarku na Zinn®. Aikin da kuɗin biyan buƙata naku ne; mu kuma muke kula da tura shafi (deploy), yanki na musamman (custom domain) da kuma bayanan DNS.

Kafin ku fara

Kuna buƙatar rajistar Azure (subscription), rukunin albarkatu (resource group) don shafukan, da kuma asusun GitHub, GitLab ko Bitbucket da aka haɗa wanda yake ɗauke da lambar asali (code) — Azure Static Web Apps yana gina shafi ne daga ma'ajiyar lamba (repository). Tsarin kyauta na Azure yana ba da damar amfani da shi ta hanyar kasuwanci da kuma yankuna na musamman guda biyu ga kowace manhaja.

1. Ƙirƙiri mabuɗin a Azure Static Web Apps

Azure yana kiran wannan da service principal. A cikin cibiyar gudanarwa ta Microsoft Entra buɗe Entra ID → App registrations → New registration, ba shi suna sannan ku danna Register. A babban shafin manhajar kwafe Application (client) ID da Directory (tenant) ID. Sannan ku buɗe Certificates & secrets → Client secrets → New client secret, zaɓi tsawon lokaci sannan ku danna Add — kwafe ƙimar sirrin nan take, Azure yana nuna shi sau ɗaya ne kawai.

A cikin shafin Azure portal, buɗe rukunin albarkatun da kuke son mu yi amfani da shi, sannan Access control (IAM) → Add → Add role assignment. Zaɓi matsayin Contributor, sanya shi ga User, group, or service principal, bincika manhajar da sunanta, sannan ku danna Review + assign. Lura da sunan rukunin albarkatun da kuma Subscription ID ɗin da yake ƙarƙashinsa (bincika Subscriptions a cikin portal ɗin).

2. Haɗa shi a nan

Buɗe Integrations a cikin allon sarrafawarku sannan ku zaɓi Connect an account. Zaɓi Static hosting (Netlify, Vercel) a matsayin rukuni sannan Azure Static Web Apps a matsayin asusu, cika Client ID, Client secret, Tenant ID, Subscription ID da kuma Resource group, sannan ku danna Connect account.

Muna gwada abin da kuka liƙa kafin a adana komai. Mabuɗin da ba ya aiki ba za a taɓa adana shi ba, kuma amsar za ta nuna abin da ba daidai ba game da shi. Mabuɗin da ke aiki ana kiyaye shi a ɓoye a cikin ma'ajiyar asirinmu — ba a cikin ma'ajiyar bayanai (database) ta mu ba — kuma ba za a sake nuna shi ba, ko da gare ku ne.

Abin da zai biyo baya

• Lokacin da kuka ƙirƙiri ko kuka matsar da shafin static, wannan asusun zai fito a matsayin inda za a

tura shafin. Azure Static Web Apps yana gina shafi ne daga ma'ajiyar lamba — ba shi da hanyar karɓar ginin da aka loda — don haka dole ne lambar shafin ta fito daga ma'ajiyar lamba ta GitHub, GitLab ko Bitbucket da aka haɗa. Fara haɗa ɗaya tukunna idan ba ku yi hakan ba.

• Muna ƙirƙirar sabis ɗin a asusunku, mu haɗa shi da ma'ajiyar lambar, mu haɗa yankinku na musamman

kuma mu fara tura ayyuka. Shafin yankin yana nuna kowane bayanin DNS da Azure Static Web Apps ke buƙata.

• Amfani da lissafin kuɗi suna kan asusunku, ana iya ganin su a allon sarrafawa na dillalin ku.
• Ana tabbatar da babban yanki (apex domain) ta hanyar bayanan TXT kuma ƙaramin yanki (subdomain) ta hanyar CNAME ɗinsa; shafin yankin yana nuna

wanda yankinku yake buƙata.

Idan bai haɗu ba

Azure ya ƙi karɓar service principal. Ko dai asirin abokin ciniki (client secret) ya ƙare — suna ƙarewa koyaushe, gwargwadon tsawon lokacin da kuka zaɓa — ko kuma manhajar ba ta da matsayin Contributor a kan rukunin albarkatun kuma. Saƙonnin biyu suna kama da juna, don haka bincika matsayin da aka ba da kafin ƙirƙirar sabon sirri.

Ba a sami komai ba. Tabbatar da cewa Subscription ID da Resource group sune waɗanda kuka ba wa matsayin a kansu, kuma Tenant ID shine babban fayil ɗin da aka yi wa manhajar rajista a ciki.

Yana cewa an ƙi karɓar mabuɗin. Kusan koyaushe yana faruwa ne saboda ɗaya daga cikin abubuwa uku: sarari (space) ko layin da ya katse da aka kwafo tare da shi, mabuɗin da ya ƙare, ko mabuɗin da aka soke ko aka sake samar da shi bayan kun kwafe shi. Ƙirƙiri sabo sannan ku sake liƙa shi.

Ya haɗu, amma wani abu ya gaza daga baya. Mabuɗin yana tabbatar da inganci amma ba shi da izinin da aiki yake buƙata. Ƙirƙiri sabon mabuɗi tare da izini da aka lissafa a sama, sannan ku cire tsohuwar haɗin kuma ku haɗa sabon mabuɗin.

Cire haɗin

Buɗe Integrations, nemo asusun sannan ku danna Disconnect. Wannan yana goge mabuɗin da aka adana nan take. Duk wani abu da ke amfani da shi zai tsaya a aikinsa na gaba, kuma allunan da suka dogara da shi za su bayyana hakan maimakon yin shiru kawai ba tare da sanarwa ba.

Cire haɗin ba ya soke abin da aka riga aka yi — bayanai, tura shafuka ko saitunan da muka canza a asusunku za su ci gaba da zama yadda suke. Idan kuna tunanin cewa mabuɗin da kansa ya fita waje, ku kuma soke shi a wurin dillalin; cire haɗin yana share kwafinmu ne kawai, ba nasu ba.