` 를 교체하는 것을 잊지 마세요:
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 %}
☑️ 생성: **클러스터 발급자** 명령줄에서:
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens: Custom Resources 섹션에서 설치 확인 / `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는 DNS 레코드용** Lens의 Services / `ingress-nginx-controller` .
☑️ DNS 조회를 수행하여 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 게임 백엔드 설정을 완료했습니다!
### 서비스 업데이트
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
```
☑️ 업데이트된 pod를 종료하여 변경 사항을 다시 로드하세요. 그러면 pod가 자동으로 재시작된 후 새 helm chart가 사용됩니다.
{% hint style="warning" %}
이것 **이번 업데이트로 짧은 다운타임이 발생합니다** 파드가 재시작하는 동안입니다.
{% endhint %}
🙌 축하합니다, Nakama Cluster 업데이트를 완료했습니다!
## 👷 고급 매치메이커
{% hint style="success" %}
보기 [Managed Clusters](/ko/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" %}
)과 각 내부 포트에 대한 외부 포트가 할당됩니다. `letsencrypt-prod` 운영 클러스터용 `privateKeySecretRef`.
{% endhint %}
☑️ 생성: **클러스터 발급자** 명령줄에서:
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens: Custom Resources 섹션에서 설치 확인 / `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 공급자에서 DNS 레코드 유형 A를 생성하세요(예: [Cloudflare](https://developers.cloudflare.com/dns/get-started/)), URL을 나중을 위해 메모해 두세요. DNS 레코드의 **외부 IP는 DNS 레코드용** Lens의 Services / `ingress-nginx-controller` .
☑️ DNS 조회를 수행하여 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
```
🙌 축하합니다, 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
```
☑️ 업데이트된 pod(director, mmf, frontend)를 종료하여 변경 사항을 다시 로드하세요. 그러면 pod가 자동으로 재시작된 후 새 helm chart가 사용됩니다.
{% hint style="warning" %}
이것 **이번 업데이트로 짧은 다운타임이 발생합니다** 파드가 재시작하는 동안입니다.
{% endhint %}
🙌 축하합니다, Advanced Matchmaker 업데이트를 완료했습니다!
### 지속적 배포
다음 셸 스크립트를 배포 파이프라인에 추가하여 서비스 업데이트를 자동화하세요:
```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" %}
이것 **이번 업데이트로 짧은 다운타임이 발생합니다** 파드가 재시작하는 동안입니다.
{% 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 %}
### 지원 및 향후 업데이트
**고객님의 성공이 저희의 최우선입니다.** 맞춤 요청을 보내고 싶거나, 중요한 기능이 빠져 있다고 생각되거나, 의견이 있다면 [커뮤니티 디스코드로 연락해 주세요](https://discord.gg/MmJf8fWjnt).
[^1]: 귀하의 이메일로 교체
[^2]: 운영 환경에서는 letsencrypt-prod 사용
[^3]: 이전 단계의 DNS 레코드
[^4]: 관리자 사용자 이름을 직접 선택하세요
[^5]: 관리자용으로 안전한 비밀번호를 선택하세요