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. Получите учетные данные API Cloudways​

  1. Войдите в панель управления Cloudways.
  2. Перейдите в "Account" (Учетная запись) > "API Keys" (API-ключи).
  3. Сгенерируйте API-ключ, если у вас его еще нет.
  4. Скопируйте свой email и API-ключ.

2. Получите ID вашего сервера и приложения​

  1. В панели управления Cloudways перейдите в "Servers" (Серверы).
  2. Выберите сервер, на котором размещен ваш мультисайт WordPress.
  3. Server ID (ID сервера) виден в URL: https://platform.cloudways.com/server/{SERVER_ID}
  4. Перейдите в "Applications" (Приложения) и выберите ваше приложение WordPress.
  5. App ID (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');

Егер у вас є додаткові зовнішні домени (за межами вашої мультисайтової мережі), які завжди повинні залишатися у списку псевдонімів Cloudways:

define('WU_CLOUDWAYS_EXTRA_DOMAINS', 'extradomain1.com,extradomain2.com');
Свій власний wildcard не включайте

Не додавайте *.your-network.com (або будь-яку піддоменну схему вашої власної мережі) до WU_CLOUDWAYS_EXTRA_DOMAINS. Дивіться Важливо — пастка з SSL wildcard нижче, щоб зрозуміти, чому це заважає видачі 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-сертифікатів.

Интеграция әрқашан Cloudways-тан стандартты (wildcard емес) Let's Encrypt сертификаттарын сұрайды. Егер WU_CLOUDWAYS_EXTRA_DOMAINS içinde wildcard үлгісі берілсе, SSL сұранысынан бұрын алдыңғы *. жойылады — осы интеграция арқылы wildcard сертификаты ешқашан орнатылмайды. Cloudways-те wildcard сертификатын пайдалану үшін оны қолмен орнату қажет болады, бірақ бұл әрекет карталанған қолданылатын домендерге Let's Encrypt сертификаттарының беруін тоқтатады (аşağıdaki қатерді қараңыз).

Қосымша Домендер (Extra Domains)​

WU_CLOUDWAYS_EXTRA_DOMAINS константасы Cloudways қосымшасының алиас тізімінде әрқашан сақталуы тиіс қосымша сыртқы домендерді көрсетуге мүмкіндік береді. Оны келесілер үшін қолданыңыз:

  • Ultimate Multisite арқылы басқарылатын емес сыртқы домендер (мысалы, бір Cloudways қосымшасын бөлісетін басқа маркетинг сайты).
  • Қолданбаның алиас тізімінде сақталуы тиіс парктендірілген немесе стадиялық домендер.

Өз жеке желіңіздің subdomain wildcard үшін (мысалы, *.your-network.com) бұл константаны қолданбаңыз. Wildcard SSL қатерді төменде қараңыз.

Маңызды — Wildcard SSL Қатері​

Cloudways-тің стандартты орнатылуын бақылау кезінде жиі кездесетін қате – WU_CLOUDWAYS_EXTRA_DOMAINS -қа мысалы *.your-network.com сияқты wildcard қосу немесе сол wildcard үшін Cloudways-тың қолмен орнатылған сертификатын орнату.

Егер сіз бұдан басқан істесеңіз, Ultimate Multisite карталаған әр доменге Let's Encrypt сертификаттарын беруден бас тартады. Cloudways қосымшадағы белсенді SSL сертификатын әр рет ауыстырады, ал қолданбада бар wildcard сертификаты интеграцияның тәуекелдеріне негізделген доменге Let's Encrypt сертификаттарын беруін тоқтатады.

Ultimate Multisite желісі үшін Cloudways-тың ұсынылған SSL орнатуы​

  1. Cloudways қосымшасындағы SSL Sertifikаты таңдауынан тек your-network.com және www.your-network.com үшін стандартты Let's Encrypt сертификатын орнатыңыз — жанындағы wildcard (жарықша) емес.
  2. WU_CLOUDWAYS_EXTRA_DOMAINS мәніне *.your-network.com (немесе сіздің жеке желіңіздің кез келген поддомен үлгісі) енгізбеңіз. Осы тұрақты мәнді тек сыртқы домендер үшін сақтап қойыңыз.
  3. Поддомендерді шешу үшін тек DNS деңгейінде (Cloudways серверінің IP-сіне бағытталған *.your-network.com үшін A реккорды) жеке арендағы поддомен wildcard сертификатын жасаңыз. Әрбір карталанған жеке домендерге арналған SSL интеграция арқылы Let's Encrypt арқылы автоматты түрде шығарылады.

Егер сіздің желіңіздегі клиенттердің жеке домендері SSL-сіз қалмаса, Cloudways SSL таңдауына қараңыз. Егер ортада wildcard сертификаты белсенді болса, оны өшіріп, негізгі желі домены үшін стандартты Let's Encrypt сертификатын қайта шығарыңыз және WU_CLOUDWAYS_EXTRA_DOMAINS мәнінен кез келген wildcard енгіштерін алыңыз. Содан кейін домен карталауды қайта іске қосыңыз (немесе келесін күтіңіз) және интеграция деректер бойынша сертификаттарды қайта шығаруды бастайды.

Қателерді шешу​

API الاتصال мәселелері​

  • Электрондық поштаңыз бен API кілттері дұрыс екенін тексеріңіз.
  • Сервер және қосымша ID-лері дұрыс екенін тексеріңіз.
  • Cloudways аккаунтыңызда қажетті рұқсаттар бар екенін қамтамасыз етіңіз.

SSL Sertifikat Проблемдері​

  • Cloudways sertifikat беру алдында домендердің серверге бағытталған жарамды DNS kayıtтары болуын талап етеді.
  • Интеграция сертификаттарды сұраудан бұрын DNS kayıtтарын тексеріп қарайды.
  • Егер SSL сертификаттары берілмелі болса, домендердің сервердің IP-адресіне дұрыс бағытталғанын тексеріңіз.
  • SSL-сыз қалған пер-tenant (бірге қолданылатын) кастом домендер? Cloudways қосымшасындағы SSL Certificate таб-ына қараңыз. Егер жарамды сертификат (мануал орнатылған немесе *.your-network.com қамтитын) белсенді болса, Cloudways жеке мапталған кастом домендер үшін Let's Encrypt сертификаттарын бермейді. Оны тек негізгі желі домены (your-network.com, www.your-network.com) қамтитын стандартты Let's Encrypt сертификатымен ауыстырыңыз және WU_CLOUDWAYS_EXTRA_DOMAINS конфігурациясынан барлық жарамды емес (wildcard) енгіштерін алыңыз. Содан кейін домен маппасын қайта іске қосыңыз (немесе келесін күтіңіз), және интеграция доменге арналған сертификаттарды сұрайды.

Домен Қосылмаған​

  • Ultimate Multisite логида кез келген қате хабарламаларды тексеріңіз.
  • Домен Cloudways-қа әлі қосылмағанын растаңыз.
  • Cloudways жоспарыңыз қосатын домендер санына сәйкес келетініне көз жеткізіңіз.