Управляемые кластеры

Узнайте о управляемых кластерах и быстро начните работу с пользовательскими бэкенд-решениями.

✔️ Введение

Управляемые кластеры упрощают и ускоряют размещение самоуправляемых игровых сервисов и игрового бэкенда. Вы подготавливаете образ сервиса, а мы предоставляем отказоустойчивую облачную среду с высокой доступностью для их запуска:

• аутентификация игроков,

• хранение данных — аккаунты, прогресс, инвентарь, награды и т.д.,

• социальные сервисы — чат, кланы, таблицы лидеров, турниры и т.д.,

• пользовательский матчмейкинг — с использованием Управляемые кластеры, Управляемые кластеры, ...

• безсерверные вычисления — управляемые функции как сервис (альт. cloudscript, lambda) и т.д.,

См. Матчмейкинг и Браузер серверов чтобы начать интеграцию клиентской части игры.

Приватные кластеры гарантируют, что ваши сервисы имеют выделённые вычислительные ресурсы для обслуживания игроков круглосуточно.

В настоящее время мы предлагаем 3 уровня частных кластеров чтобы удовлетворить потребности каждого:

Уровень	Уровень для хобби	Уровень для студии	Уровень Enterprise
Лучше всего подходит для	энтузиасты, одиночные разработчики	коммерческие релизы	запуски с высоким трафиком
Ресурсы	1 vCPU + 2 ГБ ОЗУ	6 vCPU + 12 ГБ ОЗУ	18 vCPU + 48 ГБ ОЗУ
Избыточность	1 виртуальный узел	3 виртуальных узла	3 виртуальных узла
Ограничение частоты (запрос/с)	200	750	2,000
Цена, почасово	$0.0312	$0.146	$0.548
Цена за 30 дней (использование без перерывов)	$22.464	$105.12	$394.56

Наши кластерные машины используют процессоры AMD/Intel с тактовой частотой 2.4–3.2 ГГц. Свяжитесь с нами в сообществе Discord чтобы согласовать нагрузочные тесты и убедиться, что вашему серверу доступны достаточные ресурсы.

🛠️ Инструменты для разработчиков

Если вы видите возможности для улучшения, пожалуйста, сообщите нам в нашем сообществе Discord.

Надеемся, что у вас будет гладкий опыт. 🚀

Docker

Чтобы сделать ваш сервер надёжным, мы используем Docker - программное обеспечение виртуализации, обеспечивающее одинаковые до уровня операционной системы зависимости вашего серверного кода независимо от того, как и где сервер запускается.

Мы рекомендуем посмотреть "Никогда не устанавливайте локально" (видео). Вам НЕ нужно использовать Dockerhub с Docker. Docker ≠ Dockerhub. Думайте о Docker как о программном движке, а о Dockerhub как о его магазине приложений.

Kubernetes (K8s)

Kubernetes, также известный как K8s, — это система с открытым исходным кодом для автоматизации развертывания, масштабирования и управления контейнеризованными приложениями (Docker Images). Она группирует контейнеры, составляющие приложение, в логические единицы для облегчения управления и обнаружения.

Управляемые кластеры Edgegap предоставляют Kubernetes API для административных задач.

K8s Lens

С более чем 1 миллионом пользователей, K8s Lens является самой популярной IDE для Kubernetes в мире. Подключайтесь к кластерам, исследуйте, получайте аналитические данные, учитесь и при необходимости действуйте. Lens предоставляет всю информацию о ваших нагрузках и ресурсах в реальном времени, всегда в нужном контексте.

Kubernetes API кластера Edgegap можно использовать через Lens или другие IDE для Kubernetes.

Helm Package Manager

Helm — лучший способ находить, делиться и использовать программное обеспечение, созданное для Kubernetes. Helm помогает управлять Kubernetes-приложениями — Helm Charts помогают определять, устанавливать и обновлять даже самые сложные Kubernetes-приложения. Чарты легко создавать, версионировать, делиться и публиковать — так что начните использовать Helm и прекратите копировать и вставлять.

Установка Helm CLI предоставляет разработчикам простой интерфейс для управления пакетами своего кластера.

🚀 Начало работы

☑️ Зарегистрировались для бесплатного аккаунта Edgegap и обновитесь до тарифа с оплатой по мере использования, чтобы разблокировать Кластеры.

☑️ Перейдите в Управляемые кластеры страницу.

☑️ Нажмите Создать кластер сначала, затем введите:

• Метка для вашего кластера, чтобы позже легко его найти,

• Размер кластера - см. Управляемые кластеры.

Мы настоятельно рекомендуем создавать отдельные кластеры для сред разработки и продакшна.

☑️ Просмотрите оценочную стоимость и нажмите Создать кластер чтобы запустить ваш новый кластер.

