එයින් ඔබට ලැබෙන ප්රයෝජනය කුමක්ද
ටෝකනයක් සමඟ GitHub සම්බන්ධ කිරීම මඟින් ඔබේ ගබඩාවකින් (repository) අඩවියක් යෙදවීමට (deploy කිරීමට) ඉඩ සලසයි: බ්රාන්ච් එකට (branch) පුෂ් (push) කරන්න, එවිට අඩවිය යාවත්කාලීන වේ. එය අඩවියක හොස්ට්වරයා ලෙස ඔබ තෝරා ගන්නා ස්ථානයේ, ඔබේ ගණුදෙනු ගිණුමෙහි ඇති GitHub Pages වෙත ප්රකාශයට පත් කිරීමටද අපට ඉඩ සලසයි.
ඔබගේ ගබඩා සංවිධානයකට අයත් නම්, ඒ වෙනුවට the Zinn® GitHub app භාවිතා කිරීමට උත්සාහ කරන්න — Install the Zinn® GitHub app බලන්න. ටෝකනයක් එක් පුද්ගලයෙකුට අයත් වන අතර එම පුද්ගලයා ඉවත් වූ විට එය ක්රියා කිරීම නවීයි.
ඔබ ආරම්භ කිරීමට පෙර
ඔබට යෙදවීමට අවශ්ය ගබඩා වෙත ප්රවේශය ඇති GitHub ගිණුමක්. ඒවා සංවිධානයකට අයත් නම්, හිමිකරුවෙකුට (owner) ඒ සඳහා සියුම් ලෙස සකස් කළ ටෝකන (fine-grained tokens) අනුමත කිරීමට සිදු විය හැක.
1. GitHub හි යතුර සාදා ගන්න
GitHub හි, ඔබගේ ප්රොෆයිල් පින්තූරය මත ක්ලික් කරන්න, ඉන්පසු Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token වෙත යන්න. එයට නමක් දී කල් ඉකුත් වීමේ දිනයක් තෝරන්න. Repository access යටතේ Only select repositories තෝරා ඔබ යොදවන ඒවා තෝරන්න — ක්රියාත්මක වන අවම ප්රවේශය එයයි.
Repository permissions යටතේ පහත ඒවාට Read and write ලබා දෙන්න:
- Contents
- Pages
- Administration
Generate token ඔබා එය පිටපත් කරන්න — GitHub එය පෙන්වන්නේ එක් වරක් පමණි.
2. එය මෙහි සම්බන්ධ කරන්න
ඔබගේ ඩෑෂ්බෝඩ් එකේ Integrations විවෘත කර Connect an account තෝරන්න. සමූහය ලෙස Code hosting සහ ගිණුම ලෙස GitHub තෝරන්න, API token පුරවා, Connect account ඔබන්න.
කිසිවක් සුරැකීමට පෙර ඔබ අලවන (paste කරන) දේ අපි පරීක්ෂා කර බැලීමු. ක්රියාත්මක නොවන යතුරක් කිසි විටෙකත් ගබඩා නොකෙරේ, සහ එය කුමක් නිසා වැරදි දැයි ප්රතිචාරය මඟින් පෙන්වයි. ක්රියාත්මක වන යතුරක් අපගේ රහස් සුරක්ෂිතාගාරයේ (secrets vault) සංකේතනය කර තබා ගනී - කිසි විටෙකත් අපගේ දත්ත සමුදායේ (database) නොවේ - සහ කිසි විටෙකත් නැවත පෙන්වනු නොලැබේ, ඔබටවත් නොවේ.
ඊළඟට සිදුවන්නේ කුමක්ද
- මෙම ගිණුමේ ඇති ගබඩාවකින් සෘජුවම අඩවියක් යෙදවිය හැක: අඩවියේ ගබඩා සම්බන්ධතාවයෙන් එය තෝරන්න, ගබඩාව සහ බ්රාන්ච් එක තෝරන්න, එවිට පුෂ් (push) කිරීමක් මඟින් යෙදවීම සිදුවේ.
- අනෙක් සෑම බ්රාන්ච් එකකටම තමන්ගේම පෙරදසුනක් (preview) ලබා ගත හැක, එබැවින් සජීවී අඩවියට ළඟා වීමට පෙර ඔබට වෙනසක් පරීක්ෂා කළ හැක.
- Render සහ Azure Static Web Apps වැනි Git මඟින් තැනූ ස්ථිතික හොස්ට්වරු (static hosts) අඩවියේ කේතයේ මූලාශ්රය ලෙස මෙම සම්බන්ධතාවය භාවිතා කරයි.
එය සම්බන්ධ නොවන්නේ නම්
ගබඩාවක් නොපෙන්වයි. ටෝකනයේ ගබඩා ප්රවේශයට එය ඇතුළත් නොවේ. GitHub හි ටෝකනය සංස්කරණය කර ගබඩාව එක් කරන්න.
එය ක්රියාත්මක වී පසුව නැවතුණා. සියුම් ලෙස සකස් කළ ටෝකන ඔබ තෝරාගත් දිනයේදී කල් ඉකුත් වේ. අලුත් එකක් ජනනය කර එය සම්බන්ධ කරන්න; ටෝකනයක් කල් ඉකුත් වීමට පෙර GitHub ඔබට විද්යුත් තැපෑලක් එවා දැනුවත් කරයි.
යතුර ප්රතික්ෂේප කළ බව පවසයි. බොහෝ විට මෙම කරුණු තුනෙන් එකකි: එය සමඟ පිටපත් වූ හිස් අවකාශයක් (space) හෝ පේළි බිඳීමක් (line break), කල් ඉකුත් වූ යතුරක්, නැතහොත් ඔබ එය පිටපත් කිරීමෙන් පසු අස්කර ගන්නා ලද (revoked) හෝ නැවත ජනනය කරන ලද (regenerated) යතුරක්. අලුත් එකක් සාදා එය නැවත අලවන්න.
එය සම්බන්ධ වේ, නමුත් පසුව යම් දෙයක් අසමත් වේ. යතුර සත්යාපනය වේ නමුත් ක්රියාවට අවශ්ය අවසරය නොමැත. ඉහත ලැයිස්තුගත කර ඇති අවසරයන් සමඟ නව යතුරක් සාදන්න, ඉන්පසු පැරණි සම්බන්ධතාවය විසන්ධි කර නව යතුර සම්බන්ධ කරන්න.
විසන්ධි කිරීම
Integrations විවෘත කරන්න, ගිණුම සොයාගෙන Disconnect ඔබන්න. එයින් ගබඩා කර ඇති යතුර එකවරම මකා දමනු ලැබේ. එය භාවිතා කරමින් තිබූ ඕනෑම දෙයක් එහි මූලික ක්රියාවෙන් නවත්වන අතර, එය මත යැපුණු තිර නිහඬව අසමත් වීමට වඩා ඒ බව පවසයි.
විසන්ධි කිරීමෙන් දැනටමත් සිදු කර ඇති දේ ආපසු හැරවීමක් සිදු නොවේ - අප විසින් ඔබේ ගිණුමේ වෙනස් කරන ලද වාර්තා, යෙදවීම් හෝ සැකසුම් පවතින පරිදිම පවතී. යතුරම කාන්දු වී ඇතැයි ඔබ සිතන්නේ නම්, සැපයුම්කරුගෙන් එය අවලංගු කරන්න; විසන්ධි කිරීම මඟින් ඉවත් කරනු ලබන්නේ අපගේ පිටපතයි, ඔවුන්ගේ එක නොවේ.