Geli degel ma guurto ah akoonkaaga Azure Static Web Apps

Waxa ay isku xiriddu kuu qabanayso

Isku xiridda akoonkaaga Azure Static Web Apps waxay kuu oggolaanaysaa inaad bog taagan (static site) ku daabacdo akoonkaaga Azure Static Web Apps adiga oo ka samaynaya dashboard-kaaga Zinn®. Adiga ayaa iska leh mashruuca iyo biilasha; anagu waxaan gacanta ku haynaa daabacaadda (deploy), magac-bogeedka gaarka ah (custom domain) iyo diiwaannada DNS.

Kahor inta aadan bilaabin

Rukhsad Azure (Azure subscription), qaybta kheyraadka (resource group) ee bogagga, iyo akoon ku xiran oo GitHub, GitLab ama Bitbucket ah oo koodhka haya — Azure Static Web Apps wuxuu ka dhisaa koodh-kaydiye (repository). Qorshaha bilaashka ah ee Azure wuxuu oggol yahay isticmaalka ganacsiga iyo laba magac-bogeed oo gaar ah barnaamijkiiba (app).

1. Ka dhex abuur furaha Azure Static Web Apps

Azure waxa ay tan ugu yeertaa service principal. Xarunta maamulka ee Microsoft Entra fur Entra ID → App registrations → New registration, magac u bixi oo Register dheh. Bogga guudmarka ee barnaamijka (overview page) ka koobiyee Application (client) ID iyo Directory (tenant) ID. Kadib fur Certificates & secrets → Client secrets → New client secret, dooro muddo kadibna Add dheh — si toos ah u koobiyee qiimaha sirta ah (secret's value), Azure hal mar keliya ayay ku tusinaysaa.

Gudaha bogga Azure (portal), fur resource group-ka aad doonayso inaan isticmaalno, kadibna Access control (IAM) → Add → Add role assignment. Dooro doorka Contributor, ku meelee User, group, or service principal, barnaamijka magac ahaan u raadi, kadibna Review + assign. Xusuusnow magaca resource group-ka iyo Subscription ID-ga uu ka tirsan yahay (ka raadi Subscriptions gudaha portal-ka).

2. Halkaan ku xir

Fur Integrations gudaha dashboard-kaaga oo dooro Connect an account. Dooro Static hosting (Netlify, Vercel) oo ah qaybta (group) iyo Azure Static Web Apps oo ah akoonka, buuxi Client ID, Client secret, Tenant ID, Subscription ID iyo Resource group, kadibna taabo Connect account.

Waxaan tijaabinaynaa waxaad soo dhejisay kahor inta aan waxba la keydin. Fure aan shaqaynayn weligiis lama keydiyo, jawaabtuna waxay sheegaysaa waxa ka khaldanaa. Fure shaqeynaya waxaa si qarsoodi ah (encrypted) loogu hayaa qasnaddayada siraha — weligiis laguma keydiyo xog-kaydiyahayaga (database) — mana la tusiyo mar dambe, xitaa adiga.

Maxaa xiga oo dhacaya

• Markaad abuurto ama aad wareejiso bog taagan, akoonkani wuxuu u soo muuqanayaa meel loo daabaco (deploy target).

Azure Static Web Apps wuxuu wax ka dhisaa koodh-kaydiye — ma haysto hab uu ku aqbalo dhisme la soo geliyay (uploaded build) — sidaas darteed koodhka boggu waa inuu ka yimaadaa koodh-kaydiye ku xiran oo ah GitHub, GitLab ama Bitbucket. Marka hore mid ku xir haddii aadan weli samayn.

• Waxaan adeegga kaga dhex abuuraynaa akoonkaaga, waxaan ku toosinaynaa koodh-kaydiyaha, waxaan ku lifaaqaynaa magac-bogeedkaaga gaarka ah waxaanna kicinaynaa daabacaadaha. Bogga magac-bogeedku wuxuu muujinayaa diiwaan kasta oo DNS ah oo Azure Static Web Apps u baahan yahay.
• Isticmaalka iyo biilashu waxay ku jiraan akoonkaaga, waxaana laga arki karaa dashboard-kaaga iibiyaha (vendor dashboard).
• Magac-bogeedka madaxa ah (apex domain) waxaa lagu xaqiijiyaa diiwaanka TXT, qayb-bogeedkana (subdomain) waxaa lagu xaqiijiyaa CNAME-kiisa; bogga magac-bogeedku wuxuu muujinayaa midka uu magac-bogeedkaagu u baahan yahay.

Haddii uu xirmi waayo

Azure waxay diiday service principal-ka. Ama client secret-kii ayaa dhacay — had iyo jeer way dhacaan, muddadii aad dooratay markay gaarto — ama barnaamijku hadda kuma laha Contributor qaybta kheyraadka (resource group). Labada fariimood way isku shabbahaan, markaa hubi meelaynta doorka (role assignment) kahor inta aadan abuurin sir cusub.

Waxba lama helin. Hubi in Subscription ID iyo Resource group ay yihiin kuwii aad doorka ku meelaysay, iyo in Tenant ID uu yahay tusmada (directory) barnaamijku ka diiwaangashan yahay.

Waxay leedahay furaha waa la diiday. Ku dhawaad had iyo jeer waa mid ka mid ah saddex waxyaabood: bannaan (space) ama khad goyn (line break) la koobiyeeyay, fure dhacay, ama fure la buriyay ama dib loo soo saaray ka dib markii aad koobiyeysay. Abuur mid cusub oo mar kale soo dheji.

Wuu xirmayaa, laakiin wax baa hadhow fashilmaya. Furuhu wuu xaqiijismayaa laakiin ma haysto rukhsad uu ficilku u baahan yahay. Abuur fure cusub oo wata rukhsadaha kor ku taxan, ka dibna fur xiriirkii hore oo ku xir furaha cusub.

Kala goynta

Fur Integrations, hel akoonka oo taabo Disconnect. Taasi waxay markiiba tirtiraysaa furaha keydsan. Wax kasta oo isticmaalayay waxay joogsanayaan ficilkooda xiga, daaqadaha ku tiirsanaana way sheegayaan halkii ay si aamusnaan ah ku fashilmi lahaayeen.

Kala goyntu kama noqonayso wixii hore loo qabtay — diiwaannada, daabacaadaha ama dejimaha aan ku beddelnay akoonkaaga waxay ahaanayaan sidooda. Haddii aad u malaynayso in furaha laftiisu dusi karo, sidoo kale ka buri dhanka iibiyaha; kala goyntu waxay meesha ka saaraysaa koobigayaga, ma aha kooda.