` ниже:
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
{% hint style="danger" %}
Используйте `letsencrypt-prod` для вашего продакшн-кластера `privateKeySecretRef`.
{% endhint %}
☑️ Создайте **Cluster Issuer** в командной строке:
```bash
kubectl create -f /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](https://developers.cloudflare.com/dns/get-started/)), запомните URL на будущее. Ваш **внешний IP для записи DNS** можно найти в Lens в разделе Services / `ingress-nginx-controller` .
☑️ Проверьте, что ваш DNS настроен правильно, выполнив запрос [с помощью DNSchecker](https://dnschecker.org/ns-lookup.php).
☑️ Создайте файл с именем `values.yaml` с содержимым (используйте свои значения):
isProductionEnvironment: true
# Внешний hostname для сервера 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>
{% hint style="danger" %}
**Замените \ выше своими значениями** в файле выше.
{% endhint %}
☑️ Разверните helm chart Nakama:
```bash
helm upgrade --install \\
--namespace nakama --create-namespace -f /values.yaml \\
--version 1.0.0 oci://registry-1.docker.io/edgegap/heroiclabs-nakama
```
☑️ Lens: проверьте установку в разделе Workloads / Deployments, `nakama` должен быть запущен.
✅ **Подключитесь к консоли Nakama** с URL и учетными данными из `values.yaml` файла.
🙌 Поздравляем, вы завершили настройку self-hosted Nakama Game Backend!
### Обновления сервиса
Следуйте этим шагам, чтобы обновить ваш сервис, размещенный в Managed Cluster:
☑️ Обновите ваш `value.yaml` файл новыми файлами.
☑️ Обновите ваш helm chart, используя эту команду:
```bash
helm upgrade --reuse-values \\
--namespace nakama -f /values.yaml \\
--version 1.0.0 oci://registry-1.docker.io/edgegap/heroiclabs-nakama
```
☑️ Примените изменения заново, закрыв обновленные pods, что приведет к использованию нового helm chart после автоматического перезапуска pods.
{% hint style="warning" %}
Это **Это обновление приведёт к короткому простою** пока поды перезапускаются.
{% endhint %}
🙌 Поздравляем, вы завершили обновление кластера Nakama!
## 👷 Продвинутый матчмейкер
{% hint style="success" %}
См. [Managed Clusters](/ru/learn/advanced-features/managed-clusters.md#getting-started) перед настройкой ваших служб на управляемых кластерах.
{% endhint %}
Следуйте этим шагам, чтобы разместить ваш [OpenMatch](https://open-match.dev/site/) в Managed Cluster.
☑️ Установите **Диспетчер сертификатов** для поддержки использования HTTPS-запросов от игровых клиентов:
```bash
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** файл, не забудьте заменить `` ниже:
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
{% hint style="danger" %}
Используйте `letsencrypt-prod` для вашего продакшн-кластера `privateKeySecretRef`.
{% endhint %}
☑️ Создайте **Cluster Issuer** в командной строке:
```bash
kubectl create -f /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](https://developers.cloudflare.com/dns/get-started/)), запомните URL на будущее. Ваш **внешний IP для записи DNS** можно найти в Lens в разделе Services / `ingress-nginx-controller` .
☑️ Проверьте, что ваш DNS настроен правильно, выполнив запрос [с помощью DNSchecker](https://dnschecker.org/ns-lookup.php).
☑️ Создайте файл с именем `values.yaml` с содержимым (используйте свои значения):
```yaml
isProductionEnvironment: false
director:
credential:
registry:
username:
password:
image:
env: {
"KEY": "VALUE"
}
mmf:
credential:
registry:
username:
password:
image:
env: {
"KEY": "VALUE"
}
frontend:
credential:
registry:
username:
password:
externalHostName: # e.g. exemple.test.com
image:
env: {
"KEY": "VALUE"
}
# Глобальные конфигурации, видимые для всех подграфиков
global:
kubernetes:
resources:
requests:
memory: 100Mi
cpu: 100m
limits:
memory: 100Mi
cpu: 100m
```
{% hint style="danger" %}
**Замените \ выше своими значениями** в файле выше.
{% endhint %}
☑️ Добавьте **репозиторий Edgegap** в список ваших репозиториев:
```bash
helm repo add edgegap-public https://registry.edgegap.com/chartrepo/edgegap-public
```
☑️ Разверните helm chart продвинутого матчмейкера:
```bash
helm upgrade --install \\
--namespace matchmaker --create-namespace -f /values.yaml \\
--version 1.0.1 edgegap-public/open-match-edgegap
```
🙌 Поздравляем, вы завершили настройку Advanced Matchmaker!
### Обновления сервиса
Следуйте этим шагам, чтобы обновить ваш сервис, размещенный в Managed Cluster:
☑️ Обновите ваш `value.yaml` файл новыми файлами.
☑️ Обновите ваш helm chart, используя эту команду:
```bash
helm upgrade --reuse-values \\
--namespace matchmaker -f /values.yaml \\
--version 1.0.1 edgegap-public/open-match-edgegap
```
☑️ Примените изменения заново, закрыв обновленные pods (director, mmf, frontend), что приведет к использованию нового helm chart после автоматического перезапуска pods.
{% hint style="warning" %}
Это **Это обновление приведёт к короткому простою** пока поды перезапускаются.
{% endhint %}
🙌 Поздравляем, вы завершили обновление Advanced Matchmaker!
### Непрерывное развертывание
Автоматизируйте обновление ваших сервисов, добавив этот shell-скрипт в ваш pipeline развертывания:
```bash
#!/bin/bash
RELEASE_NAME=""
NAMESPACE="matchmaker" # Измените это, если вы изменили namespace.
helm upgrade --reuse-values -f /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) остановите pods
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "Остановка pods для развертывания: $deployment"
replicas[$deployment]=$(kubectl get deployment $deployment -o=jsonpath='{.spec.replicas}' --namespace $NAMESPACE)
kubectl scale deployment/$deployment --replicas=0 --namespace $NAMESPACE
done
# Подождите, пока pods будут завершены
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "Ожидание завершения pods для развертывания: $deployment"
kubectl wait --for=delete pod -l app=$deployment --timeout=60s --namespace $NAMESPACE
# Проверьте, успешно ли выполнена команда ожидания. Если нет, завершите скрипт
if [ $? -ne 0 ]; then
echo "Не удалось дождаться завершения pods для развертывания: $deployment"
exit 1
fi
done
# Очистите базу данных redis
echo "Очистка базы данных redis"
redis-cli -h $REDIS_HOST flushall
# Для каждого развертывания (director, mmf, custom-frontend) верните pods к их исходному количеству
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "Масштабирование pods до ${replicas[$deployment]} для развертывания: $deployment"
kubectl scale deployment/$deployment --replicas=${replicas[$deployment]} --namespace $NAMESPACE
done
```
{% hint style="warning" %}
Это **Это обновление приведёт к короткому простою** пока поды перезапускаются.
{% endhint %}
### Проверка сертификата Let's Encrypt (C#)
Для некоторых клиентов рекомендуемая проверка сертификата Let's Encrypt может завершаться ошибкой:
```bash
Ошибка Curl 60: проверка сертификата не удалась. Срок действия сертификата истек. Код ошибки UnityTls: 7
```
{% hint style="success" %}
Обновление вашей операционной системы может устранить проблемы с устаревшим корневым центром сертификации.
{% endhint %}
В крайнем случае игровые клиенты могут реализовать собственную функцию обработки сертификата:
````csharp
```csharp
public class CustomCertificateHandler : CertificateHandler
{
private readonly string EXPECTED_CERT = "-----BEGIN CERTIFICATE----------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;
}
}
}
```
````
Использование:
```csharp
UnityWebRequest request = UnityWebRequest.Get(...);
request.certificateHandler = new BypassCertificateHandler();
request.SendWebRequest();
request.certificateHandler.Dispose();
```
Мы рекомендуем хранить `EXPECTED_CERT` значение в вашем собственном хранилище файлов и получать его во время выполнения, чтобы вы могли обновлять его без выпуска обновления игрового клиента.
## 🟢 Эксплуатация и наблюдаемость
### Изменения уровня кластера
Подготовьтесь к успеху и оптимизируйте после запуска, чтобы не блокировать ваших игроков в день релиза.
{% hint style="warning" %}
Изменение размера кластера требует остановки вашего кластера. См. [blue/green deployment](https://circleci.com/blog/canary-vs-blue-green-downtime/) для обновлений без простоя.
{% endhint %}
### Поддержка и будущие обновления
**Ваш успех — наш приоритет.** Если вы хотите отправить индивидуальные запросы, попросить о недостающих критически важных функциях или поделиться любыми мыслями, [пожалуйста, свяжитесь с нами в нашем Discord-сообществе](https://discord.gg/MmJf8fWjnt).
[^1]: замените на свой email
[^2]: используйте letsencrypt-prod для продакшна
[^3]: запись DNS из предыдущего шага
[^4]: выберите собственное имя администратора
[^5]: выберите надежный пароль для администратора