Skip to main content

Cloudways Integration

አጠቃላይ እይታ (Overview)​

Cloudways በDigitalOcean፣ AWS፣ Google Cloud እና ሌሎችንም የመሳሰሉ የተለያዩ የክላውድ ሰሪዎችን (cloud providers) ላይ WordPress ድረ-ገጾችን እንድትሰርጽ የሚያስችል የሚተዳደር የክላውድ ሆስቲንግ መድረክ ነው። ይህ integration ደግሞ በUltimate Multisite እና በCloudways መካከል የዶሜን ስም (domain) መረጃዎችን በራስ-ሰር ማመሳሰል (automatic domain syncing) እና የSSL ሰርተፍኬት አስተዳደርን ያስችላል።

ባህሪያት (Features)​

  • በራስ-ሰር የዶሜን ስም መመሳሰል (Automatic domain syncing)
  • የSSL ሰርተፍኬት አስተዳደር (SSL certificate management)
  • ለተጨማሪ ዶሜኖች ድጋፍ (Support for extra domains)
  • ለSSL ሰርተፍኬቶች የDNS ማረጋገጫ (DNS validation)

የሚያስፈልጉ ነገሮች (Requirements)​

የሚከተሉት constant ቋሚዎች በwp-config.php ፋይልዎ ውስጥ መገለጽ አለባቸው።

define('WU_CLOUDWAYS_EMAIL', 'your_cloudways_email');
define('WU_CLOUDWAYS_API_KEY', 'your_api_key');
define('WU_CLOUDWAYS_SERVER_ID', 'your_server_id');
define('WU_CLOUDWAYS_APP_ID', 'your_app_id');

በተጨማሪም፣ በፈለጉት መሰረት የሚከተለውን መግለጽ ይችላሉ።

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'comma,separated,list,of,domains');

የማስጫ መመሪያዎች (Setup Instructions)​

1. የCloudways API መለያዎችን ማግኘት (Get Your Cloudways API Credentials)​

  1. ወደ Cloudways dashboardዎ ይግቡ።
  2. ወደ "Account" > "API Keys" ይሂዱ።
  3. የAPI key የሌለዎት ከሆነ አዲስ ይፍጠሩ።
  4. ኢሜል አድራሻዎን እና የAPI keyዎን ይቅዱ።

2. የሰርቨር እና የአፕሊኬሽን IDዎችን ማግኘት (Get Your Server and Application IDs)​

  1. በCloudways dashboardዎ ውስጥ ወደ "Servers" ይሂዱ።
  2. የWordPress multisiteዎ የተስተናገደበትን ሰርቨር ይምረጡ።
  3. የServer ID በURL ውስጥ ይታያል፡ https://platform.cloudways.com/server/{SERVER_ID}
  4. ወደ "Applications" ይሂዱ እና የWordPress applicationዎን ይምረጡ።
  5. የApp ID በURL ውስጥ ይታያል፡ https://platform.cloudways.com/server/{SERVER_ID}/application/{APP_ID}

3. constant ቋሚዎችን በwp-config.php ውስጥ መጨመር (Add Constants to wp-config.php)​

የሚከተሉትን constant ቋሚዎች ወደ wp-config.php ፋይልዎ ይጨምሩ።

define('WU_CLOUDWAYS_EMAIL', 'your_cloudways_email');
define('WU_CLOUDWAYS_API_KEY', 'your_api_key');
define('WU_CLOUDWAYS_SERVER_ID', 'your_server_id');
define('WU_CLOUDWAYS_APP_ID', 'your_app_id');

በተጨማሪ፣ በmultisiteዎ ኔትወርክ ውጪ (external) የሆኑ እና ሁልጊዜ በCloudways aliases ዝርዝር ውስጥ መቆየት ያለባቸው ተጨማሪ ዶሜኖች ካሉዎት፡

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'extradomain1.com,extradomain2.com');
የራስዎን ኔትወርክ ዋይልድካርድ (wildcard) አይጨምሩ

በWU_CLOUDWAYS_EXTRA_DOMAINS ውስጥ *.your-network.com (ወይም የራስዎ ኔትወርክ ማንኛውንም የsubdomain pattern) አይጨምሩ። ይህ ለምን እንደሚያስቀር የሚገልጽ ዝርዝርን ለማየት Important — wildcard SSL pitfall ላይ ይመልከቱ።

4. integration ን ማብራት (Enable the Integration)​

  1. በWordPress adminዎ ውስጥ ወደ Ultimate Multisite > Settings ይሂዱ።
  2. ወደ "Domain Mapping" tab ይጓዙ።
  3. እስከ "Host Integrations" ድረስ ዝቅ ይሏቸው።
  4. የCloudways integration ን ያብሩ።
  5. "Save Changes" የሚለውን ይጫኑ።

