ඔfl ඔබේම Azure Static Web Apps ගිණුමට ස්ථිතික වෙබ් අඩවියක් යොදවන්න (Deploy කරන්න)

එය සම්බන්ධ කිරීමෙන් ඔබට ලැබෙන වාසිය

ඔබගේම Azure Static Web Apps ගිණුම සම්බන්ධ කිරීමෙන් ඔබගේ Zinn® පාලක පුවරුවේ (dashboard) සිට ඔබගේ Azure Static Web Apps ගිණුම වෙත ස්ථිතික වෙබ් අඩවියක් (static site) ප්‍රකාශනය කිරීමට ඔබට ඉඩ සලසයි. ව්‍යාපෘතිය සහ බිල්පත අයිති ඔබටයි; සක්‍රිය කිරීම (deploy), අභිරුචි ඩොමේනය (custom domain) සහ DNS වාර්තා (DNS records) මෙහෙයවනු ලබන්නේ අප විසිනි.

ඔබ ආරම්භ කිරීමට පෙර

Azure සබ්ස්ක්‍රිප්ෂනයක්, වෙබ් අඩවි සඳහා සම්පත් සමූහයක් (resource group), සහ කේතය අඩංගු සම්බන්ධිත GitHub, GitLab හෝ Bitbucket ගිණුමක් — Azure Static Web Apps ගොඩනගනු ලබන්නේ රෙපොසිටරියකින් (repository) වේ. Azure හි නොමිලේ ලබාදෙන සැලසුම මගින් වාණිජමය භාවිතය සහ ඇප් එකකට අභිරුචි ඩොමේන දෙකක් ලබා දෙයි.

1. Azure Static Web Apps හි යතුර සාදන්න

