[Документация Yandex Cloud](../../index.md) > [Yandex Cloud CDN](../index.md) > [Практические руководства](index.md) > Миграция в Yandex Cloud CDN из стороннего CDN-провайдера # Миграция в Yandex Cloud CDN из стороннего CDN-провайдера Если ваш динамический сайт использует сторонний CDN-ресурс для предоставления пользователям доступа к статическому контенту, вы можете бесшовно перейти на использование Yandex Cloud CDN. В данном руководстве описаны шаги, которые позволят выполнить такой переход, сохранив доступность вашего контента на протяжении всего процесса перехода. ## Схема решения {#solution-overview} ![cdn-migration-tutorial](../../_assets/cdn/cdn-migration-tutorial.svg) Для бесшовного перехода вы создадите в Yandex Cloud CDN новый [CDN-ресурс](../concepts/resource.md), использующий тот же [источник](../concepts/origins.md), который использует сторонний CDN-ресурс. Для нового CDN-ресурса вы создадите новый поддомен, а для домена второго уровня и всех его поддоменов третьего уровня выпустите новый [TLS-сертификат](../../certificate-manager/concepts/managed-certificate.md) в Yandex Certificate Manager. Убедившись в работоспособности нового CDN-ресурса, на вашем динамическом сайте вы перенастроите ссылки на статический контент, перенаправив их на новый CDN-ресурс. Затем вы удалите сторонний CDN-ресурс, добавив использовавшееся им доменное имя как дополнительное в CDN-ресурс Yandex Cloud CDN. В процессе перехода со стороннего CDN-ресурса на CDN-ресурс в Cloud CDN будет обеспечена непрерывная доступность статического контента для вашего динамического сайта. Чтобы перенести CDN-ресурс в Yandex Cloud CDN: 1. [Подготовьте облако к работе](#before-you-begin). 1. [Добавьте TLS-сертификат в Yandex Certificate Manager](#issue-certificate). 1. [Создайте CDN-ресурс в Cloud CDN](#setup-resource). 1. [Создайте CNAME-запись поддомена для нового CDN-ресурса](#setup-subdomain). 1. [Перенастройте ваш сайт на использование нового CDN-ресурса](#update-website). 1. [Добавьте дополнительный домен к CDN-ресурсу в Cloud CDN](#add-secondary-domain). ## Перед началом работы {#before-you-begin} Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../../billing/concepts/billing-account.md): 1. Перейдите в [консоль управления](https://kz.console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь. 1. На странице **[Yandex Cloud Billing](https://kz.console.yandex.cloud/billing)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../../billing/quickstart/index.md) и [привяжите](../../billing/operations/pin-cloud.md) к нему облако. Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://kz.console.yandex.cloud/cloud). [Подробнее об облаках и каталогах](../../resource-manager/concepts/resources-hierarchy.md). ### Доступ к настройкам DNS {#dns-access} Убедитесь, что у вас есть доступ к настройкам [DNS](../../glossary/dns.md) на сайте компании, которая предоставляет вам услуги DNS-хостинга. Обычно это компания-регистратор вашего домена. Предполагается, что в вашем личном кабинете DNS-провайдера создана публичная доменная зона, соответствующая вашему доменному имени (например, `example.com.`), и в этой публичной зоне существует [CNAME-запись](../../dns/concepts/resource-record.md#cname) для вашего текущего CDN-поддомена (например, `cdn.example.com`), указывающая на стороннего CDN-провайдера. ### Необходимые платные ресурсы {#paid-resources} В стоимость поддержки создаваемой CDN-инфраструктуры входит плата за исходящий трафик с CDN-серверов ([тарифы Cloud CDN](../pricing.md)). ## Добавьте TLS-сертификат в Yandex Certificate Manager {#issue-certificate} Чтобы обеспечить шифрование данных при обращении к новому CDN-ресурсу, добавьте в сервис Yandex Certificate Manager новый [TLS-сертификат](../../certificate-manager/concepts/managed-certificate.md) от Let's Encrypt® для домена вашего сайта и всех его поддоменов (wildcard-сертификат): 1. Создайте новый TLS-сертификат: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в который будет добавлен сертификат. 1. Перейдите в сервис **Certificate Manager**. 1. Нажмите кнопку **Добавить сертификат** и выберите **Сертификат от Let's Encrypt**. 1. В открывшемся окне в поле **Имя** введите имя сертификата. Например: `my-cdn-certificate`. 1. В поле **Домены** задайте маску для вашего домена и его поддоменов. Например: `*.example.com`, где `example.com` — доменное имя вашего сайта. 1. В поле **Тип проверки** выберите `DNS`. 1. Нажмите кнопку **Создать**. - CLI {#cli} 1. Запросите новый wildcard-сертификат. Для этого выполните команду: ```bash yc certificate-manager certificate request \ --name my-cdn-certificate \ --domains "*.<доменное_имя_вашего_сайта>" ``` Где: * `--name` — имя сертификата. Например: `my-cdn-certificate`. * `--domains` — маска для вашего домена и его поддоменов. Например: `*.example.com`, где `example.com` — доменное имя вашего сайта. Результат: ```text id: fpqba7lpgmp7******** folder_id: b1gt6g8ht345******** created_at: "2025-02-09T20:41:05.916923798Z" name: my-cdn-certificate type: MANAGED domains: - '*.example.com' status: VALIDATING updated_at: "2025-02-09T20:41:05.916923798Z" ``` Сохраните идентификатор запрошенного сертификата (значение поля `id`) — он понадобится на последующих шагах. Подробнее о команде `yc certificate-manager certificate request` читайте в [справочнике CLI](../../cli/cli-ref/certificate-manager/cli-ref/certificate/request.md). {% endlist %} 1. Пройдите процедуру подтверждения прав на домен: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в который был добавлен [сертификат](../../certificate-manager/concepts/managed-certificate.md). 1. Перейдите в сервис **Certificate Manager**. 1. В списке сертификатов выберите сертификат, для которого необходимо пройти процедуру проверки. 1. В открывшемся окне в блоке **Проверка прав на домены** будет указана информация для прохождения процедуры проверки прав. На вкладке **CNAME-запись** скопируйте и сохраните значения полей **Имя** и **Значение**. Они понадобятся для создания CNAME-записи. - CLI {#cli} 1. Получите значения CNAME-записи, необходимые для прохождения процедуры проверки прав на домен. Для этого выполните команду, указав сохраненный ранее идентификатор сертификата: ```bash yc certificate-manager certificate get <идентификатор_сертификата> \ --full \ --format=json | \ jq -r ".challenges[].dns_challenge" ``` Результат: ```json { "name": "_acme-challenge.example.com.", "type": "CNAME", "value": "fpqba7lpgmp7********.cm.yandexcloud.net." } { "name": "_acme-challenge.example.com.", "type": "TXT", "value": "oRnpmIJau5SWFDYqKwwUJMn-61HHdulvqk7********" } ``` Сохраните значения полей `name` и `value` для типа записи `CNAME`. Они понадобятся для создания CNAME-записи. Подробнее о команде `yc certificate-manager certificate get` читайте в [справочнике CLI](../../cli/cli-ref/certificate-manager/cli-ref/certificate/get.md). {% endlist %} 1. Используя сохраненные на предыдущем шаге значения, создайте в публичной доменной зоне доменного имени вашего сайта CNAME-запись для подтверждения ваших прав на домен: Если домен вашего сайта делегирован Yandex Cloud DNS, для создания CNAME-записи воспользуйтесь [инструкцией](../../dns/operations/resource-record-create.md). В остальных случаях воспользуйтесь документацией вашего DNS-провайдера или обратитесь в его службу технической поддержки. {% note info %} Чтобы DNS-проверка прав на домен по записи `CNAME` прошла успешно, для поддомена `_acme-challenge` проверяемого доменного имени не должно быть других [ресурсных записей](../../dns/concepts/resource-record.md), кроме `CNAME`. Например, для имени `_acme-challenge.example.com.` должна существовать только CNAME-запись и не должно быть TXT-записи. {% endnote %} Дождитесь успешного прохождения проверки прав на домен, в результате которого созданный wildcard-сертификат будет выпущен и перейдет в статус `Issued`. Проверить статус сертификата можно на странице сертификата в [консоли управления](https://kz.console.yandex.cloud) либо с помощью команды CLI `yc certificate-manager certificate get <идентификатор_сертификата>`. ## Создайте CDN-ресурс в Cloud CDN {#setup-resource} В данном разделе приведена инструкция по созданию CDN-ресурса с типом источника `Сервер`. Если в качестве источника вы используете [бакет](../../storage/concepts/bucket.md) Yandex Object Storage или [балансировщик](../../application-load-balancer/concepts/application-load-balancer.md) Yandex Application Load Balancer, при создании CDN-ресурса воспользуйтесь инструкцией [Создание ресурса](../operations/resources/create-resource.md). Создайте новый CDN-ресурс в Yandex Cloud CDN: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором вы будете создавать CDN-ресурс. 1. Перейдите в сервис **Cloud CDN**. 1. Нажмите **Создать ресурс**. 1. Задайте основные настройки CDN-ресурса: * В блоке **Контент**: * Включите **Доступ к контенту**. * В поле **Запрос контента** выберите `Из одного источника`. * В поле **Тип источника** выберите `Сервер`. * В поле **Доменное имя источника** укажите доменное имя или публичный IP-адрес вашего источника статического контента. * В поле **Протокол для источников** выберите протокол, по которому CDN-ресурс будет взаимодействовать с источником. Если вы выбираете варианты `HTTPS` или `Как у клиента`, убедитесь, что ваш источник поддерживает HTTPS. * В поле **Доменное имя** укажите новое доменное имя, которое вы присвоили вашему новому CDN-ресурсу. Например: `cdn-new.example.com`. * В блоке **Дополнительно**: * В поле **Переадресация клиентов** выберите `Не использовать`. * В поле **Тип сертификата** выберите `Сертификат из Certificate Manager` и в появившемся списке выберите созданный ранее сертификат, например: `my-cdn-certificate`. * В поле **Заголовок Host** выберите `Основное доменное имя`. 1. Нажмите **Продолжить**. 1. В разделах **Кеширование**, **HTTP-заголовки и методы** и **Дополнительно** оставьте настройки по умолчанию и нажмите **Продолжить**. - Yandex Cloud CLI {#cli} 1. Выполните команду: ```bash yc cdn resource create <имя_поддомена> \ --origin-custom-source '' \ --origin-protocol '<протокол_для_источника>' \ --cert-manager-ssl-cert-id <идентификатор_сертификата> ``` Где: * `<имя_поддомена>` — доменное имя, для которого ранее была создана CNAME-запись и которое будет использоваться новым CDN-ресурсом. Например: `cdn-new.example.com`. * `--origin-custom-source` — доменное имя или публичный IP-адрес вашего источника статического контента. * `--origin-protocol` — протокол, который будет использоваться для взаимодействия CDN-ресурса с источником. Возможные значения: * `http` — использовать протокол HTTP. * `https` — использовать протокол HTTPS. * `match` — использовать такое же значение, как и у заголовка `Host` в запросе клиента к CDN. Выбирая вариант `https` или `match`, убедитесь, что ваш источник поддерживает HTTPS. * `--cert-manager-ssl-cert-id` — идентификатор TLS-сертификата, сохраненный ранее при его создании. {% cut "Результат" %} ```text id: bc8cfqtx2mkx******** folder_id: b1gt6g8ht345******** cname: cdn-new.example.com created_at: "2025-02-10T07:42:24.920162Z" updated_at: "2025-02-10T07:42:24.920187Z" active: true options: edge_cache_settings: enabled: true default_value: "345600" query_params_options: ignore_query_string: enabled: true value: true stale: enabled: true value: - error - updating origin_group_id: "352269" origin_group_name: Origins for cdn-new.example.com (302798) origin_protocol: HTTP ssl_certificate: type: CM status: READY data: cm: id: fpqnetjumkhn******** ``` {% endcut %} Сохраните идентификатор созданного CDN-ресурса (значение поля `id`) — он понадобится позднее. Подробнее о команде `yc cdn resource create` читайте в [справочнике CLI](../../cli/cli-ref/cdn/cli-ref/resource/create.md). {% endlist %} {% note warning %} После создания CDN-ресурса может пройти до 15 минут, прежде чем ресурс фактически заработает. Прежде чем приступать к следующим шагам, убедитесь, что вновь созданный CDN-ресурс полностью работоспособен. {% endnote %} ## Создайте CNAME-запись поддомена для нового CDN-ресурса {#setup-subdomain} Для бесшовного переключения вашего сайта на новый CDN-ресурс вам понадобится новый CDN-поддомен. В публичной доменной зоне, к которой относится доменное имя вашего сайта, создайте CNAME-запись для нового CDN-поддомена, который будет использоваться новым CDN-ресурсом: * Имя записи: имя нового CDN-поддомена. Например: `cdn-new.example.com.`. * Тип записи: `CNAME`. * Значение записи: значение `cname` для нового CDN-ресурса. Вы можете получить его в [консоли управления](https://kz.console.yandex.cloud) на странице CDN-ресурса, например `e1b83ae3********.topology.gslb.yccdn.kz`. Если домен вашего сайта [делегирован Yandex Cloud DNS](../../dns/concepts/dns-zone.md#public-zones), для создания CNAME-записи воспользуйтесь [инструкцией](../../dns/operations/resource-record-create.md). В остальных случаях воспользуйтесь документацией вашего DNS-провайдера или обратитесь в его службу технической поддержки. ## Перенастройте ваш сайт на использование нового CDN-ресурса {#update-website} После того как вы создали в Cloud CDN новый CDN-ресурс и убедились в его работоспособности, вы можете переходить к перенастройке вашего сайта и удалению старого CDN-ресурса. ### Перенаправьте ссылки с динамического сайта {#redirect-links} Перенаправьте на новый CDN-поддомен ссылки на статический контент, которые генерирует ваш динамический сайт. Например, заменив в генерируемых ссылках имя домена с `cdn.example.com` на `cdn-new.example.com`. Это действие должен выполнить администратор вашего динамического сайта. Произведя все необходимые изменения, убедитесь, что ссылки на статический контент, генерируемые вашим сайтом, работают, а контент — доступен. Также убедитесь, что на старом CDN-ресурсе прекратился исходящий трафик: для этого воспользуйтесь инструментами статистики и мониторинга стороннего CDN-провайдера. На этом этапе ваш динамический сайт полностью перешел на использование Yandex Cloud CDN. ### Измените CNAME-запись исходного CDN-поддомена {#update-cname} Чтобы исходный CDN-поддомен вашего сайта продолжил работать на новом CDN-ресурсе Cloud CDN, замените значение ресурсной CNAME-записи исходного поддомена на значение, полученное ранее: * Имя записи: имя исходного CDN-поддомена. Например: `cdn.example.com.`. * Тип записи: `CNAME`. * Значение записи: значение `cname` для нового CDN-ресурса. Вы можете получить его в [консоли управления](https://kz.console.yandex.cloud) на странице CDN-ресурса, например `e1b83ae3********.topology.gslb.yccdn.kz`. Если домен вашего сайта делегирован Yandex Cloud DNS, для изменения CNAME-записи воспользуйтесь [инструкцией](../../dns/operations/resource-record-update.md). В остальных случаях воспользуйтесь документацией вашего DNS-провайдера или обратитесь в его службу технической поддержки. ### Удалите сторонний CDN-ресурс {#delete-resource} Убедившись, что исходный CDN-ресурс у стороннего CDN-провайдера перестал генерировать исходящий трафик, удалите этот CDN-ресурс. Для этого воспользуйтесь документацией стороннего CDN-провайдера или обратитесь в его службу технической поддержки. ## Добавьте дополнительный домен к CDN-ресурсу в Cloud CDN {#add-secondary-domain} После удаления стороннего CDN-ресурса, использовавшего исходный CDN-поддомен, вы можете добавить этот освободившийся поддомен к вашему новому CDN-ресурсу в Cloud CDN в качестве дополнительного домена. Для этого: {% list tabs group=instructions %} - Консоль управления {#console} 1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, в котором расположен ваш CDN-ресурс. 1. Перейдите в сервис **Cloud CDN**. 1. В строке с созданным ранее CDN-ресурсом нажмите значок ![ellipsis](../../_assets/console-icons/ellipsis.svg) и выберите ![pencil](../../_assets/console-icons/pencil.svg) **Редактировать**. 1. В блоке **Доменные имена для раздачи контента** нажмите кнопку ![plus](../../_assets/console-icons/plus.svg) **Добавить доменное имя** и в появившемся поле введите доменное имя, оставшееся от прежнего CDN-ресурса. Например: `cdn.example.com`. 1. Нажмите кнопку **Сохранить**. - Yandex Cloud CLI {#cli} 1. Выполните команду: ```bash yc cdn resource update <идентификатор_CDN-ресурса> \ --secondary-hostnames '<прежний_CDN-поддомен>' ``` Где: * `<идентификатор_CDN-ресурса>` — сохраненный [ранее](#setup-resource) идентификатор CDN-ресурса Cloud CDN. * `--secondary-hostnames` — освободившееся после удаления стороннего CDN-ресурса доменное имя. Например: `cdn.example.com`. {% note warning %} Команда удалит все дополнительные домены, которые до этого были привязаны к CDN-ресурсу. Чтобы привязать дополнительный домен к CDN-ресурсу, уже имеющему привязанные дополнительные домены, укажите в параметре `--secondary-hostnames` через запятую все дополнительные домены, которые должны быть привязаны к ресурсу. {% endnote %} {% cut "Результат" %} ```text id: bc845trezddi******** folder_id: b1gt6g8ht345******** cname: cdn-new.example.com created_at: "2025-01-25T21:47:21.181871Z" updated_at: "2025-02-10T17:10:37.511453Z" active: true options: edge_cache_settings: enabled: true default_value: "345600" query_params_options: ignore_query_string: enabled: true value: true stale: enabled: true value: - error - updating ignore_cookie: enabled: true secondary_hostnames: - cdn.example.com origin_group_id: "350569" origin_group_name: Origins for cdn-new.example.com (301532) origin_protocol: HTTP ssl_certificate: type: CM status: READY ``` {% endcut %} Подробнее о команде `yc cdn resource update` читайте в [справочнике CLI](../../cli/cli-ref/cdn/cli-ref/resource/update.md). {% endlist %} Обновление настроек CDN-ресурса может занять до 15 минут, после чего ваш новый CDN-ресурс станет доступен по обоим доменным именам: `cdn-new.example.com` и `cdn.example.com`. #### Полезные ссылки {#see-also} * [Создание CDN-ресурса](../operations/resources/create-resource.md) * [Добавление сертификата от Let's Encrypt®](../../certificate-manager/operations/managed/cert-create.md) * [Начало работы с Cloud DNS](../../dns/quickstart.md)