Skip to main content

Інтеграцыя з Cloudways

Агляд​

Cloudways — гэта платформа кіраванага хэастынгу ў «блакавым» (cloud) стылі, якая дазваляе вам размяшчаць сайты WordPress на розных пастаўшчыках хэастынгу, такіх як DigitalOcean, AWS, Google Cloud і інш. Гэтая інтэграцыя дазваляе аўтаматычна синхронізаваць домены і кіраваць сертыфікамі SSL паміж Ultimate Multisite і Cloudways.

Функцыі​

  • Аўтаматычная синхронізацыя доменаў
  • Кіраванне сертыфікамі SSL
  • Падтрымка дадатковых доменаў
  • Валідацыя DNS для сертыфікатаў SSL

Патрабаванні​

У наступных канстантах павінны быць вызначаны ў файле 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');

Інструкцыі па наладзе​

1. Атримаць API-даныя Cloudways​

  1. Увайдзіце ў ваш дашборд Cloudways
  2. Агрэце ў «Account» > «API Keys»
  3. Згенеруйце API-ключ, калі яго яшчэ няма
  4. Скопіруйце свой электронны адрас і API-ключ

2. Атримаць ID сервера і паслугі​

  1. У дашбордзе Cloudways зайдзіце ў «Servers»
  2. Выберыце сервер, дзе размяшчаецца ваш WordPress multisite
  3. Server ID бачны ў URL: https://platform.cloudways.com/server/{SERVER_ID}
  4. Зайдзіце ў «Applications» і выберыце вашу праграму WordPress
  5. App ID бачны ў URL: https://platform.cloudways.com/server/{SERVER_ID}/application/{APP_ID}

3. Дадаць канстанты ў wp-config.php​

Дадайце наступныя канстанты ў ваш файл 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');

Калі ў вас ёсць дадатковыя zewnшнія домены (за служэннем вашай multisite), якія заўсёды павінны заставацьмецца ў спісе псеўданняў Cloudways:

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'extradomain1.com,extradomain2.com');
Не ўключайце вашыя ўласныя сеткавыя вайлды

Не дадавайце *.your-network.com (або любы патерн паддоменаў вашай сеткі) у WU_CLOUDWAYS_EXTRA_DOMAINS. Паглядзіце ў Важна — пастка ў SSL для вайлдаў ніж, каб пазнаёміцца, чаму гэта за방раняе выкаданне сертыфікатаў SSL для кожнага паслубіна.

4. Актывацыя інтэграцыі​

  1. У адмініструванні WordPress зайдзіце ў Ultimate Multisite > Settings
  2. Патрапіце ў тэчку «Domain Mapping»
  3. Праскользьце да «Host Integrations»
  4. Актывуйце інтэграцыю Cloudways
  5. Націсніце «Save Changes»

Як гэта працуе​

Синхронізацыя доменаў​

Калі домен пазначаны ў Ultimate Multisite:

  1. Інтэграцыя атрымлівае ўсе ўжо пазначаныя домены
  2. Яна дадае новы домен да спісу (а разам з версіяй www, калі гэта адпавядае)
  3. Яна адпраўляе поўны спіс у Cloudways праз API
  4. Cloudways абнаўляе псеўдання доменаў для вашай праграмы

Заўвага: API Cloudways патрабуе адпраўляць поўны спіс доменаў кожны раз, а не проста дадаваць або выдаляць адрозныя домены.

Кіраванне сертыфікамі SSL​

Пасля синхронізацыі доменаў:

  1. Інтэграцыя праверыць, якія домены маюць валідавыя DNS-запісы, якія вяківаюць да вашага сервера
  2. Яна адпраўляе патрабую ў Cloudways для ўстаноўкі сертыфікатаў SSL Let's Encrypt для гэтых доменаў
  3. Cloudways займаецца выкаданнем і ўстаноўкай сертыфікатаў SSL

Інтэграцыя заўсёды патрабуе стандартныя (не-вайлдкард) сертыфікаты Let's Encrypt ад Cloudways. Калі ў WU_CLOUDWAYS_EXTRA_DOMAINS пастаўлены вайлдард-патерн, пачаткова *. выдаляецца перад патрабаваннем SSL — сам вайлдард ніколі не ўстаноўваецца гэтай інтэграцыяй. Каб выкарыстоўваць вайлдард-сертыфікат на Cloudways, вам трэба будзе ўсталяваць яго на маноўны лад, але гэта блокуе выкаданне Let's Encrypt для доменаў, пазначаных паслубінамі (глядзіце пастка ніжэй).

Дадатковыя домены​