☑️ После готовности кластера, нажмите Kubeconfig, чтобы скачать вашу конфигурацию и учётные данные для подключения и администрирования вашего нового кластера.

☑️ Переместите ваш файл kubeconfig в kubectl чтобы он мог его найти.

☑️ Пользователи Lens: импортируйте файл kubeconfig.

☑️ Проверьте подключение к кластеру командой kubectl get nodes :

kubectl get nodes
NAME                            STATUS   ROLES    AGE    VERSION
lke334087-533013-294dcfe70000   Ready    <none>   10m   v1.31.0
lke334087-533013-4e69edc10000   Ready    <none>   10m   v1.31.0
lke334087-533013-50bf39880000   Ready    <none>   10m   v1.31.0

🙌 Поздравляем, вы завершили настройку управляемого кластера! Теперь вы можете устанавливать ваши сервисы.

📦 Nakama от Heroic Labs

См. Управляемые кластеры перед настройкой ваших служб на управляемых кластерах.

Интегрируйте Edgegap с плагином Nakama + плагином Unity! Свяжитесь с нами для других платформ/функций.

Выполните следующие шаги, чтобы разместить свой собственный Игровой бэкенд Nakama в управляемых кластерах:

☑️ Установите Менеджер сертификатов чтобы поддерживать использование HTTPS-запросов от игровых клиентов:

helm repo add jetstack https://charts.jetstack.io --force-update;
helm upgrade --install cert-manager jetstack/cert-manager \
  --namespace cert-manager --create-namespace \
  --version v1.16.1 --set crds.enabled=true;

☑️ Lens: проверьте установку в разделе Services / Network, cert-manager должен быть запущен.

☑️ Создайте Cluster Issuer файл, не забудьте заменить <YOUR_EMAIL> ниже:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-staging
  namespace: cert-manager
spec:
  acme:
    server: https://acme-staging-v02.api.letsencrypt.org/directory
    email: <YOUR_EMAIL>
    privateKeySecretRef:
      name: letsencrypt-staging
    solvers:
    - http01:
        ingress:
          class: nginx
          

Используйте letsencrypt-prod для вашего продакшен-кластера privateKeySecretRef.

☑️ Создайте Cluster Issuer в командной строке:

kubectl create -f <FILE_PATH>/issuer.yaml

☑️ Lens: проверьте установку в разделе Custom Resources / cert-manager.io - cluster issuer создан.

☑️ Установите nginx Ingress для приёма клиентских запросов и передачи их сервисам в кластере:

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm upgrade --install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx --create-namespace

☑️ Lens: проверьте установку в разделе Services / Network, nginx должен быть запущен.

☑️ Создайте DNS запись типа A в вашем DNS-провайдере (например, Cloudflare), запишите URL для дальнейшего использования. Ваш внешний IP для DNS-записи можно найти в Lens в разделе Services / ingress-nginx-controller .

☑️ Проверьте правильность настройки DNS, выполнив запрос с помощью DNSchecker.

☑️ Создайте файл с именем values.yaml с содержимым (используйте свои значения):

isProductionEnvironment: true

# Внешнее доменное имя для сервера Nakama - DNS-запись из предыдущего шага
externalHostName: <DNS_A_RECORD_URL>

nakama:
  # Версия Nakama для развертывания.
  # См. https://hub.docker.com/r/heroiclabs/nakama/tags для доступных версий.
  version: 3.26.0
  # Имя пользователя и пароль для консоли Nakama
  username: <USERNAME>
  password: <PASSWORD>

Замените <VALUES> выше на ваши собственные значения в файле выше.

☑️ Разверните Helm-чарт Nakama:

helm upgrade --install \
  --namespace nakama --create-namespace -f <FILE_PATH>/values.yaml \
  --version 1.0.0 <RELEASE_NAME> oci://registry-1.docker.io/edgegap/heroiclabs-nakama

☑️ Lens: проверьте установку в разделе Workloads / Deployments, nakama должен работать.

✅ Подключитесь к консоли Nakama с помощью URL и учётных данных из values.yaml файла.

🙌 Поздравляем, вы завершили настройку самохостинга игрового бэкенда Nakama!

Обновления сервиса

Выполните следующие шаги, чтобы обновить ваш сервис, размещённый в управляемом кластере:

☑️ Обновите ваш value.yaml файл новыми файлами.

☑️ Обновите ваш Helm-чарт, используя эту команду:

helm upgrade --reuse-values \
  --namespace nakama -f <FILE_PATH>/values.yaml \
  --version 1.0.0 <RELEASE_NAME> oci://registry-1.docker.io/edgegap/heroiclabs-nakama

