Çfarë bën lidhja për ju
Lidhja e llogarisë suaj të Azure Static Web Apps ju lejon të publikoni një faqe statike në llogarinë tuaj të Azure Static Web Apps nga paneli i kontrollit të Zinn®. Ju zotëroni projektin dhe faturën; ne kujdesemi për vendosjen, domenin e personalizuar dhe regjistrat DNS.
Para se të filloni
Një abonim në Azure, një grup burimesh për faqet dhe një llogari e lidhur e GitHub, GitLab ose Bitbucket që mban kodin — Azure Static Web Apps kompilon nga një depo. Plani falas i Azure lejon përdorim komercial dhe dy domaine të personalizuara për çdo aplikacion.
1. Krijoni çelësin te Azure Static Web Apps
Azure e quan këtë një parim shërbimi (service principal). Në qendrën e administrimit të Microsoft Entra hapni Entra ID → Regjistrimet e aplikacioneve (App registrations) → Regjistrim i ri (New registration), jepni një emër dhe Regjistrojeni (Register). Në faqen e përmbledhjes së aplikacionit, kopjoni ID-në e aplikacionit (klientit) dhe ID-në e drejtorisë (qiramarrësit). Më pas hapni Certifikatat dhe sekretet (Certificates & secrets) → Sekretere të klientit (Client secrets) → Sekrete të reja të klientit (New client secret), zgjidhni një kohëzgjatje dhe Shtojeni (Add) — kopjoni menjëherë vlerën e sekretit, pasi Azure e shfaq atë vetëm një herë.
Në portalin e Azure, hapni grupin e burimeve që dëshironi të përdorim, pastaj Kontrolli i hyrjes (IAM) → Shto → Shto caktimin e rolit. Zgjidhni rolin Kontribues (Contributor), caktojeni atë te Përdoruesi, grupi ose parimi i shërbimit, kërkoni aplikacionin sipas emrit dhe zgjidhni Rishiko + cakto. Shënoni emrin e grupit të burimeve dhe ID-në e abonimit të cilit i përket (kërkoni për Abonimet në portal).
2. Lidheni këtu
Hapni Integrimet në panelin tuaj të kontrollit dhe zgjidhni Lidh një llogari. Zgjidhni Pritja statike (Netlify, Vercel) si grup dhe Azure Static Web Apps si llogari, plotësoni ID-në e klientit, Sekretin e klientit, ID-në e qiramarrësit, ID-në e abonimit dhe Grupin e burimeve, dhe shtypni Lidh llogarinë.
Ne testojmë atë që ngjisni para se të ruhet ndonjë gjë. Një çelës që nuk punon nuk ruhet kurrë dhe përgjigjja tregon se çfarë nuk shkonte me të. Një çelës që punon mbahet i enkriptuar në kasafortën tonë të sekreteve — kurrë në bazën tonë të të dhënave — dhe nuk shfaqet më kurrë, madje as për ju.
Çfarë ndodh më pas
- Kur krijoni ose zhvendosni një faqe statike, kjo llogari shfaqet si një destinacion vendosjeje.
Azure Static Web Apps kompilon nga një depo — ajo nuk ka asnjë mundësi të pranojë një ndërtim të ngarkuar — kështu që kodi i faqes duhet të vijë nga një depo e lidhur e GitHub, GitLab ose Bitbucket. Lidhni një të tillë paraprakisht nëse nuk e keni bërë.
- Ne krijojmë shërbimin në llogarinë tuaj, e drejtojmë atë te depoja, lidhim domenin tuaj të personalizuar dhe nisim vendosjet. Faqja e domenit tregon çdo regjistër DNS që i nevojitet Azure Static Web Apps.
- Përdorimi dhe faturimi janë në llogarinë tuaj, të dukshme në panelin e kontrollit të shitësit tuaj.
- Një domen rrënjë (apex domain) verifikohet nga një regjistër TXT dhe një nëndomen nga CNAME-ja e tij; faqja e domenit tregon se cili prej tyre i duhet domenit tuaj.
Nëse nuk lidhet
Azure refuzoi parimin e shërbimit. Ose sekreti i klientit ka skaduar — ato skadojnë gjithmonë, në bazë të kohëzgjatjes që keni zgjedhur — ose aplikacioni nuk ka më rolin e Kontribuesit në grupin e burimeve. Të dyja mesazhet duken njësoj, prandaj kontrolloni caktimin e rolit përpara se të krijoni një sekret të ri.
Nuk u gjet asgjë. Kontrolloni që ID-ja e abonimit dhe Grupi i burimeve janë ato ku keni caktuar rolin, dhe se ID-ja e qiramarrësit është drejtoria ku është regjistruar aplikacioni.
Thotë se çelësi u refuzua. Pothuajse gjithmonë bëhet fjalë për një nga këto tri gjëra: një hapësirë ose një ndarje rreshti e kopjuar bashkë me të, një çelës që ka skaduar, ose një çelës që është revokuar apo rigjeneruar pasi e keni kopjuar. Krijoni një të ri dhe ngjisni atë përsëri.
Lidhet, por diçka dështon më vonë. Çelësi vërtetohet, por i mungon një lejim që i nevojitet veprimit. Krijoni një çelës të ri me leijimet e listuara më lart, pastaj shkëputni lidhjen e vjetër dhe lidhni çelësin e ri.
Shkëputja e lidhjes
Hapni Integrimet, gjeni llogarinë dhe shtypni Shkëput lidhjen. Kjo fshin menjëherë çelësin e ruajtur. Çdo gjë që po e përdor atë ndalet në veprimin e radhës, dhe ekranet që viteshin prej tij e tregojnë këtë në vend që të dështojnë në heshtje.
Shkëputja e lidhjes nuk zhbën atë që është bërë tashmë — regjistrat, vendosjet ose cilësimet që kemi ndryshuar në llogarinë tuaj mbeten ashtu siç janë. Nëse mendoni se vetë çelësi mund të jetë rrjedhur, revokojeni atë edhe te shitësi; shkëputja e lidhjes heq kopjen tonë, jo të tyren.