Канстанта WU_CLOUDWAYS_EXTRA_DOMAINS дазваляе вам паказаць дадатковыя zewnшнія домены, якія заўсёды павінны заставацьмецца ў спісе псеўданняў праграмы Cloudways. Выкарыстоўвайце яго для:

  • Знешніх доменаў, якія не кіруюцца Ultimate Multisite (напрыклад, асобны маркетынгавы сайт, які выкарыстоўвае ту ж праграму Cloudways)
  • Пакінутых або тэставых доменаў, якія вы хочаце заставаць у спісе псеўданняў праграмы

Не выкарыстоўвайце гэтую канстанту для вайлдард-патерна паддоменаў вашай ўласнай сеткі (напрыклад, *.your-network.com). Паглядзіце пастка ў SSL для вайлдаў ніжэй.

Важна — Пастка SSL для вайлдаў​

Частае памылка, калі вы выконваеце стандартную наладку Cloudways, — гэта дадаванне вайлдарда, такіх як *.your-network.com, да WU_CLOUDWAYS_EXTRA_DOMAINS або маноўны ўстаноўка вайлдард-сертыфікату Cloudways для гэтага вайлдарда.

Калі вы гэта зрабіце, Cloudways адмовіцца выкадаць сертыфікаты Let's Encrypt для паслубінавых пазначаных доменаў, якія пазначае Ultimate Multisite. Cloudways замяняе актыўны сертыфікат SSL на праграме кожны раз, а ўжо існуючы вайлдард-сертыфікат на праграме блокуе выкаданне Let's Encrypt для доменаў паслубінаў, на якое пасіліцераваў інтэграцыя.

Рэкамендаваная наладка SSL Cloudways для сеткі Ultimate Multisite​

  1. У тэчцы SSL Certificate праграмы Cloudways ўсталюйце стандартны сертыфікат Let's Encrypt, які пакрывае толькі your-network.com і www.your-network.com — не вайлдард.
  2. Не кладзіце *.your-network.com (або любы патерн паддоменаў вашай сеткі) у WU_CLOUDWAYS_EXTRA_DOMAINS. Зарэзервуйце гэтую канстанту толькі для zewnшніх доменаў.
  3. Стварыце вайлдард-паддомен паслубінаў на ўзроўні DNS толькі (запіс A для *.your-network.com, які паказвае на IP-адрэс вашага сервера Cloudways), каб падсайты працавалі. SSL для адрозных пазначаных доменаў пасля гэтага выкадаецца аўтаматычна інтэграцыяй пазбеговайце Let's Encrypt.

Калі паслубінавыя домены валякія без SSL, праверце тэчку SSL Certificate Cloudways. Калі там актыўны вайлдард-сертыфікат, выдаліце яго, перавыканайце стандартны сертыфікат Let's Encrypt толькі для асноўнага домена сеткі (your-network.com, www.your-network.com) і выдаліце любыя вайлдард-запісы з WU_CLOUDWAYS_EXTRA_DOMAINS. Пасля гэтага перавыканайце пазначаванне домена (або пачакайце наступнага) і інтэграцыя зноў пачнецца выкадаваць сертыфікаты для кожнага домена.

Выяўленне праблем​

Праблемы з падключэннем API​

  • Праверце, што ваш электронны адрас і API-ключ правільныя
  • Праверце, што вашы ID сервера і праграмы правільныя
  • Убедзіцеся, што ваш акаўнт Cloudways мае неабходныя паrawnікі

Праблемы з сертыфікатам SSL​

  • Cloudways патрабуе, каб домены мелі валідавыя DNS-запісы, якія вяківаюць да вашага сервера, перш чым выкадаваць сертыфікаты SSL
  • Інтэграцыя валідуе DNS-запісы, перш чым патрабаваць сертыфікаты SSL
  • Калі сертыфікаты SSL не выкадаваюцца, праверце, што вашы домены правільна паказваюць на IP-адрэс вашага сервера
  • Паслубінавыя пазначаныя домены валякія без SSL? Праверце тэчку SSL Certificate праграмы Cloudways. Калі актыўны вайлдард-сертыфікат (ўручную ўсталяваны або, які пакрывае *.your-network.com), Cloudways не выкадае сертыфікаты Let's Encrypt для адрозных пазначаных паслубінаў. Замяніце яго стандартным сертыфікатам Let's Encrypt, які пакрывае толькі асноўны домен сеткі (your-network.com, www.your-network.com), і выдаліце любыя вайлдард-запісы з WU_CLOUDWAYS_EXTRA_DOMAINS. Пасля гэтага перавыканайце пазначаванне домена (або пачакайце наступнага) і інтэграцыя пачнецца патрабаваць сертыфікаты для кожнага домена.

Домен не дададзены​

  • Праверце журналы Ultimate Multisite на наяўнасць памылак
  • Убедзіцеся, што домен яшчэ не дададзены ў Cloudways
  • Убедзіцеся, што ваш план Cloudways падтрымлівае колькасць доменаў, якія вы дадаеце