From 827bd099c276f59b1eb91d24f8bd36d96a720908 Mon Sep 17 00:00:00 2001 From: parinovK <62334658+parinovK@users.noreply.github.com> Date: Fri, 28 Jun 2024 12:20:27 +0300 Subject: [PATCH 01/24] =?UTF-8?q?=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA?= =?UTF-8?q?=D1=86=D0=B8=D1=8F=20=D0=BF=D0=BE=20=D0=BF=D1=80=D0=BE=D0=BA?= =?UTF-8?q?=D1=81=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8E=20=D1=81?= =?UTF-8?q?=20=D0=AF=D0=BD=D0=B4=D0=B5=D0=BA=D1=81=20=D0=9E=D0=B1=D0=BB?= =?UTF-8?q?=D0=B0=D0=BA=D0=BE=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 160 +++++++++++++++++++++++++++++++++ ru/toc.yaml | 2 + 2 files changed, 162 insertions(+) create mode 100644 ru/personal-domain-ya-cloud.md diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md new file mode 100644 index 0000000..9e4143c --- /dev/null +++ b/ru/personal-domain-ya-cloud.md @@ -0,0 +1,160 @@ +# Личный домен в Яндекс Облаке и его проксирование + +Быстрый старт («Quick Start») - сервис, который поможет создать репозиторий и привязать его к внешнему сервису Diplodoc, после чего станет доступна базовая документация, предзаполненная командой Diplodoc. + +1. Переходим в [быстрый старт](https://diplodoc.com/quickstart/). +1. Авторизуемся в Github. + + {% note warning %} + + Если сервис выдаст ошибку «Could not get github state back» - вернитесь на страницу [быстрого старта](https://diplodoc.com/quickstart/). + + {% endnote %} + +1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example». +1. В шаге №3 нажмите **Создать** и создайте проект в Diplodoc. +1. Готово. В результате успешного выполнения пошаговой инструкции вы получите сообщение: + + ``` + Ключи от каталога с документацией в S3. + Идентификатор ключа: + Здесь-будет-указан-идентификатор-ключа + Секретный ключ: + Здесь-будет-указан-секретный-ключ + + Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. + ``` + + {% note info %} + + Дождитесь этапа завершения релиза, проект будет доступен по ссылке. + + {% endnote %} + +Для привязки домена к Яндекс Облаку: + +1. Зарегистрируйте домен (в этом нам поможет любой [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). +1. Авторизуйтесь или зарегистрируйтесь в [Яндекс Облаке](https://yandex.cloud/). + + {% note warning %} + + На странице [Биллинг](https://billing.yandex.cloud/accounts) убедитесь, что у вас подключен [платежный аккаунт](https://yandex.cloud/ru/docs/billing/concepts/billing-account), и находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](https://yandex.cloud/ru/docs/billing/quickstart/#create_billing_account). + + {% endnote %} + +1. Перейдите в [консоль](https://console.yandex.cloud/folders/). +1. Откройте **Все сервисы** → **API Gateway**. + + {% note info %} + + API Gateway - упрощенный сервер в Яндекс Облаке, который позволяет обслуживать внешние запросы. Настраивается с помощью OpenAPI спецификации. + + {% endnote %} + +1. Нажмите кнопку **Создать API-шлюз**. + +1. Заполните поле **Имя\*** и описание. + +1. В поле **Сеть** выберите `default` или свой вариант. + +1. Заполните поле **Спецификация**, используя шаблон: + + {% cut "Спецификация OpenAPI" %} + + ``` + openapi: 3.0.0 + info: + title: Proxy Example + version: 1.0.0 + servers: + - url: https://d5dj3947rd2qu5g1lbak.apigw.yandexcloud.net + - url: домен-на-который-необходимо-спроксировать-документацию + paths: + /путь/{path+}: + get: + x-yc-apigateway-integration: + headers: + x-real-host: здесь-должен-быть-домен + x-docs-proxy-base: в-каком-каталоге-размещаться + x-docs-project-name: diplodoc-platform--docs + http_method: get + query: + '*': '*' + type: http + url: https://diplodoc-platform--docs.viewer.diplodoc.com/{path} + parameters: + - name: path + in: path + required: false + schema: + type: string + ``` + + {% endcut %} + + #| + || Параметр | Описание параметра || + || `servers:` | Содержит следующие вложенные параметры: + - первый `url` параметр — оставьте по умолчанию, + - второй `url`параметр — укажите свой домен. || + || `paths:` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:` — указывает на каком урле должна располагаться документация. || + || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || + || `headers` | Параметр содержит служебные заголовки. || + |# + + {% note warning %} + + Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:` + + {% endnote %} + +1. Нажмите **Создать**. +1. Привяжите платежный аккаунт, если это необходимо, для этого нажмите кнопку **Привязать**. +1. Готово. В результате должен появиться API-шлюз со статусом `active`. + +\* Поля со звездочкой обязательны для заполнения. + +На данном этапе домен еще не подключен. Перед подключением домена к Яндекс Облаку, нужно [создать новый или загрузить личный сертификат](#cert-creating). + +### Создание сертификата {#cert-creating} + +Для завершения привязки домена к Яндекс Облаку нужно указать сертификат и подтвердить, что вы — владелец домена: + +1. Перейдите в [консоль](https://console.yandex.cloud/folders/). +1. Откройте **Все сервисы** → **Certificate Manager**. +1. Нажмите **Создать сертификат**. +1. В открывшейся странице нажмите **Добавить сертификат**. +1. Выберите в выпадающем меню **Сертификат от Let's Encrypt**. + +{% note info %} + +Если у вас уже есть сертификат, который зарегистрирован во внешнем сервисе, вы можете использовать его, для этого в выпадающем меню выберите **Пользовательский сертификат**. + +{% endnote %} + +1. Заполните поле **Имя\*** и описание. +1. Укажите **Домены\***, для которых необходимо добавить сертификат. +1. Выберите в поле **Тип проверки** - DNS. +1. Готово. Созданный сертификат будет ожидать подтверждения со статусом `Validating`. +1. [Подтвердите](#cert-validating), что вы являетесь владельцем домена. + +\* Поля со звездочкой обязательны для заполнения. + +### Подтверждение сертификата {#cert-validating} + +1. Перейдите в [консоль](https://console.yandex.cloud/folders/). +1. Откройте **Все сервисы** → **Certificate Manager**. +1. Выберите созданный или добавленный сертификат. +1. Пройдите проверку прав на домен, используя один из способов. +1. Готово. Права на владение доменов подтверждены. + +### Подключение домена + +1. Откройте **Все сервисы** → **API Gateway**. +1. Выберите созданный API-шлюз. +1. Нажмите в левом меню **домены**. +1. Нажмите **Подключить**. +1. Выберите созданный сертификат. +1. Укажите домен. +1. Нажмите **Подключить**. +1. Готово. Домен подключен, проксирование на личный домен работает. diff --git a/ru/toc.yaml b/ru/toc.yaml index a5bef10..17ca74e 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -33,6 +33,8 @@ items: href: about.md - name: Начало работы href: how-it-work.md + - name: Собственный домен в Яндекс Облаке и его проксирование + href: personal-domain-ya-cloud.md - name: Yandex Flavored Markdown expanded: true href: index-yfm.md From 10187c74d87498912a4ea5e075d9ad7a368eb395 Mon Sep 17 00:00:00 2001 From: parinovK <62334658+parinovK@users.noreply.github.com> Date: Tue, 2 Jul 2024 19:35:14 +0300 Subject: [PATCH 02/24] =?UTF-8?q?=D0=BE=D1=82=D1=80=D0=B5=D0=B4=D0=B0?= =?UTF-8?q?=D0=BA=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B0=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D1=8F=20=D0=BF=D0=BE=20=D0=BF=D1=80=D0=BE=D0=BA=D1=81=D0=B8?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8E=20Yandex=20Cloud?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 64 +++++++++++++++++++--------------- 1 file changed, 35 insertions(+), 29 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 9e4143c..8cbba7b 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -1,17 +1,21 @@ -# Личный домен в Яндекс Облаке и его проксирование +# Личный домен в Yandex Cloud и его проксирование -Быстрый старт («Quick Start») - сервис, который поможет создать репозиторий и привязать его к внешнему сервису Diplodoc, после чего станет доступна базовая документация, предзаполненная командой Diplodoc. +## Создание репозитория в Diplodoc -1. Переходим в [быстрый старт](https://diplodoc.com/quickstart/). -1. Авторизуемся в Github. +Быстрый старт («Quick Start») - сервис, который поможет создать репозиторий и привязать его к внешнему сервису Diplodoc. - {% note warning %} +Для создания базовой документации: + +1. Откройте [Быстрый старт](https://diplodoc.com/quickstart/). +1. Авторизуйтесь в Github, кликнув по зеленому прямоугольнику с логотипом Github. + + {% note alert %} Если сервис выдаст ошибку «Could not get github state back» - вернитесь на страницу [быстрого старта](https://diplodoc.com/quickstart/). {% endnote %} -1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example». +1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example», предзаполненный командой Diplodoc. 1. В шаге №3 нажмите **Создать** и создайте проект в Diplodoc. 1. Готово. В результате успешного выполнения пошаговой инструкции вы получите сообщение: @@ -25,16 +29,18 @@ Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. ``` - {% note info %} + {% note alert %} - Дождитесь этапа завершения релиза, проект будет доступен по ссылке. + Дождитесь завершения релиза, проект будет доступен по ссылке. {% endnote %} -Для привязки домена к Яндекс Облаку: +## Привязка домена к Yandex Cloud + +Для привязки домена к Yandex Cloud: -1. Зарегистрируйте домен (в этом нам поможет любой [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). -1. Авторизуйтесь или зарегистрируйтесь в [Яндекс Облаке](https://yandex.cloud/). +1. Зарегистрируйте домен (в этом вам поможет любой [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). +1. Авторизуйтесь или создайте аккаунт в [Yandex Cloud](https://yandex.cloud/). {% note warning %} @@ -47,21 +53,20 @@ {% note info %} - API Gateway - упрощенный сервер в Яндекс Облаке, который позволяет обслуживать внешние запросы. Настраивается с помощью OpenAPI спецификации. + API Gateway - упрощенный сервер в Yandex Cloud, который позволяет обслуживать внешние запросы. Настраивается с помощью OpenAPI спецификации. {% endnote %} 1. Нажмите кнопку **Создать API-шлюз**. -1. Заполните поле **Имя\*** и описание. +1. Заполните поля **Имя\*** и описание. 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**, используя шаблон: +1. Заполните поле **Спецификация**, используя шаблон спецификации OpenAPI: {% cut "Спецификация OpenAPI" %} - ``` openapi: 3.0.0 info: title: Proxy Example @@ -88,16 +93,15 @@ required: false schema: type: string - ``` {% endcut %} #| || Параметр | Описание параметра || - || `servers:` | Содержит следующие вложенные параметры: + || `servers` | Содержит следующие вложенные параметры: - первый `url` параметр — оставьте по умолчанию, - второй `url`параметр — укажите свой домен. || - || `paths:` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:` — указывает на каком урле должна располагаться документация. || + || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:` — указывает на каком урле должна располагаться документация. || || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || || `headers` | Параметр содержит служебные заголовки. || |# @@ -114,17 +118,16 @@ \* Поля со звездочкой обязательны для заполнения. -На данном этапе домен еще не подключен. Перед подключением домена к Яндекс Облаку, нужно [создать новый или загрузить личный сертификат](#cert-creating). +На данном этапе домен еще не подключен. Перед подключением домена к Yandex Cloud, нужно [создать новый или загрузить личный сертификат](#cert-creating). ### Создание сертификата {#cert-creating} -Для завершения привязки домена к Яндекс Облаку нужно указать сертификат и подтвердить, что вы — владелец домена: +Для создания нового или загрузки личного сертификата: 1. Перейдите в [консоль](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **Certificate Manager**. 1. Нажмите **Создать сертификат**. -1. В открывшейся странице нажмите **Добавить сертификат**. -1. Выберите в выпадающем меню **Сертификат от Let's Encrypt**. +1. На странице выберите **Добавить сертификат** → **Сертификат от Let's Encrypt**. {% note info %} @@ -132,9 +135,9 @@ {% endnote %} -1. Заполните поле **Имя\*** и описание. +1. Заполните поля **Имя\*** и описание. 1. Укажите **Домены\***, для которых необходимо добавить сертификат. -1. Выберите в поле **Тип проверки** - DNS. +1. Выберите в поле **Тип проверки** — DNS. 1. Готово. Созданный сертификат будет ожидать подтверждения со статусом `Validating`. 1. [Подтвердите](#cert-validating), что вы являетесь владельцем домена. @@ -142,19 +145,22 @@ ### Подтверждение сертификата {#cert-validating} +Для подтверждения прав на владение доменом: + 1. Перейдите в [консоль](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **Certificate Manager**. 1. Выберите созданный или добавленный сертификат. -1. Пройдите проверку прав на домен, используя один из способов. -1. Готово. Права на владение доменов подтверждены. +1. Подтвердите права на владение доменом, используя один из способов. +1. Готово. Права на владение домена подтверждены. ### Подключение домена +Для завершения привязки домена к Yandex Cloud: + 1. Откройте **Все сервисы** → **API Gateway**. 1. Выберите созданный API-шлюз. -1. Нажмите в левом меню **домены**. -1. Нажмите **Подключить**. +1. В левом меню нажмите **домены** → **Подключить**. 1. Выберите созданный сертификат. 1. Укажите домен. 1. Нажмите **Подключить**. -1. Готово. Домен подключен, проксирование на личный домен работает. +1. Готово. Проксирование на личный домен работает. From 6c940a414a694488320b5e6dd837b9128a6e6ed9 Mon Sep 17 00:00:00 2001 From: parinovK <62334658+parinovK@users.noreply.github.com> Date: Tue, 2 Jul 2024 19:40:43 +0300 Subject: [PATCH 03/24] =?UTF-8?q?=D0=BE=D1=82=D1=80=D0=B5=D0=B4=D0=B0?= =?UTF-8?q?=D0=BA=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B0=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=86=D0=B8?= =?UTF-8?q?=D1=8F=20=D0=BF=D0=BE=20=D0=BF=D1=80=D0=BE=D0=BA=D1=81=D0=B8?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D1=8E=20Yandex=20Cloud?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 8cbba7b..e9e309c 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -120,9 +120,9 @@ На данном этапе домен еще не подключен. Перед подключением домена к Yandex Cloud, нужно [создать новый или загрузить личный сертификат](#cert-creating). -### Создание сертификата {#cert-creating} +### Создание/загрузка сертификата {#cert-creating} -Для создания нового или загрузки личного сертификата: +Для создания или загрузки личного сертификата: 1. Перейдите в [консоль](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **Certificate Manager**. From 0dc7ce33d388775898ed546cb1bbb1eb360481b1 Mon Sep 17 00:00:00 2001 From: parinovK <62334658+parinovK@users.noreply.github.com> Date: Wed, 3 Jul 2024 12:31:50 +0300 Subject: [PATCH 04/24] =?UTF-8?q?=D0=9F=D0=BE=D0=BF=D1=80=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=B3=D1=80=D0=B0=D0=BC=D0=BC=D0=B0?= =?UTF-8?q?=D1=82=D0=B8=D1=87=D0=B5=D1=81=D0=BA=D0=B8=D0=B5=20=D0=B8=20?= =?UTF-8?q?=D1=81=D1=82=D0=B8=D0=BB=D0=B8=D1=81=D1=82=D0=B8=D1=87=D0=B5?= =?UTF-8?q?=D1=81=D0=BA=D0=B8=D0=B5=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BA=D0=B8?= =?UTF-8?q?.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index e9e309c..fb366dc 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -44,7 +44,7 @@ {% note warning %} - На странице [Биллинг](https://billing.yandex.cloud/accounts) убедитесь, что у вас подключен [платежный аккаунт](https://yandex.cloud/ru/docs/billing/concepts/billing-account), и находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](https://yandex.cloud/ru/docs/billing/quickstart/#create_billing_account). + На странице [Биллинг](https://billing.yandex.cloud/accounts) убедитесь, что у вас подключен [платежный аккаунт](https://yandex.cloud/ru/docs/billing/concepts/billing-account) и находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](https://yandex.cloud/ru/docs/billing/quickstart/#create_billing_account). {% endnote %} @@ -101,19 +101,19 @@ || `servers` | Содержит следующие вложенные параметры: - первый `url` параметр — оставьте по умолчанию, - второй `url`параметр — укажите свой домен. || - || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:` — указывает на каком урле должна располагаться документация. || + || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:`, который указывает на каком урле должна располагаться документация. || || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || || `headers` | Параметр содержит служебные заголовки. || |# {% note warning %} - Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:` + Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. {% endnote %} 1. Нажмите **Создать**. -1. Привяжите платежный аккаунт, если это необходимо, для этого нажмите кнопку **Привязать**. +1. Если платежный аккаунт не привязан, нажмите **Привязать**. 1. Готово. В результате должен появиться API-шлюз со статусом `active`. \* Поля со звездочкой обязательны для заполнения. From ee50cad1f3144c253e925655737180d730d389a2 Mon Sep 17 00:00:00 2001 From: parinovK Date: Thu, 11 Jul 2024 12:46:02 +0300 Subject: [PATCH 05/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=B7=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B5=D0=BD=D1=82=D0=B0?= =?UTF-8?q?=D1=80=D0=B8=D1=8F=20=D0=B2=20=D1=82=D0=B8=D0=BA=D0=B5=D1=82?= =?UTF-8?q?=D0=B5.=20=D0=9E=D1=81=D1=82=D0=B0=D0=BB=D0=B8=D1=81=D1=8C=20?= =?UTF-8?q?=D0=B5=D1=89=D0=B5=20=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 103 ++++++++++++++++----------------- 1 file changed, 49 insertions(+), 54 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index fb366dc..0cc7cb1 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -9,44 +9,41 @@ 1. Откройте [Быстрый старт](https://diplodoc.com/quickstart/). 1. Авторизуйтесь в Github, кликнув по зеленому прямоугольнику с логотипом Github. - {% note alert %} + {% note alert %} - Если сервис выдаст ошибку «Could not get github state back» - вернитесь на страницу [быстрого старта](https://diplodoc.com/quickstart/). + Если сервис выдаст ошибку «Could not get github state back» - обновите текущую страницу. + Чтобы обновить страницу нажмите сочетание клавиш **CTRL + F5**. - {% endnote %} + {% endnote %} 1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example», предзаполненный командой Diplodoc. 1. В шаге №3 нажмите **Создать** и создайте проект в Diplodoc. -1. Готово. В результате успешного выполнения пошаговой инструкции вы получите сообщение: +1. В результате успешного выполнения пошаговой инструкции вы получите сообщение: - ``` - Ключи от каталога с документацией в S3. - Идентификатор ключа: - Здесь-будет-указан-идентификатор-ключа - Секретный ключ: - Здесь-будет-указан-секретный-ключ - - Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. - ``` - - {% note alert %} + ``` + Ключи от каталога с документацией в S3. + Идентификатор ключа: + YCAJEmTm6zlPbQ14F8pLv2xgV + Секретный ключ: + YCO6ctaYJxgdXU5qOaq73ucAfm3BfAc6gZW-1_fk - Дождитесь завершения релиза, проект будет доступен по ссылке. + Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. + ``` - {% endnote %} +1. Дождитесь завершения релиза, проект будет доступен по ссылке в шаге №3 на странице [Быстрого старта](https://diplodoc.com/quickstart). ## Привязка домена к Yandex Cloud Для привязки домена к Yandex Cloud: -1. Зарегистрируйте домен (в этом вам поможет любой [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). +1. Зарегистрируйте домен (для этого используйте [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). 1. Авторизуйтесь или создайте аккаунт в [Yandex Cloud](https://yandex.cloud/). - {% note warning %} + {% note warning %} - На странице [Биллинг](https://billing.yandex.cloud/accounts) убедитесь, что у вас подключен [платежный аккаунт](https://yandex.cloud/ru/docs/billing/concepts/billing-account) и находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](https://yandex.cloud/ru/docs/billing/quickstart/#create_billing_account). + На странице [Биллинг](https://billing.yandex.cloud/accounts) убедитесь, что у вас подключен [платежный аккаунт](https://yandex.cloud/ru/docs/billing/concepts/billing-account) и находится в статусе `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](https://yandex.cloud/ru/docs/billing/quickstart/#create_billing_account). - {% endnote %} + {% endnote %} 1. Перейдите в [консоль](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **API Gateway**. @@ -59,14 +56,15 @@ 1. Нажмите кнопку **Создать API-шлюз**. -1. Заполните поля **Имя\*** и описание. +1. Заполните поля **Имя\*** и описание. Поле со звездочкой обязательно для заполнения. 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**, используя шаблон спецификации OpenAPI: +1. Заполните поле **Спецификация**, используя шаблон спецификации OpenAPI. - {% cut "Спецификация OpenAPI" %} + {% cut "Шаблон спецификации OpenAPI" %} + ``` openapi: 3.0.0 info: title: Proxy Example @@ -93,32 +91,30 @@ required: false schema: type: string + ``` - {% endcut %} + #| + || Параметр | Описание параметра || + || `servers` | Содержит следующие вложенные параметры: + - первый `url` параметр — оставьте по умолчанию, + - второй `url`параметр — укажите свой домен. || + || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:`, который указывает на каком урле должна располагаться документация. || + || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || + || `headers` | Параметр содержит служебные заголовки. || + |# - #| - || Параметр | Описание параметра || - || `servers` | Содержит следующие вложенные параметры: - - первый `url` параметр — оставьте по умолчанию, - - второй `url`параметр — укажите свой домен. || - || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:`, который указывает на каком урле должна располагаться документация. || - || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || - || `headers` | Параметр содержит служебные заголовки. || - |# + {% note warning %} - {% note warning %} + Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. - Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. + {% endnote %} - {% endnote %} + {% endcut %} 1. Нажмите **Создать**. 1. Если платежный аккаунт не привязан, нажмите **Привязать**. -1. Готово. В результате должен появиться API-шлюз со статусом `active`. - -\* Поля со звездочкой обязательны для заполнения. - -На данном этапе домен еще не подключен. Перед подключением домена к Yandex Cloud, нужно [создать новый или загрузить личный сертификат](#cert-creating). +1. В результате должен появиться API-шлюз со статусом `active`. +1. [Создайте новый или загрузите личный сертификат]((#cert-creating)). ### Создание/загрузка сертификата {#cert-creating} @@ -129,20 +125,18 @@ 1. Нажмите **Создать сертификат**. 1. На странице выберите **Добавить сертификат** → **Сертификат от Let's Encrypt**. -{% note info %} + {% note info %} -Если у вас уже есть сертификат, который зарегистрирован во внешнем сервисе, вы можете использовать его, для этого в выпадающем меню выберите **Пользовательский сертификат**. + Если у вас уже есть сертификат, который зарегистрирован во внешнем сервисе, вы можете использовать его, для этого в выпадающем меню выберите **Пользовательский сертификат**. -{% endnote %} + {% endnote %} -1. Заполните поля **Имя\*** и описание. -1. Укажите **Домены\***, для которых необходимо добавить сертификат. +1. Заполните поля **Имя\*** и описание. Поле со звездочкой обязательно для заполнения. +1. Укажите **Домены\***, для которых необходимо добавить сертификат. Поле обязательно для заполнения. 1. Выберите в поле **Тип проверки** — DNS. -1. Готово. Созданный сертификат будет ожидать подтверждения со статусом `Validating`. +1. Созданный сертификат будет ожидать подтверждения со статусом `Validating`. 1. [Подтвердите](#cert-validating), что вы являетесь владельцем домена. -\* Поля со звездочкой обязательны для заполнения. - ### Подтверждение сертификата {#cert-validating} Для подтверждения прав на владение доменом: @@ -150,10 +144,11 @@ 1. Перейдите в [консоль](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **Certificate Manager**. 1. Выберите созданный или добавленный сертификат. -1. Подтвердите права на владение доменом, используя один из способов. -1. Готово. Права на владение домена подтверждены. +1. Подтвердите права на владение доменом, используя один из предложенных способов. +1. Права на владение домена подтверждены. +1. [Подключите домен](#connect-domain). -### Подключение домена +### Подключение домена {#connect-domain} Для завершения привязки домена к Yandex Cloud: @@ -163,4 +158,4 @@ 1. Выберите созданный сертификат. 1. Укажите домен. 1. Нажмите **Подключить**. -1. Готово. Проксирование на личный домен работает. +1. Настройка проксирования на личный домен завершена. From c2fabcb711215cc871d5aca275b2321105a50acc Mon Sep 17 00:00:00 2001 From: parinovK Date: Sun, 14 Jul 2024 23:47:51 +0300 Subject: [PATCH 06/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 65 ++++++++++++++++++++++++---------- 1 file changed, 46 insertions(+), 19 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 0cc7cb1..850df34 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -2,16 +2,16 @@ ## Создание репозитория в Diplodoc -Быстрый старт («Quick Start») - сервис, который поможет создать репозиторий и привязать его к внешнему сервису Diplodoc. +Быстрый старт («Quick Start») — сервис, который поможет создать репозиторий и привязать его к внешнему сервису Diplodoc. Для создания базовой документации: 1. Откройте [Быстрый старт](https://diplodoc.com/quickstart/). -1. Авторизуйтесь в Github, кликнув по зеленому прямоугольнику с логотипом Github. +1. В шаге №1 авторизуйтесь в Github. {% note alert %} - Если сервис выдаст ошибку «Could not get github state back» - обновите текущую страницу. + Если сервис выдаст ошибку «Could not get github state back» — обновите текущую страницу. Чтобы обновить страницу нажмите сочетание клавиш **CTRL + F5**. {% endnote %} @@ -34,7 +34,7 @@ ## Привязка домена к Yandex Cloud -Для привязки домена к Yandex Cloud: +### Создание API-шлюза 1. Зарегистрируйте домен (для этого используйте [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). 1. Авторизуйтесь или создайте аккаунт в [Yandex Cloud](https://yandex.cloud/). @@ -45,12 +45,12 @@ {% endnote %} -1. Перейдите в [консоль](https://console.yandex.cloud/folders/). +1. Перейдите в [консоль Yandex Cloud](https://console.yandex.cloud/folders/). 1. Откройте **Все сервисы** → **API Gateway**. {% note info %} - API Gateway - упрощенный сервер в Yandex Cloud, который позволяет обслуживать внешние запросы. Настраивается с помощью OpenAPI спецификации. + API Gateway — упрощенный сервер в Yandex Cloud, который позволяет обслуживать внешние запросы. Настраивается с помощью OpenAPI спецификации. {% endnote %} @@ -60,9 +60,11 @@ 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**, используя шаблон спецификации OpenAPI. +1. Заполните поле **Спецификация**: используйте свою OpenAPI спецификацию или пример ниже, заменив необходимые параметры. + + {% cut "Пример спецификации OpenAPI" %} - {% cut "Шаблон спецификации OpenAPI" %} + #### Спецификация OpenAPI ``` openapi: 3.0.0 @@ -71,14 +73,14 @@ version: 1.0.0 servers: - url: https://d5dj3947rd2qu5g1lbak.apigw.yandexcloud.net - - url: домен-на-который-необходимо-спроксировать-документацию + - url: example-for-your-domain.net paths: /путь/{path+}: get: x-yc-apigateway-integration: headers: - x-real-host: здесь-должен-быть-домен - x-docs-proxy-base: в-каком-каталоге-размещаться + x-real-host: example-for-your-domain.net + x-docs-proxy-base: docs x-docs-project-name: diplodoc-platform--docs http_method: get query: @@ -93,19 +95,43 @@ type: string ``` + #### Описание параметров спецификации OpenAPI + #| || Параметр | Описание параметра || - || `servers` | Содержит следующие вложенные параметры: - - первый `url` параметр — оставьте по умолчанию, - - второй `url`параметр — укажите свой домен. || - || `paths` | Содержит правило и позволяет настраивать путь с помощью вложенного параметра `/путь/{path+}:`, который указывает на каком урле должна располагаться документация. || - || `get` | Вложенное в `paths:` правило, которое объясняет как путь должен обрабатываться. В шаблоне правило обрабатывает все get-запросы. || - || `headers` | Параметр содержит служебные заголовки. || + || `servers` | Раздел содержит следующие вложенные параметры: + - Первый `url` параметр содержит адрес, на котором работает API Gateway, — оставьте значение по умолчанию. + - Для второго `url` параметра укажите свой домен. || + || `paths` | Содержит вложенное правило, которое позволяет с помощью параметров конфигурировать ответ на корень урла. Вложенный в раздел `paths`, параметр `/путь/{path+}:` указывает по какому адресу должна располагаться документация. + + {% note info %} + + Если вы используете пример OpenAPI спецификации, то документация будет разсположена по адресу `example-for-your-domain.net/docs`. + + {% endnote %}|| + || `get` | Вложенное правило, которое обрабатывает все get-запросы. || + || `headers` | Параметр содержит служебные заголовки: + - x-real-host — домен + - x-docs-proxy-base: docs — в каком каталоге размещаться + - x-docs-project-name: diplodoc-platform--docs — + || + || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. + + {% note info %} + + Если вы используете пример OpenAPI спецификации, то документация будет направляться на домен диплодока. + + {% endnote %}|| + + || `parameters` | Раздел обрабатывает параметр `path` по заданному правилу. || |# {% note warning %} - Если нужно размещаться в корне домена, замените ключ параметра `x-docs-proxy-base` на `' '`, а также у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. + Для размещения в корне домена: + + 1. Используйте пример OpenAPI-конфигурации. + 1. Замените ключ параметра `x-docs-proxy-base` на `' '` и у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. {% endnote %} @@ -114,7 +140,8 @@ 1. Нажмите **Создать**. 1. Если платежный аккаунт не привязан, нажмите **Привязать**. 1. В результате должен появиться API-шлюз со статусом `active`. -1. [Создайте новый или загрузите личный сертификат]((#cert-creating)). +1. Теперь Yandex Cloud может проксировать документацию на свой url. +1. Чтобы заработало проксирование на внешний домен, [создайте новый или загрузите личный сертификат]((#cert-creating)). ### Создание/загрузка сертификата {#cert-creating} From f6ab2304b3ee435132afbacae75866f8fd350742 Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 00:45:19 +0300 Subject: [PATCH 07/24] =?UTF-8?q?=D0=BD=D1=83=D0=B6=D0=BD=D0=BE=20=D0=B7?= =?UTF-8?q?=D0=B0=D0=BF=D0=BE=D0=BB=D0=BD=D0=B8=D1=82=D1=8C=20=D0=BF=D0=B0?= =?UTF-8?q?=D1=80=D0=B0=D0=BC=D0=B5=D1=82=D1=80=20=D0=B4=D0=BB=D1=8F=20?= =?UTF-8?q?=D1=81=D0=BB=D1=83=D0=B6=D0=B5=D0=B1=D0=BD=D0=BE=D0=B3=D0=BE=20?= =?UTF-8?q?=D0=B7=D0=B0=D0=B3=D0=BE=D0=BB=D0=BE=D0=B2=D0=BA=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 34 +++++++++++++++++++++------------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 850df34..459d61f 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -60,11 +60,17 @@ 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**: используйте свою OpenAPI спецификацию или пример ниже, заменив необходимые параметры. +1. Заполните поле **Спецификация**: используйте свою OpenAPI спецификацию или пример. - {% cut "Пример спецификации OpenAPI" %} + {% cut "Пример OpenAPI спецификации" %} - #### Спецификация OpenAPI + {% note warning %} + + Вы открыли пример OpenAPI спецификации. Используйте его, но измените некоторые важные параметры, такие как: адрес внешнего домена или путь, на который должна проксироваться документация. + + {% endnote %} + + #### OpenAPI Спецификация ``` openapi: 3.0.0 @@ -95,26 +101,28 @@ type: string ``` - #### Описание параметров спецификации OpenAPI + #### Описание параметров OpenAPI спецификации #| || Параметр | Описание параметра || - || `servers` | Раздел содержит следующие вложенные параметры: + || `servers` | Настройка вложенных параметров `url` раздела `servers` позволит указать, по какому адресу необходимо проксировать документацию. + Заполните параметры по инструкции: + - Первый `url` параметр содержит адрес, на котором работает API Gateway, — оставьте значение по умолчанию. - - Для второго `url` параметра укажите свой домен. || - || `paths` | Содержит вложенное правило, которое позволяет с помощью параметров конфигурировать ответ на корень урла. Вложенный в раздел `paths`, параметр `/путь/{path+}:` указывает по какому адресу должна располагаться документация. + - Для второго `url` параметра укажите внешний домен, на который нужно проксировать документацию. || + || `paths` | Содержит вложенное правило, которое позволяет с помощью параметров конфигурировать ответ для параметра `url` из раздела `servers`. Параметр `/путь/{path+}:`, вложенный в раздел `paths`, указывает по какому пути должна располагаться документация. {% note info %} - Если вы используете пример OpenAPI спецификации, то документация будет разсположена по адресу `example-for-your-domain.net/docs`. + Если вы используете пример OpenAPI спецификации, то документация будет разсположена по пути `example-for-your-domain.net/docs`. {% endnote %}|| || `get` | Вложенное правило, которое обрабатывает все get-запросы. || - || `headers` | Параметр содержит служебные заголовки: - - x-real-host — домен - - x-docs-proxy-base: docs — в каком каталоге размещаться - - x-docs-project-name: diplodoc-platform--docs — - || + || `headers` | Параметр содержит служебные заголовки. Настройте служебные заголовки для своего домена: + + 1. Для параметра `x-real-host:` укажите адрес внешнего домена. + 1. Для параметра `x-docs-proxy-base:` — укажите в каком каталоге нужно размещать документацию. + 1. Для параметра `x-docs-project-name: ` — укажите .... || || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. {% note info %} From 75516e67302311d6318df4997a8fd6005f575847 Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 01:14:58 +0300 Subject: [PATCH 08/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 459d61f..51b2f93 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -110,19 +110,19 @@ - Первый `url` параметр содержит адрес, на котором работает API Gateway, — оставьте значение по умолчанию. - Для второго `url` параметра укажите внешний домен, на который нужно проксировать документацию. || - || `paths` | Содержит вложенное правило, которое позволяет с помощью параметров конфигурировать ответ для параметра `url` из раздела `servers`. Параметр `/путь/{path+}:`, вложенный в раздел `paths`, указывает по какому пути должна располагаться документация. + || `paths` | Содержит вложенное правило, которое позволяет конфигурировать ответ для параметра `url` из раздела `servers`. Параметр `/путь/{path+}:`, вложенный в раздел `paths`, указывает, по какому пути должна располагаться документация. {% note info %} - Если вы используете пример OpenAPI спецификации, то документация будет разсположена по пути `example-for-your-domain.net/docs`. + Если вы используете пример OpenAPI спецификации, то документация будет расположена по пути `example-for-your-domain.net/docs`. {% endnote %}|| || `get` | Вложенное правило, которое обрабатывает все get-запросы. || || `headers` | Параметр содержит служебные заголовки. Настройте служебные заголовки для своего домена: 1. Для параметра `x-real-host:` укажите адрес внешнего домена. - 1. Для параметра `x-docs-proxy-base:` — укажите в каком каталоге нужно размещать документацию. - 1. Для параметра `x-docs-project-name: ` — укажите .... || + 1. Для параметра `x-docs-proxy-base:` укажите в каком каталоге нужно размещать документацию. + 1. Для параметра `x-docs-project-name: ` укажите .... || || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. {% note info %} @@ -139,7 +139,8 @@ Для размещения в корне домена: 1. Используйте пример OpenAPI-конфигурации. - 1. Замените ключ параметра `x-docs-proxy-base` на `' '` и у параметра `paths` уберите `/путь`, чтобы осталось `/{path+}:`. + 1. Найдите параметр `x-docs-proxy-base` и измените значение на `' '`. + 1. Найдите параметр `paths:` и удалите значение `/путь` из параметра. Значение должно стать таким: `/{path+}:`. {% endnote %} From 3d50502350136bfca2ceee23b0b36ae8c59f1bdd Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 02:15:15 +0300 Subject: [PATCH 09/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B0=20?= =?UTF-8?q?=D1=81=D0=B5=D0=BA=D1=80=D0=B5=D1=82=D0=B0=20=D0=B8=20id?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 51b2f93..68385d6 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -23,9 +23,9 @@ ``` Ключи от каталога с документацией в S3. Идентификатор ключа: - YCAJEmTm6zlPbQ14F8pLv2xgV + YCAJEmFaBcTmNBfg1M6zlPbQ14F8pLv2V Секретный ключ: - YCO6ctaYJxgdXU5qOaq73ucAfm3BfAc6gZW-1_fk + YCO6ctaYJxgdXU5qOaq7uKerBhSfAc6gZW-1_fk Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. ``` From 6c9436c881b019e323505bc731dbab3674322c7e Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 02:22:01 +0300 Subject: [PATCH 10/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=BA=D0=BB=D1=8E=D1=87=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 68385d6..a4e2c6c 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -23,9 +23,9 @@ ``` Ключи от каталога с документацией в S3. Идентификатор ключа: - YCAJEmFaBcTmNBfg1M6zlPbQ14F8pLv2V + YCAJEmFaBcTmNBXxg1M7qSa**** Секретный ключ: - YCO6ctaYJxgdXU5qOaq7uKerBhSfAc6gZW-1_fk + YCO6ctaYJxgdcVs1g3c5qOaq*** Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. ``` From 7d67fee4d6d70882babb357553cd2731a088b81c Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 02:25:06 +0300 Subject: [PATCH 11/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D1=81=D0=B5=D0=BA=D1=80=D0=B5=D1=82=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index a4e2c6c..8951b21 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -23,9 +23,9 @@ ``` Ключи от каталога с документацией в S3. Идентификатор ключа: - YCAJEmFaBcTmNBXxg1M7qSa**** + *********************** Секретный ключ: - YCO6ctaYJxgdcVs1g3c5qOaq*** + *********************** Сохраните идентификатор и ключ. После закрытия диалога значение ключа будет недоступно. Ключ будет добавлен в созданный репозиторий автоматически. ``` From 5da69f39423fa5186c40c15c5af34c73d8d096be Mon Sep 17 00:00:00 2001 From: parinovK Date: Mon, 15 Jul 2024 13:01:21 +0300 Subject: [PATCH 12/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=BF=D0=BE=20=D0=B4=D0=BE=D0=BA=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 8951b21..3c91a59 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -18,7 +18,7 @@ 1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example», предзаполненный командой Diplodoc. 1. В шаге №3 нажмите **Создать** и создайте проект в Diplodoc. -1. В результате успешного выполнения пошаговой инструкции вы получите сообщение: +1. После выполнения пошаговой инструкции вы получите сообщение: ``` Ключи от каталога с документацией в S3. @@ -32,7 +32,7 @@ 1. Дождитесь завершения релиза, проект будет доступен по ссылке в шаге №3 на странице [Быстрого старта](https://diplodoc.com/quickstart). -## Привязка домена к Yandex Cloud +## Подготовка Yandex Cloud для привязки домена ### Создание API-шлюза @@ -184,6 +184,8 @@ 1. Права на владение домена подтверждены. 1. [Подключите домен](#connect-domain). +## Привязка домена к Yandex Cloud + ### Подключение домена {#connect-domain} Для завершения привязки домена к Yandex Cloud: From db1c7d5971d30cc95ef48863a2394aa9f4f00582 Mon Sep 17 00:00:00 2001 From: parinovK Date: Tue, 30 Jul 2024 18:13:16 +0300 Subject: [PATCH 13/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8=20?= =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D0=BE=D0=B1=D0=BB=D0=B0=D0=BA=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 40 ++++++++++++++-------------------- 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 3c91a59..fed7d37 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -8,14 +8,6 @@ 1. Откройте [Быстрый старт](https://diplodoc.com/quickstart/). 1. В шаге №1 авторизуйтесь в Github. - - {% note alert %} - - Если сервис выдаст ошибку «Could not get github state back» — обновите текущую страницу. - Чтобы обновить страницу нажмите сочетание клавиш **CTRL + F5**. - - {% endnote %} - 1. В шаге №2 нажмите **Создать** и создайте репозиторий в Github. В результате будет создан проект с именем «diplodoc-example», предзаполненный командой Diplodoc. 1. В шаге №3 нажмите **Создать** и создайте проект в Diplodoc. 1. После выполнения пошаговой инструкции вы получите сообщение: @@ -60,13 +52,13 @@ 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**: используйте свою OpenAPI спецификацию или пример. +1. Заполните поле **Спецификация**: можно воспользоваться вашей OpenAPI спецификацией или примером. {% cut "Пример OpenAPI спецификации" %} {% note warning %} - Вы открыли пример OpenAPI спецификации. Используйте его, но измените некоторые важные параметры, такие как: адрес внешнего домена или путь, на который должна проксироваться документация. + Вы можете использовать пример OpenAPI спецификации, но не забудьте изменить некоторые важные параметры, такие как: адрес внешнего домена или путь, на который должна проксироваться документация. {% endnote %} @@ -106,10 +98,10 @@ #| || Параметр | Описание параметра || || `servers` | Настройка вложенных параметров `url` раздела `servers` позволит указать, по какому адресу необходимо проксировать документацию. - Заполните параметры по инструкции: + Для проксирования документации на ваш домен настройте вложенные параметры: - - Первый `url` параметр содержит адрес, на котором работает API Gateway, — оставьте значение по умолчанию. - - Для второго `url` параметра укажите внешний домен, на который нужно проксировать документацию. || + - Первый параметр `url` содержит адрес, на котором работает API Gateway, — оставьте значение по умолчанию. + - Для второго параметра `url` укажите внешний домен, на который нужно проксировать документацию. || || `paths` | Содержит вложенное правило, которое позволяет конфигурировать ответ для параметра `url` из раздела `servers`. Параметр `/путь/{path+}:`, вложенный в раздел `paths`, указывает, по какому пути должна располагаться документация. {% note info %} @@ -117,17 +109,18 @@ Если вы используете пример OpenAPI спецификации, то документация будет расположена по пути `example-for-your-domain.net/docs`. {% endnote %}|| + || `get` | Вложенное правило, которое обрабатывает все get-запросы. || - || `headers` | Параметр содержит служебные заголовки. Настройте служебные заголовки для своего домена: + || `headers` | Параметр содержит служебные заголовки. Для настройки служебных заголовков укажите: - 1. Для параметра `x-real-host:` укажите адрес внешнего домена. - 1. Для параметра `x-docs-proxy-base:` укажите в каком каталоге нужно размещать документацию. - 1. Для параметра `x-docs-project-name: ` укажите .... || - || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. + 1. В параметре `x-real-host:` адрес вашего домена. + 1. В параметре `x-docs-proxy-base:` каталог для размещения документации. + 1. В параметре `x-docs-project-name:` название проекта.|| + || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. {% note info %} - Если вы используете пример OpenAPI спецификации, то документация будет направляться на домен диплодока. + Если для параметра `url` оставить значение по умолчанию, то документация будет перенаправляться на домен диплодока. {% endnote %}|| @@ -136,11 +129,10 @@ {% note warning %} - Для размещения в корне домена: - - 1. Используйте пример OpenAPI-конфигурации. - 1. Найдите параметр `x-docs-proxy-base` и измените значение на `' '`. - 1. Найдите параметр `paths:` и удалите значение `/путь` из параметра. Значение должно стать таким: `/{path+}:`. + Для размещения в корне домена в OpenAPI-конфигурации измените: + + 1. Значение у параметра `x-docs-proxy-base` на `' '`. + 1. Значение у параметра `paths:` на `{path+}:`. {% endnote %} From d194c8207b5d5ebb5e7eef3f1ef2a2d46eca572d Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 01:34:00 +0300 Subject: [PATCH 14/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8=20?= =?UTF-8?q?=D0=BF=D0=BE=20=D1=81=D0=BE=D0=B7=D0=B4=D0=B0=D0=BD=D0=B8=D1=8E?= =?UTF-8?q?=20=D0=B4=D0=BE=D0=BC=D0=B5=D0=BD=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index fed7d37..0f67e82 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -111,12 +111,14 @@ {% endnote %}|| || `get` | Вложенное правило, которое обрабатывает все get-запросы. || - || `headers` | Параметр содержит служебные заголовки. Для настройки служебных заголовков укажите: + || `headers` | Раздел содержит служебные заголовки. Для настройки служебных заголовков: - 1. В параметре `x-real-host:` адрес вашего домена. - 1. В параметре `x-docs-proxy-base:` каталог для размещения документации. - 1. В параметре `x-docs-project-name:` название проекта.|| - || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. + 1\. В `x-real-host:` задается адрес домена. + 2\. В `x-docs-proxy-base:` задается каталог, на котором будет размещаться документация. + 3\. В `x-docs-project-name:` задается название проекта. + + Для настройки служебных заголовков укажите:|| + || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. {% note info %} @@ -131,8 +133,8 @@ Для размещения в корне домена в OpenAPI-конфигурации измените: - 1. Значение у параметра `x-docs-proxy-base` на `' '`. - 1. Значение у параметра `paths:` на `{path+}:`. + 1. У параметра `x-docs-proxy-base` значение на `' '`. + 1. У параметра `paths:` значение на `{path+}:`. {% endnote %} From ac93f8767aa2aab8aaec46a3e0eab160f4a34c26 Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 12:30:48 +0300 Subject: [PATCH 15/24] =?UTF-8?q?=D0=9F=D1=80=D0=B0=D0=B2=D0=BA=D0=B0=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 0f67e82..c8f0e01 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -113,9 +113,9 @@ || `get` | Вложенное правило, которое обрабатывает все get-запросы. || || `headers` | Раздел содержит служебные заголовки. Для настройки служебных заголовков: - 1\. В `x-real-host:` задается адрес домена. - 2\. В `x-docs-proxy-base:` задается каталог, на котором будет размещаться документация. - 3\. В `x-docs-project-name:` задается название проекта. + 1\. В параметре `x-real-host:` укажите адрес домена. + 2\. В параметре `x-docs-proxy-base:` укажите каталог, на котором будет размещаться документация. + 3\. В параметре `x-docs-project-name:` укажите название проекта. Для настройки служебных заголовков укажите:|| || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. From ecdf8077e7ad731e034e8278f52d45fce87100a4 Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 12:42:47 +0300 Subject: [PATCH 16/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index c8f0e01..a009345 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -115,7 +115,7 @@ 1\. В параметре `x-real-host:` укажите адрес домена. 2\. В параметре `x-docs-proxy-base:` укажите каталог, на котором будет размещаться документация. - 3\. В параметре `x-docs-project-name:` укажите название проекта. + 3\. В параметре `x-docs-project-name:`укажите название проекта. Для настройки служебных заголовков укажите:|| || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. From 5e794cddfd4aca50719ce2f475af0084f26d82dc Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 12:59:16 +0300 Subject: [PATCH 17/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index a009345..c5a3fe1 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -122,7 +122,7 @@ {% note info %} - Если для параметра `url` оставить значение по умолчанию, то документация будет перенаправляться на домен диплодока. + Если вы используете пример OpenAPI спецификации, то документация будет перенаправляться на домен диплодока. {% endnote %}|| From fe04f00f8e373d6a057a294a2586d3ae7182ae7f Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 13:08:44 +0300 Subject: [PATCH 18/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20?= =?UTF-8?q?=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86=D0=B8=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index c5a3fe1..843d23d 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -120,7 +120,7 @@ Для настройки служебных заголовков укажите:|| || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. - {% note info %} + {% note info %} Если вы используете пример OpenAPI спецификации, то документация будет перенаправляться на домен диплодока. From d3e01c1113cb2c223bec6a30f1f5517fcf46eaae Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 13:22:55 +0300 Subject: [PATCH 19/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8=20to?= =?UTF-8?q?c.yaml?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/toc.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ru/toc.yaml b/ru/toc.yaml index 17ca74e..dd821e8 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -31,8 +31,8 @@ navigation: items: - name: Обзор системы href: about.md - - name: Начало работы - href: how-it-work.md + - name: Быстрый старт + href: quickstart.md - name: Собственный домен в Яндекс Облаке и его проксирование href: personal-domain-ya-cloud.md - name: Yandex Flavored Markdown @@ -145,4 +145,4 @@ items: href: vacancy.md - name: Yandex Open Source Jam 2024 hidden: true - href: jam.md + href: jam.md \ No newline at end of file From 458036b313b53cc1ee047c526d35efb000de79ad Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 13:42:15 +0300 Subject: [PATCH 20/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/toc.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/toc.yaml b/ru/toc.yaml index dd821e8..553261e 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -33,7 +33,7 @@ items: href: about.md - name: Быстрый старт href: quickstart.md - - name: Собственный домен в Яндекс Облаке и его проксирование + - name: Личный домен в Yandex Cloud и его проксирование href: personal-domain-ya-cloud.md - name: Yandex Flavored Markdown expanded: true From 6f9374c5ab45bee96e7aed8f256a7ffd7c78b972 Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 13:47:37 +0300 Subject: [PATCH 21/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 843d23d..7b82a3c 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -115,9 +115,7 @@ 1\. В параметре `x-real-host:` укажите адрес домена. 2\. В параметре `x-docs-proxy-base:` укажите каталог, на котором будет размещаться документация. - 3\. В параметре `x-docs-project-name:`укажите название проекта. - - Для настройки служебных заголовков укажите:|| + 3\. В параметре `x-docs-project-name:`укажите название проекта.|| || `url` | Параметр, вложенный в правило `get`, содержит адрес, на который перенаправляется документация. {% note info %} From 1e3328659e5235927a818be907ef3c65428772d1 Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 13:57:31 +0300 Subject: [PATCH 22/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 7b82a3c..1ed8a08 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -52,7 +52,7 @@ 1. В поле **Сеть** выберите `default` или свой вариант. -1. Заполните поле **Спецификация**: можно воспользоваться вашей OpenAPI спецификацией или примером. +1. Заполните поле **Спецификация**: можно воспользоваться своей OpenAPI спецификацией или примером. {% cut "Пример OpenAPI спецификации" %} From 72e2f22c3b17e6a62a22880ffa5397bc3a3aab48 Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 14:05:08 +0300 Subject: [PATCH 23/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index 1ed8a08..b88a34c 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -28,7 +28,7 @@ ### Создание API-шлюза -1. Зарегистрируйте домен (для этого используйте [доменный регистратор](https://yandex.ru/search/?text=доменнный+регистратор)). +1. Зарегистрируйте домен (можно воспользоваться [доменным регистратором](https://yandex.ru/search/?text=доменнный+регистратор)). 1. Авторизуйтесь или создайте аккаунт в [Yandex Cloud](https://yandex.cloud/). {% note warning %} From 28f5ccdf0d440da050655c82e3a2a71bcf83688a Mon Sep 17 00:00:00 2001 From: parinovK Date: Wed, 31 Jul 2024 14:29:15 +0300 Subject: [PATCH 24/24] =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ru/personal-domain-ya-cloud.md | 2 +- ru/toc.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/ru/personal-domain-ya-cloud.md b/ru/personal-domain-ya-cloud.md index b88a34c..b76d6ee 100644 --- a/ru/personal-domain-ya-cloud.md +++ b/ru/personal-domain-ya-cloud.md @@ -1,4 +1,4 @@ -# Личный домен в Yandex Cloud и его проксирование +# Настройка личного домена и его проксирование. ## Создание репозитория в Diplodoc diff --git a/ru/toc.yaml b/ru/toc.yaml index 553261e..45e0715 100644 --- a/ru/toc.yaml +++ b/ru/toc.yaml @@ -33,7 +33,7 @@ items: href: about.md - name: Быстрый старт href: quickstart.md - - name: Личный домен в Yandex Cloud и его проксирование + - name: Настройка личного домена href: personal-domain-ya-cloud.md - name: Yandex Flavored Markdown expanded: true