☑️ Перезагрузите изменения, завершив обновлённые поды, что приведёт к использованию нового Helm-чарта после автоматического перезапуска подов.

Это это обновление вызовет краткий простой пока поды перезапускаются.

🙌 Поздравляем, вы завершили обновление кластера Nakama!

👷 Расширенный матчмейкер

См. Управляемые кластеры перед настройкой ваших служб на управляемых кластерах.

Выполните следующие шаги, чтобы разместить ваш OpenMatch в управляемом кластере.

☑️ Установите Менеджер сертификатов чтобы поддерживать использование HTTPS-запросов от игровых клиентов:

helm repo add jetstack https://charts.jetstack.io --force-update;
helm upgrade --install cert-manager jetstack/cert-manager \
  --namespace cert-manager --create-namespace \
  --version v1.16.1 --set crds.enabled=true;

☑️ Lens: проверьте установку в разделе Services / Network, cert-manager должен быть запущен.

☑️ Создайте Cluster Issuer файл, не забудьте заменить <YOUR_EMAIL> ниже:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-staging
  namespace: cert-manager
spec:
  acme:
    server: https://acme-staging-v02.api.letsencrypt.org/directory
    email: <YOUR_EMAIL>
    privateKeySecretRef:
      name: letsencrypt-staging
    solvers:
    - http01:
        ingress:
          class: nginx
          

Используйте letsencrypt-prod для вашего продакшен-кластера privateKeySecretRef.

☑️ Создайте Cluster Issuer в командной строке:

kubectl create -f <FILE_PATH>/issuer.yaml

☑️ Lens: проверьте установку в разделе Custom Resources / cert-manager.io - cluster issuer создан.

☑️ Установите nginx Ingress для приёма клиентских запросов и передачи их сервисам в кластере:

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm upgrade --install ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx --create-namespace

☑️ Lens: проверьте установку в разделе Services / Network, nginx должен быть запущен.

☑️ Создайте DNS-запись типа A в вашем DNS-провайдере (например, Cloudflare), запишите URL для дальнейшего использования. Ваш внешний IP для DNS-записи можно найти в Lens в разделе Services / ingress-nginx-controller .

☑️ Проверьте правильность настройки DNS, выполнив запрос с помощью DNSchecker.

☑️ Создайте файл с именем values.yaml с содержимым (используйте свои значения):

isProductionEnvironment: false

director:
  credential:
    registry: <YOUR_DIRECTOR_REGISTRY>
    username: <YOUR_DIRECTOR_REGISTRY_USERNAME>
    password: <YOUR_DIRECTOR_REGISTRY_PASSWORD>
  image: <DIRECTOR_IMAGE>
  env: {
    "KEY": "VALUE"
  }

mmf:
  credential:
    registry: <MATCHMAKER_FUNCTION_REGISTRY>
    username: <MATCHMAKER_FUNCTION_REGISTRY_USERNAME>
    password: <MATCHMAKER_FUNCTION_REGISTRY_PASSWORD>
  image: <MATCHMAKER_FUNCTION_IMAGE>
  env: {
    "KEY": "VALUE"
  }

frontend:
  credential:
    registry: <FRONTEND_REGISTRY>
    username: <FRONTEND_REGISTRY_USERNAME>
    password: <FRONTEND_REGISTRY_PASSWORD>
  externalHostName: <YOUR_CLOUDFLARE_HOST_NAME> # например: exemple.test.com
  image: <FRONTEND_IMAGE>
  env: {
    "KEY": "VALUE"
  }

# Глобальные конфигурации, видимые для всех сабчартов
global:
  kubernetes:
    resources:
      requests:
        memory: 100Mi
        cpu: 100m
      limits:
        memory: 100Mi
        cpu: 100m

Замените <VALUES> выше на ваши собственные значения в файле выше.

☑️ Добавьте репозиторий Edgegap в список ваших репозиториев:

helm repo add edgegap-public https://registry.edgegap.com/chartrepo/edgegap-public

☑️ Разверните Helm-чарт расширенного матчмейкера:

helm upgrade --install \
  --namespace matchmaker --create-namespace -f <FILE_PATH>/values.yaml \
  --version 1.0.1 <RELEASE_NAME> edgegap-public/open-match-edgegap

🙌 Поздравляем, вы завершили настройку расширенного матчмейкера!

Обновления сервиса

Выполните следующие шаги, чтобы обновить ваш сервис, размещённый в управляемом кластере:

☑️ Обновите ваш value.yaml файл новыми файлами.

☑️ Обновите ваш Helm-чарт, используя эту команду:

helm upgrade --reuse-values \
  --namespace matchmaker -f <FILE_PATH>/values.yaml \
  --version 1.0.1 <RELEASE_NAME> edgegap-public/open-match-edgegap

