ረጅም ዕድሜ ያለው ቶከን (token) ሳያስፈልግ ማሰማራት እንድንችል የZinn® GitHub መተግበሪያን ይጫኑ

ማገናኘትዎ ምን ጥቅም ይሰጥዎታል

የZinn® GitHub መተግበሪያን መጫን አንድ ድር ጣቢያ ከእርስዎ ማከማቻዎች (repositories) እንዲሰማራ (deploy) ያስችላል — እና የፕሮጀክት ሰሌዳ ከGitHub ጋር እንዲመሳሰል ያደርጋል — የግል ቶከን (token) ለእኛ ሳይሰጡ። እኛ የምንይዘው በራሱ ከንቱ የሆነውን የመተግበሪያውን የመጫኛ ቁጥር (installation number) ብቻ ነው፣ እና በሚያስፈልገን ጊዜ ሁሉ ለአንድ ሰዓት የሚቆይ ቶከን እናመነጫለን። ለአንድ ድርጅት የተሻለ ምርጫ ነው፣ ምክንያቱም የማንም ግለሰብ ንብረት ስላልሆነ እና ማንም ሲወጣ መስራት ስለማያቆም ነው።

ከመጀመርዎ በፊት

የGitHub መለያ፣ ወይም መተግበሪያውን መጫን በፈለጉት ድርጅት ላይ የባለቤትነት መብቶች። የሶስተኛ ወገን መተግበሪያዎችን የሚከለክሉ ድርጅቶች እንዲፈቅድላቸው ባለቤት ያስፈልጋቸዋል፤ ያ የማይቻል ከሆነ፣ በምትኩ ጥቃቅን ቶከን (fine-grained token) ይጠቀሙ (የእርስዎን የGitHub መለያ ያገናኙ)።

1. ቁልፉን በ GitHub ላይ ይፍጠሩ

የሚፈጠር ቁልፍ የለም። የZinn® GitHub መተግበሪያን በግል መለያዎ ወይም በድርጅትዎ ላይ ይጫኑ፣ እና ሁሉንም ማከማቻዎች ወይም እኛ እንድንሰማራላቸው (deploy እንድንላቸው) የሚፈልጓቸውን ብቻ ይምረጡ።

ከዚያ የመጫኛ ቁጥሩን ያግኙ፡

• የግል መለያ — Settings → Applications → Installed GitHub Apps፣ እና ከZinn® መተግበሪያ ቀጥሎ ያለውን Configure ይጫኑ።
• ድርጅት — Your organizations → Settings → GitHub Apps፣ እና ከZinn® መተግበሪያ ቀጥሎ ያለውን Configure ይጫኑ።

በዚያ ገጽ ላይ ባለው የአድራሻ አሞሌ (address bar) መጨረሻ ላይ ያለው ቁጥር — ለምሳሌ github.com/settings/installations/12345678 — የመጫኛ ቁጥር ነው።

2. እዚህ ጋር ያገናኙት

መተግበሪያው የሚመረጠው በIntegrations ማያ ገጽ ላይ ሳይሆን ጥቅም ላይ በሚውልበት ቦታ ነው፡

• በድር ጣቢያ ማከማቻ ግንኙነት ላይ፣ GitHub (app install) የሚለውን ይምረጡ።
• በፕሮጀክት ሰሌዳ የGitHub አገናኝ ላይ፣ The Zinn® GitHub app የሚለውን ይምረጡ።

የመጫኛ ቁጥሩን (Installation number) ለጥፈው ይቀጥሉ። ማንኛውንም ነገር ከማስቀመጣችን በፊት ጭነቱን እንፈትሻለን፤ ሊደረስበት የማይችል ቁጥር በጭራሽ አይቀመጥም።

ቀጥሎ ምን ይሆናል

• መተግበሪያውን የፈቀዱላቸው ማከማቻዎች ድር ጣቢያው ከእነሱ ላይ እንዲሰማራ (deploy እንዲያደርግ) ይታያሉ፣ እና ግፊት (push) ማሰማራትን ይፈጽማል።
• የምናደርገው እያንዳንዱ እርምጃ በእርስዎ ስም ሳይሆን በመተግበሪያው ስም በGitHub ላይ ባለው የመጫኛ ኦዲት ምዝግብ ማስታወሻ (audit log) ውስጥ ይታያል።
• ተጨማሪ ማከማቻዎችን ለእኛ ለመሰጠት፣ በተመሳሳይ የConfigure ገጽ ላይ የመተግበሪያውን የማከማቻ መዳረሻ ይቀይሩ — ምንም ነገር እንደገና ማገናኘት አያስፈልግም።

የማይገናኝ ከሆነ

ማከማቻ ጠፍቷል። ጭነቱ የሚሸፍነው እርስዎ የመረጧቸውን ማከማቻዎች ብቻ ነው። Configure የሚለውን ይክፈቱ እና ያክሉት።

ቁጥሩ ውድቅ ተደርጓል። ከአድራሻ አሞሌው የመጫኛ ቁጥር እንጂ የመተግበሪያው የራሱ መታወቂያ (ID) አለመሆኑን ያረጋግጡ፣ እና መተግበሪያው አሁንም መጫኑን ያረጋግጡ — ያልተጫነ መተግበሪያ ጭነት የለውም።

ቁልፉ ውድቅ ተደርጓል ይላል። አብዛኛውን ጊዜ ከሶስቱ አንዱ ነው፡ ከእሱ ጋር የተቀዳ ክፍተት ወይም መስመር እረፍት (line break)፣ ጊዜው ያለፈበት ቁልፍ፣ ወይም ከገለበጡት በኋላ የተሻረ (revoked) ወይም እንደገና የተፈጠረ ቁልፍ። አዲስ ይፍጠሩ እና እንደገና ይለጥፉት።

ይገናኛል፣ ነገር ግን ቆይቶ የሆነ ነገር ይወድቃል። ቁልፉ ያረጋግጣል ነገር ግን እርምጃው የሚያስፈልገውን ፈቃድ ይጎድለዋል። ከላይ የተዘረዘሩትን ፈቃዶች ያሉት አዲስ ቁልፍ ይፍጠሩ፣ ከዚያ አሮጌውን ግንኙነት ያላቅቁ እና አዲሱን ቁልፍ ያገናኙ።

ግንኙነቱን ማቋረጥ

Integrations የሚለውን ይክፈቱ፣ መለያውን ያግኙ እና Disconnect የሚለውን ይጫኑ። ይህ የተቀመጠውን ቁልፍ ወዲያውኑ ይሰርዘዋል። እሱን ይጠቀም የነበረ ማንኛውም ነገር በሚቀጥለው እርምጃው ይቆማል፣ እና በእሱ ላይ የተመሰረቱ ማያ ገጾች በጸጥታ ከመውደቅ ይልቅ ያንን ይናገራሉ።

ግንኙነት ማቋረጥ ቀደም ሲል የተሰራውን አይቀለብሰውም — በእርስዎ መለያ ላይ የለወጥናቸው መዝገቦች፣ ስማራቶች (deployments) ወይም ቅንብሮች እንዳሉ ይቆያሉ። ቁልፉ ራሱ ሊፈስ ይችላል ብለው ካስቡ፣ እንዲሁም በአቅራቢው (vendor) ላይ ይሽሩት (revoke ያድርጉት)፤ ግንኙነት ማቋረጥ የእኛን ቅጂ ያስወግዳል እንጂ የእነሱን አይደለም።