Workflow du projet de démarrage

Adobe Commerce sur l’infrastructure cloud comprend un référentiel Git unique avec une branche master pour l’environnement de production qui peut être branché afin de créer un environnement d’évaluation et plusieurs environnements d’intégration pour le travail de test et de développement. Vous pouvez avoir jusqu’à quatre environnements actifs, y compris un environnement master pour votre serveur de production. Voir Architecture de démarrage pour une présentation.

Pour vos environnements, suivez le workflow Development > Staging > Production pour développer et déployer votre site.

Pour vos branches, vous pouvez suivre n’importe quelle méthodologie de développement. Par exemple, vous pouvez suivre une méthodologie Agile telle que le scrum pour créer des branches pour chaque sprint.

À partir de chaque sprint, vous pouvez créer des branches pour chaque article client. Toutes les histoires deviennent vérifiables. Vous pouvez constamment fusionner vers la branche sprint et valider cette branche de manière continue. Lorsque le sprint se termine, vous pouvez fusionner la branche du sprint vers master pour déployer toutes les modifications du sprint en production sans avoir à gérer un goulot d’étranglement de test.

Workflow de développement

Le développement et le déploiement sur les plans de démarrage commencent par votre projet initial. Vous créez votre projet avec le "site vierge", qui est un référentiel de code de modèle d’infrastructure cloud Adobe Commerce avec un magasin entièrement préparé. Cela crée une branche master avec une copie du code de votre environnement de production.

Le workflow de développement comprend les éléments suivants :

Vous avez également quelques étapes facultatives pour vous aider à développer et tester votre code et vos données de magasin :

Ce processus suppose que vous avez configuré votre espace de travail de développeur local.

Clonage et branche

Pour un nouveau projet Starter Plan, une branche master a été clonée à partir d’Adobe Commerce sur le référentiel Git de l’infrastructure cloud. Pour commencer l'embranchement et l'utilisation du code, clonez la branche master dans votre environnement local.

Le format de la commande de clonage Git est le suivant :

git fetch origin

git pull origin <environment-ID>

La première fois que vous commencez à travailler dans des branches pour votre projet de démarrage, créez une branche staging. Cela crée une branche de code correspondant à la branche master qui se déploie dans un environnement d’évaluation pour tester la configuration et les modifications de code avant de se déployer dans l’environnement de production.

Ensuite, créez des branches à partir de staging pour développer du code, ajouter des extensions et configurer des intégrations tierces. Chaque fois que vous développez du code personnalisé, ajoutez des extensions, intégrez à un service tiers, travaillez dans une branche de développement créée à partir de la branche staging. Quatre environnements d’intégration actifs sont disponibles. Lorsque vous poussez une branche active, l’un de ces environnements d’intégration déploie automatiquement votre code à tester.

Le format de la commande de branche Git est le suivant :

git checkout <branch-name>

Le format de la commande de l’interface de ligne de commande branch de Cloud est le suivant :

magento-cloud environment:branch <environment-name> <parent-environment-ID>

Développer le code

En utilisant la branche de base d’Adobe Commerce sur le code d’infrastructure cloud, vous pouvez commencer à installer des extensions, développer du code personnalisé, ajouter des thèmes, etc.

Utilisez une stratégie d’embranchement avec votre travail de développement. L’utilisation d’une branche pour effectuer toutes vos tâches en même temps peut rendre les tests difficiles. Par exemple, vous pouvez suivre les méthodologies d’intégration continue et de sprint pour fonctionner :

Jusqu’à ce que votre magasin soit entièrement créé, configuré et prêt à être lancé. Mais continuez à lire, il existe de nombreuses options pour votre configuration de magasin et de code.

Configurer le magasin

Lorsque vous êtes prêt à configurer votre magasin, envoyez tout votre code vers l’environnement integration. Configurez les paramètres du magasin à partir de l’administrateur pour l’environnement d’intégration, et non dans votre environnement local. Vous pouvez trouver l’URL en cliquant sur Accéder au site dans le Cloud Console

Pour obtenir les meilleures informations sur les configurations, consultez la documentation d’Adobe Commerce et des extensions installées. Voici quelques liens et idées qui vous aident à démarrer :

Au-delà des seuls paramètres de magasin, vous pouvez configurer davantage plusieurs sites et magasins, des services configurés, etc. Voir Configuration de votre boutique.

Génération des fichiers de gestion de configuration

Si vous connaissez Adobe Commerce, vous pouvez vous demander comment obtenir vos paramètres de configuration de votre base de données en développement vers les environnements d’évaluation et de production. Auparavant, vous deviez copier tous vos paramètres de configuration sur papier ou dans un fichier, puis les appliquer manuellement à d’autres environnements. Ou vous avez peut-être vidé votre base de données et transféré ces données vers un autre environnement.

Adobe Commerce sur l’infrastructure cloud fournit un ensemble de deux commandes Configuration Management qui exportent les paramètres de configuration de votre environnement dans un fichier. Ces commandes sont uniquement disponibles pour Adobe Commerce sur l’infrastructure cloud 2.2 et versions ultérieures.

Le fichier généré est app/etc/config.php.

Générez le fichier dans l’environnement d’intégration dans lequel vous avez configuré Adobe Commerce. Suivez le processus de génération du fichier, d’ajout à votre branche et de déploiement.

Remarques importantes sur la gestion de la configuration :