Azure විසින් මෙය service principal එකක් ලෙස හඳුන්වයි. Microsoft Entra admin center හි Entra ID → App registrations → New registration විවෘත කර, ඊට නමක් ලබා දී එය Register කරන්න. ඇප් එකේ දළ විශ්ලේෂණ පිටුවේ (overview page) ඇති Application (client) ID සහ Directory (tenant) ID පිටපත් කර ගන්න. ඉන්පසුව Certificates & secrets → Client secrets → New client secret විවෘත කර, කාල සීමාවක් තෝරා එය Add කරන්න — Azure විසින් රහස්‍ය අගය (secret's value) පෙන්වන්නේ එක් වරක් පමණක් බැවින් එය වහාම පිටපත් කර ගන්න.

Azure portal හි, අප විසින් භාවිත කිරීමට ඔබ කැමති සම්පත් සමූහය (resource group) විවෘත කර, Access control (IAM) → Add → Add role assignment වෙත යන්න. Contributor භූමිකාව (role) තෝරා, එය User, group, or service principal වෙත පවරන්න (assign), නම මගින් ඇප් එක සෙවුම් කර, Review + assign කරන්න. සම්පත් සමූහයේ නම සහ එය අයත් වන Subscription ID එක සටහන් කර ගන්න (portal හි Subscriptions සෙවුම් කරන්න).

2. එය මෙහි සම්බන්ධ කරන්න

ඔබගේ පාලක පුවරුවේ Integrations විවෘත කර Connect an account තෝරන්න. කාණ්ඩය ලෙස Static hosting (Netlify, Vercel) සහ ගිණුම ලෙස Azure Static Web Apps තෝරා, Client ID, Client secret, Tenant ID, Subscription ID සහ Resource group පුරවා, Connect account ඔබන්න.

කිසිවක් සුරැකීමට පෙර ඔබ ඇතුළත් කරන දේ අපි පරීක්ෂා කරමු. ක්‍රියා නොකරන යතුරක් කිසි විටෙකත් ගබඩා නොකරන අතර, එහි ඇති දෝෂය කුමක්දැයි පිළිතුරෙන් පැහැදිලි කරයි. ක්‍රියා කරන යතුරක් අපගේ රහස්‍ය සුරක්ෂිතාගාරයේ (secrets vault) සංකේතනය කර තබනු ලැබේ — කිසි විටෙකත් අපගේ දත්ත සමුදායේ (database) තබන්නේ නැත — තවද එය ඔබට පවා නැවත කිසි දිනෙක පෙන්වන්නේ නැත.

ඊළඟට සිදුවන්නේ කුමක්ද

• ඔබ ස්ථිතික වෙබ් අඩවියක් සාදන විට හෝ ගෙන යන විට, මෙම ගිණුම සක්‍රිය කිරීමේ ඉලක්කයක් (deploy target) ලෙස දර්ශනය වේ.

Azure Static Web Apps ගොඩනගනු ලබන්නේ රෙපොසිටරියකින් බැවින් — උඩුගත කරන ලද බිල්ඩ් එකක් (uploaded build) පිළිගැනීමට ඊට හැකියාවක් නැත — එබැවින් වෙබ් අඩවියේ කේතය සම්බන්ධිත GitHub, GitLab හෝ Bitbucket රෙපොසිටරියකින් පැමිණිය යුතුය. ඔබ තවම සම්බන්ධ කර නැතිනම් පළමුව එකක් සම්බන්ධ කරන්න.

• අපි ඔබගේ ගිණුමෙහි සේවාව සාදා, එය රෙපොසිටරිය වෙත යොමු කර, ඔබගේ අභිරුචි ඩොමේනය යා කර සක්‍රිය කිරීම් (deploys) ආරම්භ කරමු. ඩොමේනයේ පිටුව මගින් Azure Static Web Apps සඳහා අවශ්‍ය ඕනෑම DNS වාර්තාවක් පෙන්වයි.
• භාවිතය සහ බිල්පත් කිරීම ඔබගේ ගිණුමෙහි සිදු වන අතර, ඒවා ඔබගේම සැපයුම්කරුගේ පාලක පුවරුවෙන් (vendor dashboard) බලා ගත හැක.
• Apex ඩොමේනයක් TXT වාර්තාවකින්ද, subdomain එකක් එහි CNAME මගින්ද තහවුරු කරනු ලබයි; ඔබගේ ඩොමේනයට අවශ්‍ය කවරක්දැයි ඩොමේනයේ පිටුව මගින් පෙන්වයි.

එය සම්බන්ධ නොවන්නේ නම්

Azure විසින් service principal ප්‍රතික්ෂේප කරන ලදී. එක්කෝ client secret හි වලංගු කාලය ඉකුත් වී ඇත — ඔබ තෝරාගත් කාල සීමාව අනුව ඒවා සැමවිටම ඉකුත් වේ — නැතහොත් ඇප් එකට සම්පත් සමූහය (resource group) මත තවදුරටත් Contributor බලතල නොමැත. මෙම පණිවිඩ දෙක සමාන බැවින්, නව secret එකක් සෑදීමට පෙර භූමිකා පැවරුම (role assignment) පරීක්ෂා කරන්න.

කිසිවක් සොයා ගැනීමට නැත. Subscription ID සහ Resource group යනු ඔබ භූමිකාව පැවරූ ඒවාමද යන්න සහ Tenant ID යනු ඇප් එක ලියාපදිංචි කර ඇති ඩිරෙක්ටරියමද යන්න පරීක්ෂා කරන්න.

යතුර ප්‍රතික්ෂේප කළ බව පවසයි. බොහෝ විට මෙයට හේතු තුනෙන් එකක් විය හැක: එය සමඟ පිටපත් වූ හිස්තැනක් (space) හෝ පේළි කඩනයක් (line break), වලංගු කාලය ඉකුත් වූ යතුරක්, නැතහොත් ඔබ පිටපත් කිරීමෙන් පසු අවලංගු කළ හෝ නැවත උත්පාදනය කළ යතුරක්. අලුත් එකක් සාදා එය නැවත ඇතුළත් කරන්න.

එය සම්බන්ධ වේ, නමුත් පසුව යමක් අසාර්ථක වේ. යතුර සත්‍යාපනය වන නමුත් එම ක්‍රියාවට අවශ්‍ය අවසරය ඊට නොමැත. ඉහත දැක්වෙන අවසරයන් සහිත නව යතුරක් සාදා, පරණ සම්බන්ධතාව විසන්ධි කර නව යතුර සම්බන්ධ කරන්න.

විසන්ධි කිරීම

Integrations විවෘත කර, ගිණුම සොයාගෙන Disconnect ඔබන්න. එමගින් ගබඩා කර ඇති යතුර වහාම මැකී යයි. එය භාවිතා කරමින් තිබූ ඕනෑම දෙයක් එහි ඊළඟ ක්‍රියාවේදී නතර වන අතර, නිහඬව අසාර්ථක වෙනවා වෙනුවට ඒ මත පදනම් වූ තිර මගින් ඒ බව දැනුම් දෙයි.

විසන්ධි කිරීම මගින් දැනටමත් සිදු කර ඇති දේ ආපසු හැරවීම සිදු නොවේ — ඔබගේ ගිණුමේ අපි වෙනස් කළ වාර්තා, සක්‍රිය කිරීම් හෝ සැකසීම් එලෙසම පවතී. යතුරම කාන්දුවී ඇති බව ඔබ සිතන්නේ නම්, සැපයුම්කරු වෙතින්ද එය අවලංගු කරන්න; විසන්ධි කිරීම මගින් ඉවත් කරන්නේ අප සතු පිටපත මිස ඔවුන් සතු පිටපත නොවේ.