Vendosni një faqe statike në llogarinë tuaj të Azure Static Web Apps

Çfarë bën lidhja e tij për ju

Lidhja e llogarisë suaj Azure Static Web Apps ju lejon të publikoni një faqe statike në llogarinë tuaj Azure Static Web Apps nga paneli juaj i Zinn®. Ju zotëroni projektin dhe faturën; ne menaxhojmë shpërndarjen, domenin e personalizuar dhe regjistrimet DNS.

Përpara se të filloni

Një pajtim në Azure, një grup burimesh për faqet, dhe një llogari e lidhur në GitHub, GitLab ose Bitbucket që mban kodin — Azure Static Web Apps ndërtohet nga një depo kodi (repository). Plani falas i Azure lejon përdorimin komercial dhe dy domene të personalizuara për aplikacion.

1. Krijoni çelësin te Azure Static Web Apps

Azure e quan këtë një service principal. Në qendrën e administrimit Microsoft Entra hapni Entra ID → App registrations → New registration, vendosini një emër dhe bëni Register. Te faqja e përgjithshme e aplikacionit kopjoni Application (client) ID dhe Directory (tenant) ID. Më pas hapni Certificates & secrets → Client secrets → New client secret, zgjidhni një kohëzgjatje dhe bëni Add — kopjoni menjëherë vlerën e çelësit sekret, Azure e shfaq atë vetëm një herë.

Në portalin Azure, hapni grupin e burimeve që dëshironi të përdorim, më pas Access control (IAM) → Add → Add role assignment. Zgjidhni rolin Contributor, caktojeni atë te User, group, or service principal, kërkoni aplikacionin sipas emrit dhe bëni Review + assign. Shënoni emrin e grupit të burimeve dhe Subscription ID të cilit i përket (kërkoni Subscriptions në portal).

2. Lidheni këtu

Hapni Integrations në panelin tuaj dhe zgjidhni Connect an account. Zgjidhni Static hosting (Netlify, Vercel) si grup dhe Azure Static Web Apps si llogari, plotësoni Client ID, Client secret, Tenant ID, Subscription ID dhe Resource group, dhe shtypni Connect account.

Ne testojmë atë që ngjisni përpara se të ruhet ndonjë gjë. Një çelës që nuk funksionon nuk ruhet kurrë, dhe përgjigjja tregon se çfarë nuk shkonte me të. Një çelës që funksionon ruhet i koduar në kasafortën tonë të sekreteve — kurrë në bazën tonë të të dhënave — dhe nuk shfaqet më kurrë, as edhe për ju.

Çfarë ndodh më pas

• Kur krijoni ose zhvendosni një faqe statike, kjo llogari shfaqet si një objektiv

shpërndarjeje. Azure Static Web Apps ndërtohet nga një depo kodi — nuk ka asnjë mënyrë për të pranuar një version të ngarkuar — kështu që kodi i faqes duhet të vijë nga një depo kodi e lidhur në GitHub, GitLab ose Bitbucket. Lidhni fillimisht një të tillë nëse nuk e keni bërë akoma.

• Ne krijojmë shërbimin në llogarinë tuaj, e drejtojmë atë te depoja e kodit, lidhim domenin tuaj të personalizuar

dhe iniciojmë shpërndarjet. Faqja e domenit shfaq çdo regjistrim DNS që i nevojitet Azure Static Web Apps.

• Përdorimi dhe faturimi janë në llogarinë tuaj, të dukshme në panelin e vetë ofruesit tuaj.
• Një domen kryesor (apex domain) verifikohet me një regjistrim TXT dhe një nëndomen me CNAME-in e tij; faqja e domenit tregon

se cilin prej tyre kërkon domeni juaj.

Nëse nuk lidhet

Azure refuzoi "service principal". Ose çelësi sekret i klientit ka skaduar — ato skadojnë gjithmonë, sipas kohëzgjatjes që keni zgjedhur — ose aplikacioni nuk ka më rolin Contributor në grupin e burimeve. Dy mesazhet ngjajnë shumë, prandaj kontrolloni caktimin e rolit përpara se të krijoni një çelës të ri sekret.

Nuk gjendet asgjë. Kontrolloni nëse Subscription ID dhe Resource group janë ato mbi të cilat keni caktuar rolin, dhe nëse Tenant ID është direktoria ku është regjistruar aplikacioni.

Thotë se çelësi u refuzua. Pothuajse gjithmonë është një nga këto të tria: një hapësirë boshe ose një shkëputje rreshti e kopjuar bashkë me të, një çelës që ka skaduar, ose një çelës që është revokuar ose rigjeneruar pasi e keni kopjuar. Krijoni një të ri dhe ngjiteni përsëri.

Lidhet, por diçka dështon më vonë. Çelësi autentikohet, por i mungon një leje që veprimi kërkon. Krijoni një çelës të ri me lejet e listuara më sipër, më pas shkëputni lidhjen e vjetër dhe lidhni çelësin e ri.

Shkëputja

Hapni Integrations, gjeni llogarinë dhe shtypni Disconnect. Kjo fshin çelësin e ruajtur menjëherë. Çdo gjë që po e përdorte atë ndalon në veprimin e radhës, dhe ekranet që vareshin prej tij e njoftojnë këtë në vend që të dështojnë në heshtje.

Shkëputja nuk e zhbën atë që tashmë është bërë — regjistrimet, shpërndarjet ose cilësimet që kemi ndryshuar në llogarinë tuaj mbeten ashtu siç janë. Nëse mendoni se vetë çelësi mund të jetë komprometuar, revokojeni atë gjithashtu te ofruesi; shkëputja heq kopjen tonë, jo të tyren.