Skip to main content

Интеграција со Cloudways

Преглед​

Cloudways е управување облачно хостинг платформа која ви овозможува да го разместите WordPress сайтовите на различни облачни провајдери како DigitalOcean, AWS, Google Cloud и повеќе. Ова интегрира автоматско синхронизирање на домените и управување со SSL сертификатите помеѓу Ultimate Multisite и Cloudways.

Функции​

  • Автоматско синхронизирање на домените
  • Управување со SSL сертификати
  • Поддршка за дополнителни домени
  • Валидација на DNS за SSL сертификати

Задолжителни променливи​

Следни константи мора да бидат дефинирани во вашата wp-config.php да функционира:

define('WU_CLOUDWAYS_EMAIL', 'ваша_cloudways_email');
define('WU_CLOUDWAYS_API_KEY', 'ваша_api_key');
define('WU_CLOUDWAYS_SERVER_ID', 'ваши_server_id');
define('WU_CLOUDWAYS_APP_ID', 'ваши_app_id');

Опционално, можете да дефинирате и:

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'домен1,домен2,список,одделен_по_заколку');

Инструкции за поставување​

1. Доставете свои Cloudways API Ключи (Credentials)​

  1. Најавете се во вашата Cloudways дашборд
  2. Одете на "Account" > "API Keys"
  3. Генерате API ключ ако не го имате веќе
  4. Копирај го вашиот е-маил и API ключот

2. Доставете свои Server и Application 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', 'вашиот_адрес@cloudways.com');
define('WU_CLOUDWAYS_API_KEY', 'ваша_api_ключ');
define('WU_CLOUDWAYS_SERVER_ID', 'ваш_server_id');
define('WU_CLOUDWAYS_APP_ID', 'ваш_app_id');

Ако имате дополнителни външни домени (над вашата мрежа на multisite) кои сепак треба да останат вечно во списокот алиаси на Cloudways:

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'extradomain1.com,extradomain2.com');
Не вклучувајте ја вашата сопствена мрежа со wildcard

Не додавувајте *.your-network.com (или некоја поддомен паттерн на вашата мрежа) во WU_CLOUDWAYS_EXTRA_DOMAINS. Вигледајте Важно — падната со wildcard SSL сертификати подолу за тоа зошто ова спречува издавање SSL сертификати за секој Tenant.

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 ги ажури алиасите на домените за вашата апликација

Забелешка: Cloudways API бара да се испрати целиот список на домени секој пат, а не само да се додаде или отстрани индивидуални домени.

Управување со SSL Сертификати​

По синхронизирањето на домените:

  1. Интеграцијата проверува кои домени има валидни DNS записи што укажуваат на вашиот сервер
  2. Испраќа барање на Cloudways да инстали Let's Encrypt SSL сертификати за овие домени
  3. Cloudways го управува издавањето и инсталацијата на SSL сертификатите

Интеграцијата секогаш бара стандардни (не-wildcard) сертификати Let's Encrypt од Cloudways. Ако во WU_CLOUDWAYS_EXTRA_DOMAINS биден шаблон (wildcard pattern) е поставен, пред SSL барање ќе се отсече уводноот *.. Со самото wildcard не се инсталира од оваа интеграција. За да користите wildcard сертификат на Cloudways, ќе морате да го инсталирате ручно, но тоа блокира издавање Let's Encrypt сертификати за доменски имена со мапирани кастом domeni (прегледајте паметта подолу).

Дополнителни домени (Extra Domains)​

Константата WU_CLOUDWAYS_EXTRA_DOMAINS ви овозможува да наведете дополнителни естрани домени кои треба секогаш да бидат во списокот алиаси на апликацијата Cloudways. Користи ја за:

  • Естрани домени кои не се управуваат од Ultimate Multisite (на пр. посебна маркетиншка локација која споделува иста Cloudways апликација).
  • Домени со паркирање или стаџинги кои сакате да бидат во списокот алиаси на апликацијата.

Не користете ја оваа константа за вашиот свој поддомен wildcard (на пр. *.your-network.com). Прегледајте паметта за wildcards SSL подолу.

Важно — Паметта за Wildcard SSL​

Честа грешка при следење на стандардниот поставка на Cloudways е да додадете нешто како *.your-network.com во WU_CLOUDWAYS_EXTRA_DOMAINS, или да инсталирате ручно wildcard SSL сертификат за тој wildcard од Cloudways.

Ако направите ова, Cloudways ќе одбиде издавање Let's Encrypt сертификати за кастом домените на секој локус што ги мапира Ultimate Multisite. Cloudways го заменува активниот SSL сертификат на апликацијата секој пат, а претсуществен wildcard сертификат на апликацијата блокира издавање Let's Encrypt сертификати за доменски имена кои ги бара интеграциите.

Препорачано поставување на Cloudways SSL за мрежа Ultimate Multisite​

  1. Во таб SSL Certificate во апликацијата на Cloudways, инсталирајте стандарден Let's Encrypt сертификат кој покрива само your-network.com и www.your-network.com — не варлибел (wildcard).
  2. Не ставајте *.your-network.com (или некоја паттерн на поддомен на вашата мрежа) во WU_CLOUDWAYS_EXTRA_DOMAINS. Зачувајте таа констаната само за екстерни домени.
  3. Создадете сертификат со варлибел за поддомени на ниво на DNS (рекорд A за *.your-network.com што насочува кон IP адресата на вашиот Cloudways сервер) така што поддомените ќе се резолуваат. SSL за индивидуални мапирани кастом домени ќе биде издаден автоматски од интеграцијата преку Let's Encrypt.

Ако вашите кастом домени на лоними останат без SSL, проверете табот Cloudways SSL. Ако там е активен сертификат со варлибел, го отстранете, повторно издадете стандарден Let's Encrypt сертификат само за главниот домен на мрежата и отстранете ги сите вчитувања со варлибел од WU_CLOUDWAYS_EXTRA_DOMAINS. Потоа повторно активирајте мапирање на domeni (или чекајте за следното) и интеграцијата ќе почне да издава сертификати за секој домен повторно.

Решавање проблеми (Troubleshooting)​

Проблеми со врска преку API​

  • Проверете дали вашата е-пошта и API клучето се правилни
  • Проверете дали вашите ID на сервер и апликацијата се правилни
  • Сигурно секогаш проверете дали вашата Cloudways сметка има потребните дозволи

Проблеми со 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 за некои пораки за грешки.
  • Проверете дали доменet веќе не е додаден во Cloudways.
  • Осигурајте се дека вашиот план во Cloudways поддржува бројот домени што го додавате.