` ci-dessous :
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" %}
Utilisez `letsencrypt-prod` pour votre cluster de production `privateKeySecretRef`.
{% endhint %}
☑️ Créez un **Cluster Issuer** en ligne de commande :
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens : vérifier l'installation dans la section Custom Resources / `cert-manager.io` - cluster issuer créé.
☑️ Installer le **Ingress nginx** pour recevoir les requêtes des clients et les transmettre aux services du cluster :
```
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 : vérifier l'installation dans la section Services / Réseau, `nginx` devrait être en cours d'exécution.
☑️ Créez un **enregistrement DNS de type A** chez votre fournisseur DNS (par ex. [Cloudflare](https://developers.cloudflare.com/dns/get-started/)), notez l’URL pour plus tard. Votre **adresse IP externe pour l’enregistrement DNS** se trouve dans Lens sous Services / `ingress-nginx-controller` .
☑️ Vérifiez que votre DNS est correctement configuré en effectuant une recherche [à l’aide de DNSchecker](https://dnschecker.org/ns-lookup.php).
☑️ Créez un fichier nommé `values.yaml` avec le contenu suivant (utilisez vos propres valeurs) :
isProductionEnvironment: true
# Le nom d’hôte externe du serveur Nakama - enregistrement DNS de l’étape précédente
externalHostName: <DNS_A_RECORD_URL>
nakama:
# La version de Nakama à déployer.
# Voir https://hub.docker.com/r/heroiclabs/nakama/tags pour les versions disponibles.
version: 3.26.0
# Nom d’utilisateur et mot de passe pour la console Nakama
username: <USERNAME>
password: <PASSWORD>
{% hint style="danger" %}
**Remplacez les \ ci-dessus par vos propres valeurs** dans le fichier ci-dessus.
{% endhint %}
☑️ Déployez le chart Helm 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 : vérifiez l’installation dans la section Workloads / Deployments, `nakama` doit être en cours d’exécution.
✅ **Connectez-vous à votre console Nakama** avec l’URL et les identifiants du `values.yaml` fichier.
🙌 Félicitations, vous avez terminé la configuration du backend de jeu Nakama auto-hébergé !
### Mises à jour du service
Suivez ces étapes pour mettre à jour votre service hébergé dans le Managed Cluster :
☑️ Mettez à jour votre `value.yaml` fichier avec de nouveaux fichiers.
☑️ Mettez à jour votre chart Helm avec cette commande :
```bash
helm upgrade --reuse-values \\
--namespace nakama -f /values.yaml \\
--version 1.0.0 oci://registry-1.docker.io/edgegap/heroiclabs-nakama
```
☑️ Rechargez vos modifications en fermant les pods mis à jour, ce qui fera utiliser le nouveau chart Helm après le redémarrage automatique des pods.
{% hint style="warning" %}
Ceci **cette mise à jour provoquera un court temps d'arrêt** pendant que les pods redémarrent.
{% endhint %}
🙌 Félicitations, vous avez terminé la mise à jour du cluster Nakama !
## 👷 Matchmaker avancé
{% hint style="success" %}
Voir [Managed Clusters](/fr/learn/advanced-features/managed-clusters.md#getting-started) avant de configurer vos services sur les clusters gérés.
{% endhint %}
Suivez ces étapes pour héberger votre [OpenMatch](https://open-match.dev/site/) sur un Managed Cluster.
☑️ Installer un **Gestionnaire de certificats** pour prendre en charge l'utilisation des requêtes HTTPS depuis les clients de jeu :
```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 : vérifier l'installation dans la section Services / Réseau, `cert-manager` devrait être en cours d'exécution.
☑️ Écrire un **Cluster Issuer** fichier, pensez à remplacer `` ci-dessous :
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" %}
Utilisez `letsencrypt-prod` pour votre cluster de production `privateKeySecretRef`.
{% endhint %}
☑️ Créez un **Cluster Issuer** en ligne de commande :
```bash
kubectl create -f /issuer.yaml
```
☑️ Lens : vérifier l'installation dans la section Custom Resources / `cert-manager.io` - cluster issuer créé.
☑️ Installer le **Ingress nginx** pour recevoir les requêtes des clients et les transmettre aux services du cluster :
```
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 : vérifier l'installation dans la section Services / Réseau, `nginx` devrait être en cours d'exécution.
☑️ Créez un enregistrement DNS de type A chez votre fournisseur DNS (par ex. [Cloudflare](https://developers.cloudflare.com/dns/get-started/)), notez l’URL pour plus tard. Votre **adresse IP externe pour l’enregistrement DNS** se trouve dans Lens sous Services / `ingress-nginx-controller` .
☑️ Vérifiez que votre DNS est correctement configuré en effectuant une recherche [à l’aide de DNSchecker](https://dnschecker.org/ns-lookup.php).
☑️ Créez un fichier nommé `values.yaml` avec le contenu suivant (utilisez vos propres valeurs) :
```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"
}
# Configurations globales visibles par tous les sous-charts
global:
kubernetes:
resources:
requests:
memory: 100Mi
cpu: 100m
limits:
memory: 100Mi
cpu: 100m
```
{% hint style="danger" %}
**Remplacez les \ ci-dessus par vos propres valeurs** dans le fichier ci-dessus.
{% endhint %}
☑️ Ajoutez **le dépôt Edgegap** à votre liste de dépôts :
```bash
helm repo add edgegap-public https://registry.edgegap.com/chartrepo/edgegap-public
```
☑️ Déployez le chart Helm du matchmaker avancé :
```bash
helm upgrade --install \\
--namespace matchmaker --create-namespace -f /values.yaml \\
--version 1.0.1 edgegap-public/open-match-edgegap
```
🙌 Félicitations, vous avez terminé la configuration du matchmaker avancé !
### Mises à jour du service
Suivez ces étapes pour mettre à jour votre service hébergé dans le Managed Cluster :
☑️ Mettez à jour votre `value.yaml` fichier avec de nouveaux fichiers.
☑️ Mettez à jour votre chart Helm avec cette commande :
```bash
helm upgrade --reuse-values \\
--namespace matchmaker -f /values.yaml \\
--version 1.0.1 edgegap-public/open-match-edgegap
```
☑️ Rechargez vos modifications en fermant les pods mis à jour (director, mmf, frontend), ce qui fera utiliser le nouveau chart Helm après le redémarrage automatique des pods.
{% hint style="warning" %}
Ceci **cette mise à jour provoquera un court temps d'arrêt** pendant que les pods redémarrent.
{% endhint %}
🙌 Félicitations, vous avez terminé la mise à jour du matchmaker avancé !
### Déploiement continu
Automatisez la mise à jour de vos services en ajoutant ce script shell à votre pipeline de déploiement :
```bash
#!/bin/bash
RELEASE_NAME=""
NAMESPACE="matchmaker" # Modifiez ceci si vous avez changé l’espace de noms.
helm upgrade --reuse-values -f /value.yaml --namespace $NAMESPACE --version 1.0.1 $RELEASE_NAME edgegap-public/open-match-edgegap
echo "Installation de 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
# Pour chaque déploiement (director, mmf, custom-frontend) arrêter les pods
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "Arrêt des pods pour le déploiement : $deployment"
replicas[$deployment]=$(kubectl get deployment $deployment -o=jsonpath='{.spec.replicas}' --namespace $NAMESPACE)
kubectl scale deployment/$deployment --replicas=0 --namespace $NAMESPACE
done
# Attendre que les pods soient terminés
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "En attente de la terminaison des pods pour le déploiement : $deployment"
kubectl wait --for=delete pod -l app=$deployment --timeout=60s --namespace $NAMESPACE
# Vérifier si la commande d’attente a réussi. Sinon, quitter le script
if [ $? -ne 0 ]; then
echo "Échec de l’attente de la terminaison des pods pour le déploiement : $deployment"
exit 1
fi
done
# Nettoyage de la base de données Redis
echo "Nettoyage de la base de données Redis"
redis-cli -h $REDIS_HOST flushall
# Pour chaque déploiement (director, mmf, custom-frontend) réajuster les pods à leur nombre d’origine
for deployment in $DIRECTOR_DEPLOYMENT_NAME $MMF_DEPLOYMENT_NAME $CUSTOM_FRONTEND_DEPLOYMENT_NAME
do
echo "Réajustement des pods à ${replicas[$deployment]} pour le déploiement : $deployment"
kubectl scale deployment/$deployment --replicas=${replicas[$deployment]} --namespace $NAMESPACE
done
```
{% hint style="warning" %}
Ceci **cette mise à jour provoquera un court temps d'arrêt** pendant que les pods redémarrent.
{% endhint %}
### Validation du certificat Let's Encrypt (C#)
Pour certains clients, la validation de certificat Let's Encrypt recommandée peut échouer avec l’erreur suivante :
```bash
Erreur Curl 60 : échec de la vérification du certificat. Le certificat a expiré. Code d’erreur UnityTls : 7
```
{% hint style="success" %}
La mise à jour de votre système d’exploitation peut résoudre les problèmes liés à une autorité de certification racine obsolète.
{% endhint %}
En dernier recours, les clients de jeu peuvent implémenter une fonction de gestion de certificat personnalisée :
````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;
}
}
}
```
````
Utilisation :
```csharp
UnityWebRequest request = UnityWebRequest.Get(...);
request.certificateHandler = new BypassCertificateHandler();
request.SendWebRequest();
request.certificateHandler.Dispose();
```
Nous vous recommandons de stocker la valeur `EXPECTED_CERT` dans votre propre stockage de fichiers, puis de la récupérer au moment de l’exécution, afin de pouvoir la mettre à jour sans publier de mise à jour du client de jeu.
## 🟢 Opérations et observabilité
### Changements de niveau de cluster
Préparez-vous au succès et optimisez après le lancement afin de ne pas bloquer vos joueurs le jour de la sortie.
{% hint style="warning" %}
Changer la taille du cluster nécessite d’arrêter votre cluster. Voir [déploiement bleu/vert](https://circleci.com/blog/canary-vs-blue-green-downtime/) pour des mises à jour sans interruption.
{% endhint %}
### Support et futures mises à jour
**Votre réussite est notre priorité.** Si vous souhaitez envoyer des demandes personnalisées, demander des fonctionnalités critiques manquantes, ou partager vos remarques, [veuillez nous contacter sur notre Discord communautaire](https://discord.gg/MmJf8fWjnt).
[^1]: remplacez par votre email
[^2]: utilisez letsencrypt-prod pour la production
[^3]: enregistrement DNS de l’étape précédente
[^4]: choisissez votre propre nom d’utilisateur administrateur
[^5]: choisissez un mot de passe sécurisé pour l’administrateur