brainCloud prend en charge une fonctionnalité de déploiement permettant de transférer (ou de copier ) automatiquement la configuration d'une application source vers une application cible au sein du même cluster de serveurs brainCloud. Cette fonctionnalité est couramment utilisée pour transférer des applications depuis les instances de Développement -> Test -> Contrôle qualité -> Production.
Cependant, la fonctionnalité de déploiement ne permet pas de copier une application entre plusieurs clusters. Si le titulaire de licence possède plusieurs clusters, une procédure plus manuelle doit être utilisée.
Ce document décrit les procédures de création d’une copie d’une application dans un cluster distinct.
---
Aperçu du processus
Le processus est le suivant :
Étape 1 - Créer une nouvelle application cible dans le cluster cible
Étape 2 - Exporter la configuration de l'application source à partir du cluster source
Étape 3 - Importer les données de configuration dans l'application cible
Étape 4 - Personnalisez toutes les propriétés propres à cette instance d'application
Étape 5 – Mettre à jour la configuration du client du jeu et reconstruire
Une fois la copie initiale de l'application créée, elle peut être mise à jour à nouveau à l'avenir en répétant les étapes 2 et 3.
---
Étape 1 – Créer une nouvelle application dans le cluster cible
Tout d'abord, vous devez créer une nouvelle application dans le cluster cible. Pour cela :
Connectez-vous au portail de conception du cluster cible
Choisissez une équipe
Créer une application
La configuration de cette application sera écrasée par l'importation.
Remarque : si l’application source possède des relations parent/enfant et/ou des services homologues, ceux-ci doivent être configurés avant l’importation à l’étape 3.
---
Étape 2 - Exporter la configuration de l'application source à partir du cluster source
Nous utiliserons les écrans d'administration pour exporter la configuration :
Connectez-vous au portail de conception du cluster source.
Choisissez une équipe et accédez à l'application source
Choisir Conception > Outils d'administration
Exportez les métadonnées de l'application vers un fichier. Sélectionnez "Données de configuration", puis "Exporter".
Notez que les métadonnées exportées ci-dessus incluront des entités personnalisées non détenues et migrables.
Exportez les anciens fichiers de l'application. Choisissez "Transfert de fichiers hérités", puis "Exporter".
Si votre application utilise le nouveau service Fichiers globaux V3 , vous devez créer une archive d'exportation à partir de l'écran Conception > Fichiers > Fichiers globaux :
Pour exporter des entités globales, accédez à l'écran "Global > Data Global > Entités globales". Et sous "Actions Diverses", exportez les entités au format JSON RAW .
---
Étape 3 - Importer les données de configuration dans l'application cible
De même, nous utiliserons les écrans d’administration pour importer la configuration :
Connectez-vous au portail de conception du cluster cible.
Choisissez une équipe et accédez à l’application cible
Choisir Conception > Outils d'administration
Importez les métadonnées de l'application. Sélectionnez "Données de configuration", puis "Importer".
Remarque : la première fois que vous importez la configuration, vous souhaiterez probablement désactiver toutes les protections pour obtenir toutes les parties de la configuration.
Lors des importations ultérieures, vous conserverez probablement les paramètres par défaut. Cela permet à l'application d'avoir des paramètres d'intégration personnalisés pour cette instance.
Importez les fichiers hérités de l'application. Sélectionnez "Transfert de fichiers hérités", puis "Importer".
Si votre application utilise le nouveau service V3 Global Files, vous devez importer l'archive via l'écran Conception > Fichiers > Fichiers globaux :
Pour importer des entités globales, accédez à l'écran "Global > Data Global > Entités globales". Et sous "Actions Diverses", importez les entités au format JSON RAW.
---
Étape 4 - Personnalisez toutes les propriétés propres à cette instance d'application
Il existe des cas d'utilisation où il est judicieux de personnaliser les propriétés des configurations d'applications individuelles, en séparant le développement du contrôle qualité, etc.
Les données qui peuvent nécessiter une personnalisation incluent :
Paramètres d'intégration
Propriétés mondiales
etc.
---
Étape 5 – Mettre à jour le client du jeu
Enfin, vous devez mettre à jour le client du jeu avec les informations appropriées pour l'application cible :
appId
- le champ ID de l'app de l'écran Conception > Info de base de l'app > IDs de l'applicationsecretKey
- le champ Clé secrète de l'app de l'écran Conception > Info de base de l'app > IDs de l'applicationserverURL
- l'URL des serveurs API du cluster. On la trouve généralement en remplaçant "portail" par "api" dans l'URL du portail.