አንድ ፕሮጀክት በኮምፒውተርዎ ላይ አንዴ መሥራት ከጀመረ በኋላ፣ ወደ Zinn Digital® ሆስቲንግ በቀጥታ ስርጭት ላይ ወዳለ ድረ-ገጽ ለማድረስ አራት ትዕዛዞች በቂ ናቸው፡ መግባት፣ ፕሮጀክቱን ከሆስቲንግ ማስቀመጫ (slot) ጋር ማገናኘት፣ ቅድመ-ዝግጅቱን (pre-flight) ማንበብ እና ፑሽ ማድረግ። ይህ ጽሑፍ እያንዳንዳቸውን፣ የሚያትሟቸውን ውጤቶች እና ከዚያ በኋላ የሚጠቀሟቸውን ትዕዛዞች — ዳግም ማሰማራቶች (redeploys)፣ የማሰማራት ታሪክ እና የግንባታ ምዝግብ ማስታወሻዎችን (build logs) በዝርዝር ያብራራል።
በኤፒአይ (API) ቁልፍ ይግቡ
በዳሽቦርዱ ውስጥ በSettings → API keys ሥር ቁልፍ ይፍጠሩ፣ ከዚያም፦
zinnector login
ቁልፉ በጥያቄው መጠየቂያ (prompt) ላይ የሚተየብ ነው — በትዕዛዝ መስመሩ (command line) ላይ በጭራሽ ተቀባይነት የለውም፤ ስለዚህ በሼል ታሪክዎ ወይም በሂደት ዝርዝር ውስጥ ሊቀር አይችልም። በCI ውስጥ በፓይፕ ያስገቡት፡ echo "$ZINN_API_KEY" | zinnector login --profile ci፣ ወይም ZINNECTOR_TOKENን ያዘጋጁ እና loginን ሙሉ በሙሉ ይዝለሉ። ቁልፉ ከመቀመጡ በፊት ይረጋገጣል፣ እና በፋይል ሁነታ 600 ይቀመጣል። zinnector whoami --scopes የትኛው ድርጅት ውስጥ እንደገቡ እና ቁልፉ የትኞቹን ፈቃዶች እንደያዘ ያሳያል፤ የሙከራ (sandbox) ቁልፍ እንደ አንድ ተለይቶ ምልክት ይደረግበታል።
ፕሮጀክቱን ከማስቀመጫ (slot) ጋር ያገናኙ
zinnector link # pick a site from a list
zinnector link example.com --repo acme/site --branch main
link የድረ-ገጹን መለያ (id) ወደ zinnector.json ይጽፋል፣ እንዲሁም --no-repo ካላሳለፉ በስተቀር፣ የፕሮጀክቱን git ሪሞት በመድረኩ ላይ ካለው ድረ-ገጽ ጋር ያገናኛል፤ በዚህም ፑሽ ሲደረግ ያሰማራዋል። zinnector.jsonን ኮሚት ያድርጉ፡ ማከማቻውን (repository) ክሎን የሚያደርግ የሥራ ባልደረባ ምንም ሳይነገረው ወደ ተመሳሳይ ቦታ ያሰማራል። ምንም ዓይነት ሚስጥር አልያዘም።
ቅድመ-ዝግጅቱን (pre-flight) ያንብቡ
zinnector check
ይህ CLI የተፈጠረበት ዋናው ትዕዛዝ ነው። ፕሮጀክትዎን ሊሰማራበት ካለው ማስቀመጫ (slot) ጋር ያወዳድራል እና እያንዳንዱን አለመጣጣም — እንዲሁም ማድረግ ያልቻለውን እያንዳንዱን ንጽጽር ያትማል፦
- የPHP ስሪት፣ ዋና የስሪት ልዩነት (major-version gap) እንደ ከፍተኛ ይመደባል ምክንያቱም ድረ-ገጽን በእርግጠኝነት ስለሚያበላሽ፣ እና አነስተኛ ልዩነት (minor gap) ዝቅ ተደርጎ ይመደባል፣ ምክንያቱም ሁሉንም ነገር እንደ አሳሳቢ መመደብ ሰዎች ማስጠንቀቂያውን ችላ እንዲሉ ስለሚያስተምራቸው።
- ማስቀመጫው እርስዎ በገነቡበት ስሪት ላይ መቀየር መቻሉን፣ የማስቀመጫው PHP የአገልግሎት ዘመኑ ያለፈበት (past end of life) መሆኑን፣ እና ማሽኑ ስሪቱን መተግበሩን ወይም ዝም ብሎ የተነገረው ብቻ መሆኑን።
- የፕሮጀክትዎ መጠን እና የፋይል ብዛት በማስቀመጫው ላይ በትክክል ከቀረው የዲስክ እና የinode ክፍተት አንጻር — አንድ የWordPress ዛፍ (tree) ከዲስክ ገደቡ በጣም በታች እያለ የፋይሎች ቁጥር ሊያልቅበት ይችላል።
- በእያንዳንዱ በኩል ያሉት የWordPress ስሪቶች፣ ማስቀመጫው ማዘጋጀቱን (provisioning) ማጠናቀቁን፣ እና ፑሽ የሚደረግበት ማከማቻ (repository) መገናኘቱን።
ያስጠነቅቃል እንጂ በጭራሽ አያግድም። እያንዳንዱ ግኝት በzinnector push --force ሊታለፍ ይችላል፣ ምክንያቱም ስለራስዎ ድረ-ገጽ መርማሪው የማያውቃቸውን ነገሮች እርስዎ ያውቃሉ። ሊደረግ ያልቻለ ንጽጽር እንደ ያልታወቀ (unknown) ሪፖርት ይደረጋል እንጂ ፈጽሞ እንዳለፈ አይቆጠርም፣ እና ማጠቃለያው ሁልጊዜ ስንት እንደነበሩ ይናገራል። እንደ ነባሪ የአካባቢው የPHP ስሪት በzinnector.json ውስጥ የታወጀው ነው፤ --probe የአካባቢውን የሩጫ ጊዜ (runtime) ያስነሳል እና በምትኩ ይለካዋል። --strict ባልታወቁ ነገሮች ላይም ዜሮ ያልሆነ ውጤት ይዞ ይወጣል፣ ይህም የCI መግቢያ በር የሚፈልገው ነው።
ፑሽ ያድርጉ
zinnector push
push ቅድመ-ዝግጅቱን ያካሂዳል፣ ኮሚቶችዎን ፑሽ ያደርጋል፣ ማሰማራቱን ያስጀምራል እና እስኪጠናቀቅ ድረስ ይከታተላል፣ የመጨረሻውን ሁኔታ እና የተሰማራውን ኮሚት ያትማል። --dry-run ከማሰማራቱ በስተቀር ሁሉንም ነገር ያደርጋል፤ --no-wait ያስጀምረዋል እና ይወጣል፤ --no-git መድረኩ አስቀድሞ ያለውን ማንኛውንም ነገር ያለ ፑሽ ያሰማራል። የተሰማራው ኮሚት አሁን ፑሽ የተደረገው ካልሆነ፣ ያንን ይገልጻል።
የሆነ ችግር ሲፈጠር
zinnector deploys example.com # deploy history — status, commit, trigger, message
zinnector logs example.com --build # the build log of the most recent deploy
zinnector logs example.com --error # the site's error log
zinnector deploy example.com # redeploy what the platform already has
zinnector ai "why is my deploy failing?"
zinnector ai በመድረኩ ላይ በራስዎ መለያ ላይ ይሰራል፣ ስለዚህ ተመሳሳይ የማሰማራት ታሪክ እና ምዝግቦችን ማየት ይችላል። ከአንድ ፕሮጀክት ውስጥ ሆኖ የፕሮጀክቱን ቅርጽ — የማውጫ ስሞችን፣ ስሪቶችን እና የድረ-ገጹን መለያ ይልካል እንጂ የፋይል ይዘቶችን በጭራሽ አይልክም።
ተዛማጅ