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

එය සම්බන්ධ කිරීමෙන් ඔබට ලැබෙන ප්‍රයෝජන

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

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

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

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

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

Azure ද්වාරයෙහි (portal), ඔබ අපට භාවිත කිරීමට අවශ්‍ය සම්පත් සමූහය විවෘත කරන්න, ඉන්පසු Access control (IAM) → Add → Add role assignment වෙත යන්න. Contributor භූමිකාව තෝරා, එය User, group, or service principal වෙත පවරා, නම අනුව යෙදුම සොයා, Review + assign කරන්න. සම්පත් සමූහයේ නම සහ එය අයත් වන Subscription ID සටහන් කරගන්න (ද්වාරයෙහි 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) සංකේතනය කර තබා ගනී — අපගේ දත්ත සමුදායෙහි කිසි විටෙකත් නොවේ — සහ ඔබට පවා නැවත කිසි විටෙකත් නොපෙන්වයි.

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

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

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

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

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

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

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

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

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

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

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

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