Публикация обновлений для игр с помощью Yandex Cloud CDN

1. Создайте бакет для файлов:

   aws --endpoint-url=https://storage.yandexcloud.kz \
     s3api create-bucket \
     --bucket <имя_бакета_с_файлами> \
     --acl public-read
   

   Результат:

   {
     "Location": "/<имя_бакета_с_файлами>"
   }
   

2. Создайте бакет для логов:

   aws --endpoint-url=https://storage.yandexcloud.kz \
     s3api create-bucket \
     --bucket <имя_бакета_с_логами>
   

   Результат:

   {
     "Location": "/<имя_бакета_с_логами>"
   }
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

Перед началом работы получите статические ключи доступа — секретный ключ и идентификатор ключа, используемые для аутентификации в Object Storage.

1. Опишите в конфигурационном файле параметры бакета:

   • access_key — идентификатор статического ключа доступа.
   • secret_key — значение секретного ключа доступа.
   • bucket — имя создаваемого бакета.

   Пример структуры конфигурационного файла:

   terraform {
     required_providers {
       yandex = {
         source  = "yandex-cloud/yandex"
         version = ">= 0.47.0"
       }
     }
   }
   
   provider "yandex" {
     cloud_id  = "<идентификатор_облака>"
     folder_id = "<идентификатор_каталога>"
     zone      = "kz1-a"
   }
   
   resource "yandex_storage_bucket" "storage" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "<имя_бакета_с_файлами>"
     acl        = "public-read"
   }
   
   resource "yandex_storage_bucket" "logs" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "<имя_бакета_с_логами>"
   }
   

2. Проверьте корректность конфигурационных файлов:

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразятся параметры создаваемого бакета. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните бакет:

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание бакета.

Используйте метод API create.

Используйте метод API putBucketLogging для бакета с файлами. Тело HTTP-запроса:

<BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01">
  <LoggingEnabled>
    <TargetBucket>имя бакета с логами</TargetBucket>
    <TargetPrefix>префикс ключа</TargetPrefix>
  </LoggingEnabled>
</BucketLoggingStatus>

Где:

• TargetBucket — имя бакета, в который будут записываться логи.
• TargetPrefix – префикс ключа для объектов с логами, например logs/.

Выполните команду:

aws --endpoint-url=https://storage.yandexcloud.kz \
  s3 cp \
  <путь_к_файлу_ycgame-update-v1.1.exe> \
  s3://<имя_бакета_с_файлами>/ycgame-update-v1.1.exe

Результат:

upload: <путь_к_файлу_ycgame-update-v1.1.exe> to s3://<имя_бакета_с_файлами>/ycgame-update-v1.1.exe

1. Добавьте к конфигурационному файлу из шага с созданием бакетов параметры объекта, который необходимо загрузить:

   • bucket — имя бакета для добавления объекта.
   • key — имя объекта в бакете: ycgame-update-v1.1.exe. Обязательный параметр.
   • source — относительный или абсолютный путь к файлу, загружаемому как объект.

   Пример структуры конфигурационного файла:

   ...
   resource "yandex_storage_object" "patch-v1-1" {
     access_key = "<идентификатор_статического_ключа>"
     secret_key = "<секретный_ключ>"
     bucket     = "<имя_бакета_с_файлами>"
     key        = "ycgame-update-v1.1.exe"
     source     = "<путь_к_файлу>/ycgame-update-v1.1.exe"
   }
   

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку с конфигурационным файлом.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание объекта.

Используйте метод API upload.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Создайте CDN-ресурс:

   yc cdn resource create \
     --cname cdn.ycprojectblue.example \
     --origin-bucket-source <имя_бакета_с_файлами>.storage.yandexcloud.kz \
     --origin-bucket-name <имя_бакета_с_файлами> \
     --origin-protocol https \
     --cert-manager-ssl-cert-id <идентификатор_сертификата> \
     --host-header <имя_бакета_с_файлами>.storage.yandexcloud.kz
   

   Результат:

   id: bc8e3l7s4dha********
   folder_id: b1g86q4m5vej********
   cname: cdn.ycprojectblue.example
   ...
   active: true
   ...
   

   Подробнее о команде yc cdn resource create смотрите в справочнике CLI.

   Совет

   Если в качестве источника используется бакет Object Storage, рекомендуем включить для него хостинг статического сайта.

2. Включите кеширование на CDN-серверах:

   yc cdn resource update <идентификатор_ресурса> \
     --cache-expiration-time 345600
   

   Где --cache-expiration-time — время жизни кеша в секундах.

3. Включите переадресацию клиентов для ресурса:

   yc cdn resource update <идентификатор_ресурса> --redirect-http-to-https
   

1. Добавьте в конфигурационный файл параметры CDN-ресурсов:

   ...
   resource "yandex_cdn_origin_group" "my_group" {
     name     = "updates-origin-group"
     use_next = true
     origin {
       source = "<имя_бакета_с_файлами>.storage.yandexcloud.kz"
     }
   }
   
   resource "yandex_cdn_resource" "my_resource" {
     cname               = "cdn.ycprojectblue.example"
     active              = true
     origin_protocol     = "https"
     origin_group_id     = yandex_cdn_origin_group.my_group.id
     options {
       edge_cache_settings    = "345600"
       custom_host_header     = "<имя_бакета_с_файлами>.storage.yandexcloud.kz"
     }
     ssl_certificate {
       type                   = "certificate_manager"
       certificate_manager_id = "<идентификатор_сертификата>"
     }
   }
   

   Подробнее в описаниях ресурсов yandex_cdn_origin_group и yandex_cdn_resource в документации провайдера Terraform.

   Совет

   Если в качестве источника используется бакет Object Storage, рекомендуем включить для него хостинг статического сайта.

2. Проверьте корректность конфигурационных файлов.

   1. В командной строке перейдите в папку, где вы создали конфигурационный файл.

   2. Выполните проверку с помощью команды:

      terraform plan
      

   Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут созданы. Если в конфигурации есть ошибки, Terraform на них укажет.

3. Примените изменения конфигурации:

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.

   После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.

4. Включите переадресацию клиентов для ресурса. Добавьте в начало блока options для CDN-ресурса следующее поле:

   ...
   options {
     redirect_http_to_https = true
   ...
   

5. Выполните проверку с помощью команды:

   terraform plan
   

   Если конфигурация описана верно, в терминале отобразится список обновляемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.

6. Если ошибок нет, выполните команду:

   terraform apply
   

7. Подтвердите обновление ресурса: введите в терминал слово yes и нажмите Enter.

После этого у ресурса будет включена переадресация.

Используйте вызов gRPC API ResourceService/Create или метод REST API create. Чтобы включить кеширование на CDN-серверах, добавьте в тело запроса поле edge_cache_settings.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Укажите путь к файлу, который нужно предзагрузить:

yc cdn cache prefetch --resource-id <идентификатор_ресурса> \
  --path /ycgame-update-v1.1.exe

Подробнее о команде yc cdn cache prefetch смотрите в справочнике CLI.

Используйте вызов gRPC API CacheService/Prefetch или метод REST API prefetch.