` 如下：
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` 应处于运行状态。
☑️ 创建一个 **A 记录类型的 DNS 记录** 在你的 DNS 提供商中（例如 [Cloudflare](https://developers.cloudflare.com/dns/get-started/)），并记下 URL 以便后续使用。你的 **DNS 记录的外部 IP** 可在 Lens 的 Services / 下找到 `ingress-nginx-controller` .
☑️ 通过执行查询来验证你的 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` 应处于运行状态。
✅ **连接到你的 Nakama 控制台** 使用来自以下内容的 URL 和凭据 `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` .
☑️ 通过执行查询来验证你的 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 error 60: Cert verify failed. Certificate has expired. UnityTls error code: 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 %}
### 支持与未来更新
**你的成功是我们的首要任务。** 如果你想提交自定义请求、提出缺失的关键功能，或表达任何想法， [请在我们的 Community Discord 中联系我们](https://discord.gg/MmJf8fWjnt).
[^1]: 替换为你的电子邮件
[^2]: 生产环境请使用 letsencrypt-prod
[^3]: 上一步中的 DNS 记录
[^4]: 选择你自己的管理员用户名
[^5]: 为管理员选择一个安全密码