Si vous utilisez Adobe Commerce version 2.2 ou ultérieure, les commandes de gestion de la configuration offrent une fonctionnalité supplémentaire pour protéger les données sensibles, telles que les informations d’identification sandbox pour un module PayPal. Pendant le processus d’exportation, toutes les valeurs contenant des données sensibles sont exportées vers un fichier de configuration distinct—env.php dans le répertoire app/etc/. Ce fichier reste dans votre environnement local et n’est pas copié lorsque vous poussez votre code vers une autre branche. Vous pouvez également créer des variables d’environnement avec des commandes d’interface de ligne de commande dans toutes les versions d’infrastructure cloud d’Adobe Commerce.

Voir Configuration Management.

Code push et test

À ce stade, une branche de code développée avec un fichier de configuration (config.local.php ou config.php) doit être prête à être testée.

Chaque fois que vous poussez du code depuis votre environnement local, une série de scripts de création et de déploiement s’exécute. Ces scripts génèrent un nouveau code et le déploient dans l’environnement distant. Par exemple, si vous poussez une branche de développement de votre environnement local vers la branche distante, un environnement correspondant met à jour les services, le code et le contenu statique.

Vous pouvez accéder directement à cet environnement à l’aide d’une URL de magasin, d’une URL d’administration et d’un SSH. Ces environnements incluent un serveur web, une base de données et des services configurés. Une fois prêt, vous pouvez commencer le déploiement et le test dans l’environnement d’évaluation.

Pour plus d’informations, voir Workflow de déploiement.

Facultatif : installation de données d’exemple

Si vous avez besoin de données d’exemple lors du développement de votre magasin, vous pouvez installer des données d’exemple. Ces données simulent un magasin actif, y compris les clients, les produits et d’autres données. Ces exemples de données fonctionnent mieux avec une Adobe Commerce "site vierge" sur l’installation d’un modèle d’infrastructure cloud lors de la création de votre projet. Il est recommandé de supprimer les exemples de données avant la mise en ligne. Voir Installation des exemples de données facultatifs.

Facultatif : extraction des données de production

Ajoutez tous vos produits, catalogues, contenu du site, etc., directement dans l’environnement production. En ajoutant ces données à l’environnement de production, vous pouvez fournir à vos clients des prix, des coupons, des stocks mis à jour, des annonces de ventes, des informations sur les offres futures, etc. Ces données n’incluent pas les configurations d’extension que vous configurez dans votre branche de développement locale.

Lorsque vous développez des fonctionnalités, ajoutez des extensions et des thèmes de conception, il est utile d’avoir de vraies données à utiliser. À tout moment, vous pouvez créer un vidage de base de données à partir de l’environnement de production et le transmettre à vos environnements d’évaluation et d’intégration selon vos besoins.

Pour aider à exporter des données de production en tant que données de test à utiliser dans les environnements d’évaluation et d’intégration :

Pour migrer ces données, voir Migration et déploiement de fichiers statiques et de données.

Workflow de déploiement

Comme indiqué dans les informations d’architecture, Adobe Commerce sur l’infrastructure cloud est piloté par Git. Le déploiement d’Adobe Commerce sur l’infrastructure cloud fait partie de vos processus push Git pour les branches.

Lorsque vous poussez du code embranché de votre environnement local vers la branche distante, une série de scripts de création et de déploiement commencent.

Création de scripts :

Déployer des scripts :

Une fois l’opération terminée, votre boutique revient en ligne, en ligne, avec l’ensemble du code et des configurations mis à jour.

Voir Processus de déploiement.

Push to Staging and test

Envoyez toujours votre code dans les itérations vers l’environnement staging pour des tests complets. La première fois que vous utilisez cet environnement, vous devez configurer quelques services, dont Fastly et New Relic. En outre, configurez les passerelles de paiement, l’expédition, les notifications et d’autres services essentiels avec sandbox ou testez les informations d’identification.

L’évaluation est un environnement de pré-production qui fournit tous les services et paramètres aussi proches que possible de la production. Testez minutieusement chaque service, vérifiez vos outils de test de performance, effectuez des tests UAT en tant qu’administrateur et en tant que client, jusqu’à ce que votre magasin soit prêt pour la production.

Voir Déployer votre boutique.

Push to Production

Lorsque vous poussez vers la branche master, vous poussez vers l’environnement production. Complétez les activités de configuration et de test dans l’environnement de production comme vous l’avez fait dans l’environnement d’évaluation avec une différence importante. Dans l’environnement de production, utilisez les informations d’identification en direct pour la configuration et le test. Au moment du lancement de votre site, les clients peuvent effectuer des achats et les administrateurs peuvent gérer la boutique en ligne.

Voir Déployer votre boutique.

Lancement du site

Il existe une procédure claire pour passer en ligne avec votre site. Une fois ces étapes terminées, votre boutique peut immédiatement proposer des produits sur votre thème personnalisé à vendre.

Voir Site launch.

Intégration continue

En suivant vos méthodologies d’embranchement et de développement, vous pouvez facilement développer de nouvelles fonctionnalités, configurer des modifications et ajouter des extensions pour développer et déployer en continu des mises à jour.

Tous les environnements d’infrastructure cloud prennent en charge l’intégration continue pour les mises à jour constantes. Ce workflow prend en charge les versions plusieurs fois par jour ou selon un calendrier défini en fonction des besoins de votre entreprise.