` 如下：
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" %}
一旦就绪，部署会被分配一个 URL（ `letsencrypt-prod` 用于你的生产集群 `privateKeySecretRef`.
{% endhint %}
☑️ 创建一个 **集群签发器** 在命令行中：
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens：在自定义资源部分验证安装 / `cert-manager.io` - 已创建集群签发器。
☑️ 安装 **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 以备后用。您的 **用于该 DNS 记录的外部 IP** 可以在 Lens 的 Services / `ingress-nginx-controller 下找到。` .
☑️ 使用 DNSchecker 执行查找以验证您的 DNS 是否正确设置 [使用 DNSchecker](https://dnschecker.org/ns-lookup.php).
☑️ 创建名为 `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>
{% hint style="danger" %}
**将上面 \ 替换为您自己的值** 在上述文件中。
{% endhint %}
☑️ 部署 Nakama helm chart：
```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` 应处于运行状态。
✅ **使用来自** 文件的 URL 和凭据连接到您的 Nakama 控制台。 `values.yaml 的文件` 文件。
🙌 恭喜，您已完成自托管 Nakama 游戏后端的设置！
### 服务更新
按照以下步骤更新托管在托管集群中的服务：
☑️ 更新您的 `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
```
☑️ 通过关闭已更新的 pod 来重新加载更改，这将导致在我们自动重启 pod 后使用新的 helm chart。
{% hint style="warning" %}
此 **该更新将导致短暂停机** 在 Pods 重启期间。
{% endhint %}
🙌 恭喜，您已完成 Nakama 集群更新！
## 👷 高级匹配器
{% hint style="success" %}
参见 [托管集群](/zh/learn/advanced-features/managed-clusters.md#getting-started) 在受管集群上设置您的服务之前。
{% endhint %}
按照以下步骤在托管集群上托管您的 [OpenMatch](https://open-match.dev/site/) ：
☑️ 安装一个 **证书管理器** 以支持游戏客户端使用 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` 应处于运行状态。
☑️ 编写一个 **集群签发器** 文件，记得替换 `` 如下：
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" %}
一旦就绪，部署会被分配一个 URL（ `letsencrypt-prod` 用于你的生产集群 `privateKeySecretRef`.
{% endhint %}
☑️ 创建一个 **集群签发器** 在命令行中：
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens：在自定义资源部分验证安装 / `cert-manager.io` - 已创建集群签发器。
☑️ 安装 **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 以备后用。您的 **用于该 DNS 记录的外部 IP** 可以在 Lens 的 Services / `ingress-nginx-controller 下找到。` .
☑️ 使用 DNSchecker 执行查找以验证您的 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: # 例如： 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
```
🙌 恭喜，您已完成高级匹配器设置！
### 服务更新
按照以下步骤更新托管在托管集群中的服务：
☑️ 更新您的 `value.yaml` 文件以包含新文件。
☑️ 使用以下命令更新您的 helm chart：
```bash
helm upgrade --reuse-values \
--namespace matchmaker -f /values.yaml \
--version 1.0.1 edgegap-public/open-match-edgegap
```
☑️ 通过关闭已更新的 pod（director、mmf、frontend）来重新加载更改，这将导致在我们自动重启 pod 后使用新的 helm chart。
{% hint style="warning" %}
此 **该更新将导致短暂停机** 在 Pods 重启期间。
{% endhint %}
🙌 恭喜，您已完成高级匹配器更新！
### 持续部署
通过将此 shell 脚本添加到您的部署管道来自动化更新您的服务：
```bash
#!/bin/bash
RELEASE_NAME=""
NAMESPACE="matchmaker" # 如果您更改了命名空间，请更改此项。
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），停止这些 pod
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "正在停止部署的 pod：$deployment"
replicas[$deployment]=$(kubectl get deployment $deployment -o=jsonpath='{.spec.replicas}' --namespace $NAMESPACE)
kubectl scale deployment/$deployment --replicas=0 --namespace $NAMESPACE
done
# 等待直到 pod 被终止
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "正在等待部署的 pod 被终止：$deployment"
kubectl wait --for=delete pod -l app=$deployment --timeout=60s --namespace $NAMESPACE
# 检查 wait 命令是否成功。如果不成功，则退出脚本
if [ $? -ne 0 ]; then
echo "等待部署的 pod 被终止失败：$deployment"
exit 1
fi
done
# 清理 redis 数据库
echo "正在清理 redis 数据库"
redis-cli -h $REDIS_HOST flushall
# 对于每个部署（director、mmf、custom-frontend），将 pod 缩放回原始数量
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "正在将部署的 pod 缩放到 ${replicas[$deployment]}：$deployment"
kubectl scale deployment/$deployment --replicas=${replicas[$deployment]} --namespace $NAMESPACE
done
```
{% hint style="warning" %}
此 **该更新将导致短暂停机** 在 Pods 重启期间。
{% endhint %}
### Letsencrypt 证书验证（C#）
对于某些客户端，推荐的 Letsencrypt 证书验证可能会失败并出现错误：
```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" %}
更改集群规模需要停止您的集群。参见 [蓝/绿部署](https://circleci.com/blog/canary-vs-blue-green-downtime/) 以实现零停机更新。
{% endhint %}
### 支持与未来更新
**您的成功是我们的优先事项。** 如果您想发送自定义请求、要求缺失的关键功能，或表达任何想法， [请在我们的社区 Discord 中联系](https://discord.gg/MmJf8fWjnt).
[^1]: 替换为你的电子邮件
[^2]: 生产环境请使用 letsencrypt-prod
[^3]: 来自上一步的 DNS 记录
[^4]: 选择您自己的管理员用户名
[^5]: 为管理员选择一个安全密码