እንዴት ይሰራል (How It Works)​

የዶሜን መመሳሰል (Domain Syncing)​

አንድ ዶሜን በUltimate Multisite ሲመዘገብ (mapped):

  1. integration አሁን የተመዘገቡትን ሁሉንም ዶሜኖች ያገኛል።
  2. አዲሱን ዶሜን ወደ ዝርዝሩ ይጨምራል (በተግባራዊ ከሆነ የwww ስሪት ጋር)።
  3. የተሟላውን ዝርዝር በAPI በCloudways ይልካል።
  4. Cloudways ለapplicationዎ የዶሜን aliases ዝርዝርን ያዘምናል (updates)።

ማስታወሻ፡ Cloudways API እያንዳንዱን ዶሜን ሲጨምሩ ወይም ሲያስወግዱ ሳይሆን፣ ሁልጊዜ የተሟላውን የዶሜን ዝርዝር መላክ ይጠይቃል።

የSSL ሰርተፍኬት አስተዳደር (SSL Certificate Management)​

ዶሜኖች ከተመሳሰሉ በኋላ:

  1. integration የትኞቹ ዶሜኖች ወደ ሰርቨርዎ የሚመ 指 የDNS records እንዳላቸው ይፈትሻል።
  2. እነዚህን ዶሜኖች የLet's Encrypt SSL ሰርተፍኬቶችን እንዲልኩ Cloudwaysን ጥያቄ ይልካል።
  3. Cloudways የSSL ሰርተፍኬት አወጣጥን (issuance) እና መጫኑን (installation) ይይዛል።

integration ሁልጊዜ መደበኛ (non-wildcard) Let's Encrypt ሰርተፍኬቶችን ከCloudways ይጠይቃል። በWU_CLOUDWAYS_EXTRA_DOMAINS ውስጥ የዋይልድካርድ pattern ከተሰጠ፣ መሪው *. ከSSL ጥያቄው በፊት ይወገዳል — ዋይልድካርዱ ራሱ በዚህ integration አይጫንም። በCloudways ላይ የዋይልድካርድ ሰርተፍኬት ለመጠቀም በራስዎ መጫን አለብዎት፣ ነገር ግን ይህ የሚያደርጉት በየዶሜኑ ላይ የሚደረገውን Let's Encrypt አወጣጥ ይከለክላል (pitfall በታች ይመልከቱ)።

ተጨማሪ ዶሜኖች (Extra Domains)​

የWU_CLOUDWAYS_EXTRA_DOMAINS constant ተጨማሪ ውጫዊ (external) ዶሜኖች ሁልጊዜ በCloudways application aliases ዝርዝር ውስጥ መቆየት እንዳለባቸው ያስችላል። የሚከተሉትን ለመጠቀም ይጠቀሙበት፡

  • በUltimate Multisite ያልተተዳደሩ ውጫዊ ዶሜኖች (ለምሳሌ ተመሳሳይ Cloudways application የሚጋራ የተለየ የግብይት ድረ-ገጽ)
  • በapplication aliases ዝርዝር ውስጥ እንዲቆዩ የሚፈለጉ የተቆሙ (Parked) ወይም የstaging ዶሜኖች

ይህ constant የራስዎን ኔትወርክ የsubdomain wildcard (ለምሳሌ *.your-network.com) አይጠቀሙ። የዋይልድካርድ SSL pitfall በታች ይመልከቱ።

አስፈላጊ — የዋይልድካርድ SSL ችግር (Important — Wildcard SSL Pitfall)​

Cloudways's መደበኛ setupን ሲከተሉ የሚፈጠረው የተለመደ ስህተት በWU_CLOUDWAYS_EXTRA_DOMAINS ውስጥ *.your-network.com የመሳሰሉ ዋይልድካርድን መጨመር፣ ወይም ለዚያ ዋይልድካርድ በCloudways በራሱ የSSL ሰርተፍኬት መጫን ነው።

ይህን ካደረጉ፣ Ultimate Multisite የሚያመጣቸውን በየተጠቃሚው ዶሜን (per-tenant custom domains) ላይ የLet's Encrypt ሰርተፍኬቶችን Cloudways ለመስጠት ይከራከራል። Cloudways እያንዳንዱ ጊዜ በapplication ላይ ያለውን ንቁ SSL ሰርተፍኬት ይተካዋል፣ እና በapplication ላይ ቀድሞ የነበረ ዋይልድካርድ ሰርተፍኬት integration ላይ ጥገኛ የሆነውን በየዶሜኑ ላይ የሚደረገውን Let's Encrypt አወጣጥ ይከለክላል።