☑️ Перезагрузите изменения, завершив обновлённые поды (director, mmf, frontend), что приведёт к использованию нового Helm-чарта после автоматического перезапуска подов.

Это это обновление вызовет краткий простой пока поды перезапускаются.

🙌 Поздравляем, вы завершили обновление расширенного матчмейкера!

Непрерывное развёртывание

Автоматизируйте обновление ваших сервисов, добавив этот shell-скрипт в ваш конвейер развёртывания:

#!/bin/bash

RELEASE_NAME="<RELEASE_NAME>"
NAMESPACE="matchmaker"  # Измените это, если вы поменяли namespace.

helm upgrade --reuse-values -f <FILE_PATH>/value.yaml --namespace $NAMESPACE --version 1.0.1 $RELEASE_NAME edgegap-public/open-match-edgegap

echo "Установка redis-tools"
apt-get update
apt-get install -y redis-tools

DIRECTOR_DEPLOYMENT_NAME="$RELEASE_NAME-director"
MMF_DEPLOYMENT_NAME="$RELEASE_NAME-mmf"
CUSTOM_FRONTEND_DEPLOYMENT_NAME="$RELEASE_NAME-custom-frontend"
REDIS_HOST="$RELEASE_NAME-redis-master"

declare -A replicas

# Для каждого деплоймента (director, mmf, custom-frontend) остановите поды
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
  echo "Остановка подов для деплоймента: $deployment"
  replicas[$deployment]=$(kubectl get deployment $deployment -o=jsonpath='{.spec.replicas}' --namespace $NAMESPACE)
  kubectl scale deployment/$deployment --replicas=0 --namespace $NAMESPACE
done

# Подождите, пока поды не завершатся
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do

  echo "Ожидание завершения подов для деплоймента: $deployment"
  kubectl wait --for=delete pod -l app=$deployment --timeout=60s --namespace $NAMESPACE

  # Проверьте, успешно ли выполнилась команда wait. Если нет — завершите скрипт
  if [ $? -ne 0 ]; then
    echo "Не удалось дождаться завершения подов для деплоймента: $deployment"
    exit 1
  fi
done

# Очистите базу данных redis
echo "Очистка базы данных redis"
redis-cli -h $REDIS_HOST flushall

# Для каждого деплоймента (director, mmf, custom-frontend) восстановите количество подов к исходному значению
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
  echo "Восстановление количества подов до ${replicas[$deployment]} для деплоймента: $deployment"
  kubectl scale deployment/$deployment --replicas=${replicas[$deployment]} --namespace $NAMESPACE
done

Это это обновление вызовет краткий простой пока поды перезапускаются.

Проверка сертификата Letsencrypt (C#)

Для некоторых клиентов рекомендованная проверка сертификата Letsencrypt может завершаться с ошибкой:

Curl error 60: Cert verify failed. Certificate has expired. UnityTls error code: 7

Обновление вашей операционной системы может устранить проблемы с устаревшим корневым центром сертификации.

В крайнем случае, игровые клиенты могут реализовать пользовательскую функцию обработки сертификата:

```csharp
public class CustomCertificateHandler : CertificateHandler
{
  private readonly string EXPECTED_CERT = "-----BEGIN CERTIFICATE-----<key>-----END CERTIFICATE-----\r\n";
  protected override bool ValidateCertificate(byte[] certificateData)
  {
    X509Certificate2 certificate = new X509Certificate2(certificateData);
    X509Certificate2 expectedCert = new X509Certificate2(Encoding.ASCII.GetBytes(EXPECTED_CERT));

    using (SHA256 sha256 = SHA256.Create())
    {
      Debug.Log("certificate.Thumbprint: " + certificate.Thumbprint);
      Debug.Log("expectedCert.Thumbprint: " + expectedCert.Thumbprint);

      return certificate.Thumbprint == expectedCert.Thumbprint;
    }
  }
}
```

Использование:

UnityWebRequest request = UnityWebRequest.Get(...);
request.certificateHandler = new BypassCertificateHandler();
request.SendWebRequest();
request.certificateHandler.Dispose();

Мы рекомендуем хранить значение EXPECTED_CERT в вашем собственном файловом хранилище и извлекать его во время выполнения, чтобы вы могли обновлять его без выпуска обновления клиента игры.

🟢 Операции и наблюдаемость

Изменения уровня кластера

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

Изменение размера кластера требует остановки кластера. См. blue/green deployment для обновлений без простоя.

Поддержка и будущие обновления

Ваш успех — наш приоритет. Если вы хотите отправлять индивидуальные запросы, попросить недостающие критические функции или высказать любые мысли, пожалуйста, свяжитесь с нами в нашем сообществе Discord.