ለUltimate Multisite ኔትወርክ የሚመከር የCloudways SSL setup​

  1. በCloudways application's SSL Certificate tab ውስጥ፣ መደበኛ Let's Encrypt ሰርተፍኬት ብቻ ይጫኑ። ይህም your-network.com እና www.your-network.comን ብቻ ይሸፍናል — ዋይልድካርድ አይደለም።
  2. *.your-network.com (ወይም የራስዎ ኔትወርክ ማንኛውንም የsubdomain pattern) በWU_CLOUDWAYS_EXTRA_DOMAINS ውስጥ አይጨምሩ። ይህ constant ለውጫዊ ዶሜኖች ብቻ ይያዙት።
  3. የsubsites እንዲሰሩ የየተጠቃሚውን የsubdomain wildcard በDNS ደረጃ ብቻ ይፍጠሩ (ለ*.your-network.com ወደ Cloudways server IP የሚያመለክት A record)። ለግለሰብ የተመዘገቡ ዶሜኖች SSL ከዚያ በintegration በLet's Encrypt በራስ-ሰር ይሰጣሉ።

የተጠቃሚዎች የcustom ዶሜኖች በSSL ሳይገኙ ከተቀሩ፣ የCloudways SSL tabን ይፈትሹ። እዚያ ዋይልድካርድ ሰርተፍኬት (በእጅ የተጫነ፣ ወይም *.your-network.com የሚሸፍን) ካለ፣ ያስወግዱት፣ ለዋናው የኔትወርክ ዶሜን ብቻ መደበኛ Let's Encrypt ሰርተፍኬት እንደገና ይስጡ፣ እና ከWU_CLOUDWAYS_EXTRA_DOMAINS ማንኛውንም ዋይልድካርድ entry ያስወግዱ። ከዚያ የዶሜን መመሳሰልን እንደገና ይጀምሩ (re-trigger) (ወይም በሚቀጥለው ጊዜ ይጠብቁ) እና integration በየዶሜኑ ላይ ሰርተፍኬቶችን መስጠት ይጀምራል።

ችግር መፍታት (Troubleshooting)​

የAPI ግንኙነት ችግሮች (API Connection Issues)​

  • ኢሜል አድራሻዎ እና የAPI keyዎ ትክክል መሆናቸውን ያረጋግጡ።
  • የሰርቨር እና የአፕሊኬሽን IDዎ ትክክል መሆናቸውን ያረጋግጡ።
  • የCloudways accountዎ አስፈላጊውን ፈቃድ (permissions) እንዳለው ያረጋግጡ።

የSSL ሰርተፍኬት ችግሮች (SSL Certificate Issues)​

  • Cloudways ሰርተፍኬቶችን ከመስጠትዎ በፊት ዶሜኖች ወደ ሰርቨርዎ የሚመ 指 ትክክለኛ የDNS records ሊኖራቸው ይገባል።
  • integration ሰርተፍኬቶችን ከመጠየቁ በፊት የDNS records መኖራቸውን ያረጋግጣል።
  • የSSL ሰርተፍኬቶች እየተሰጡ না ከሆነ፣ ዶሜኖቹ ወደ ሰርቨርዎ IP አድራሻ በትክክል እየጠቆሙ መሆናቸውን ያረጋግጡ።
  • የተጠቃሚው ዶሜን በSSL ሳይገኝ ተጣብቋል? የCloudways application's SSL Certificate tabን ይፈትሹ። ዋይልድካርድ ሰርተፍኬት (በእጅ የተጫነ፣ ወይም *.your-network.com የሚሸፍን) ንቁ ከሆነ፣ Cloudways ለግለሰብ የተመዘገቡ ዶሜኖች Let's Encrypt ሰርተፍኬቶችን አይሰጥም። መደበኛ Let's Encrypt ሰርተፍኬት ብቻ ይተኩት ይህም ዋናውን የኔትወርክ ዶሜን (your-network.com, www.your-network.com) ብቻ ይሸፍን፣ እና ከWU_CLOUDWAYS_EXTRA_DOMAINS ማንኛውንም ዋይልድካርድ entry ያስወግዱ። ከዚያ የዶሜን መመሳሰልን እንደገና ይጀምሩ (re-trigger) (ወይም በሚቀጥለው ጊዜ ይጠብቁ) እና integration በየዶሜኑ ላይ ሰርተፍኬቶችን መጠየቅ ይጀምራል።

ዶሜን አልተጨመረም (Domain Not Added)​

  • የUltimate Multisite logs ውስጥ የत्र kesalahan መልዕክቶችን ይፈትሹ።
  • ዶሜኑ ቀድሞ በCloudways ውስጥ አለመጨመሩን ያረጋግጡ።
  • የCloudways planዎ እየጨመሩባቸው ያሉትን የዶሜን ብዛት ይደግጋል (supports) መሆኑን ያረጋግጡ።