FR
Documentation de la plateforme

Commencer

Configurez votre compte, montez l’application Magento et suivez les modifications apportées aux tests bêta via un Déploiement sécurisé en production.

Préparation du compte

Avant votre première mise en œuvre

Avant d’exécuter votre premier déploiement, vous devez effectuer quelques étapes de configuration initiale.

Le premier groupe de tâches est lié à la sécurité de votre compte. Ouvrez la page Paramètres en cliquant sur l’icône d’engrenage dans le coin supérieur droit de l’écran et procédez comme suit :

  • Vérifiez votre numéro de téléphone
  • Vérifiez votre adresse e-mail
  • Configurer l’authentification à deux facteurs (2FA)

L’étape suivante est facultative et n’est nécessaire que si vous envisagez de déployer des packages Composer ou Git privés. Si vous le faites, vous devez ajouter les clés requises sur la page Paramètres. Une fois que vous les enregistrez, nous les stockons dans un endroit sûr. sauter. Pour des raisons de sécurité, vous ne pourrez plus voir les clés, mais elles resteront stockées en toute sécurité et disponible pour la plateforme uniquement sur un réseau privé.

Choisissez ensuite plan d’abonnement qui correspond à vos besoins sur la page Paramètres.

Après avoir terminé ces étapes, notre équipe provisionnera vos comptes dédiés AWS, ce qui prend généralement 3 à 5 jours ouvrés. Une fois ce processus terminé, vous verrez l’élément de menu « Pipeline » apparaître dans l’interface utilisateur.

À ce stade, vous serez prêt à déployer votre première application Magento. ouvrez votre Page des pipelines, ajoutez les packages que vous souhaitez déployer, puis cliquez sur “Déployer”.

Abonnements

Pour commencer à utiliser notre plateforme, vous devez souscrire à l’un de nos forfaits. Vous pouvez choisir entre trois forfaits :

BASIQUE

Un point de départ pratique pour les petites équipes et les startups.

Prime

Des limites de ressources plus élevées avec un niveau de soutien plus élevé de la part de notre équipe.

Entreprise

Configuration personnalisée, fonctionnalités supplémentaires et assistance 24h/24 et 7j/7 pour les grandes organisations.

Pour vous abonner, cliquez simplement sur le bouton « S’abonner » sur la page Paramètres.

pipeline

La page Pipeline est la vue principale de notre plateforme. Affiche tous les déploiements et leurs statuts, l’historique des tests, journaux et liens directs vers les tableaux de bord CloudWatch avec des métriques. Vous pouvez revenir à une version précédente au cas où de tout problème. Vous pouvez également activer la promotion automatique entre les étapes pour obtenir un CI/CD complet, ou la désactiver et Gérez les promotions manuellement. Chaque changement d’implémentation a son propre identifiant unique et nous utilisons différentes couleurs pour créer Il est facile d’identifier les derniers changements et de voir à quel stade ils en sont actuellement.

Chaque carte de déploiement affiche son ID de modification et son ID de build, son état actuel, le résultat de la compatibilité ascendante et le démarrage. et les temps d’achèvement, les messages et les référentiels inclus dans cette version. Développez les panneaux Magento et Testing pour actions spécifiques à l’environnement ou sélectionnez Afficher dans les journaux pour inspecter le résultat de cette étape.

Forfaits

Notre processus commence par l’ajout de packages. Vous pouvez ajouter des packages depuis les référentiels Composer ou Git, avec un package qui est normalement Magento 2 CE lui-même. Vous pouvez ajouter autant de packages que nécessaire. Si vous utilisez packages privés, vous devez fournir les informations d’identification nécessaires sur la page Paramètres.

Utilisez le bouton Modifier à côté d’un référentiel pour modifier sa source Git ou Composer, sélectionner une version facultative ou désignez-le comme package principal. Un référentiel peut également être marqué comme sujet. Les types de thèmes pris en charge incluent Less, Sass et PWA, permettant au processus de déploiement de gérer chaque package d’interface de manière appropriée.

Bêta

Une fois que vos modifications atteignent le stade bêta, vous pouvez configurer des tests automatisés pour votre application. Vous pouvez activer API, interface utilisateur et tests de performances, et vous pouvez activer ou désactiver chacun d’eux à tout moment.

La carte de déploiement bêta affiche également l’état du déploiement en direct, la compatibilité, le calendrier, les messages, les référentiels, Liens et actions Magento, et nombre de tests configurés. Utilisez le bouton d’engrenage pour définir un test individuel et le bouton de lecture pour l’exécuter à la demande.

Chaque type de test possède ses propres options de configuration :


  • Tests API et UI
    • Suite de tests
    • Filtre de test
    • réapprovisionnement maximum
  • Tests de performances
    • Profil d’appareil
    • Taux de réussite du cache cible
    • Nombre d’utilisateurs de l’interface
    • Nombre d’utilisateurs administrateurs
    • Nombre de boucles pour exécuter tous les tests activés
    • réapprovisionnement maximum

Lorsque vous êtes satisfait des résultats en version bêta, vous pouvez promouvoir vos modifications en production ou activer la fonctionnalité automatique. promotion afin que le processus soit entièrement piloté par CI/CD.

Promotion

La promotion fait passer une modification testée avec succès de la version bêta à la production. Vous pouvez promouvoir un changement manuellement lorsque vous êtes prêt, ou activez la promotion automatique afin que le processus se poursuive une fois tous les tests requis réussis. Avant la promotion, examinez l’état du déploiement et les résultats des tests pour vous assurer que vous déplacez la cible prévue. changement.

Les contrôles entre les étapes incluent les boutons de retour et le déploiement forcé. La restauration renvoie le trafic vers le mise en œuvre précédente lorsque cette action est disponible. Le déploiement forcé permet de poursuivre un déploiement manuellement ; Utilisez-le avec précaution, car il peut empêcher la progression automatisée normale du pipeline.

Production

Le déploiement de la production est la dernière étape du processus CI/CD. Peut être activé automatiquement après la version bêta ils réussissent les tests. Les déploiements s’effectuent sans temps d’arrêt et vous pouvez revenir à la version précédente dans en cas de problème. Le déploiement est divisé en deux phases :

  • Déploiement des services : RDS, OpenSearch, ElastiCache, MQ, SES. Vous n’avez pas besoin de vous inquiéter Cette étape : il s’agit principalement de mettre à jour la configuration du cluster, d’activer des fonctionnalités supplémentaires et mise à niveau vers des versions plus récentes et plus sécurisées des services sous-jacents.
  • Implémentation du cluster ECS : c’est ici que le code de l’application est remplacé sans temps d’arrêt pour les modifications rétrocompatibles. Lors de cette étape, Admin pour Magento est placé en mode maintenance, tandis que La vitrine reste pleinement opérationnelle.

Pendant le déploiement de la production, la carte affiche un état d’exécution et la durée écoulée. L’arrêt et L’action de restauration du déploiement est disponible pour les déploiements en cours pris en charge. Après avoir terminé, vérifiez versions du référentiel déployées, statut de Magento, liens de vitrine et journaux avant d’envisager la publication complet.

Application Magento

Le bloc Magento fournit un accès rapide aux liens, informations d’identification et actions spécifiques à l’application pour le environnement sélectionné. Comprend l’URL de vitrine pour Magento, l’URL PWA, l’administrateur pour l’URL pour Magento et l’administrateur. informations d’identification. Vous pouvez également utiliser ce bloc pour appliquer un thème, générer des fichiers statiques Magento et effacer le Cache de l’application après des modifications de configuration ou de vitrine.

Les balises d’état indiquent si les opérations Magento, de construction statique et de cache sont actives ou en cours. Sélectionnez un thème configuré et cliquez sur Appliquer pour l’activer. Utilisez Régénérer après des modifications de thème ou d’interface. et Effacer lorsque Magento diffuse du contenu en cache obsolète. Certaines actions restent indisponibles tandis que d’autres Le déploiement ou l’opération Magento est en cours d’exécution.

Comment ajouter un thème personnalisé

L’ajout du package rend le thème disponible pour le déploiement, mais Magento doit également l’attribuer au vue du magasin prévue avant que le pipeline ne l’applique à l’environnement.

  1. 1

    Ajouter le pack thématique

    Ajoutez le référentiel Git ou Composer à la page Pipeline, marquez-le comme thème et sélectionnez le type de thème approprié.

  2. 2

    Déployer le package

    Déployez la modification à l'étape où vous souhaitez configurer et vérifier le thème, puis attendez que le déploiement se termine avec succès.

  3. 3

    Ouvrir l'administrateur pour Magento

    Développez le bloc Magento pour cette étape et utilisez l'URL et les informations d'identification de l'administrateur pour vous connecter à l'administrateur pour Magento.

  4. 4

    Attribuez le thème à la vue du magasin.

    Dans Admin pour Magento, ouvrez Contenu > Conception > Paramètres, modifiez la vue de magasin requise, sélectionnez le thème personnalisé et enregistrez les paramètres.

  5. 5

    Appliquez le thème du pipeline.

    Revenez à la page Pipeline, choisissez le thème dans le bloc Magento et cliquez sur Appliquer.

  6. 6

    Attends que ça finisse

    Gardez la page ouverte pendant que l'opération de thème est en cours d'exécution. Lorsque votre statut est terminé avec succès, ouvrez la vitrine et vérifiez la vue du magasin sélectionné.

Répétez l’affectation d’administrateur Magento pour chaque vue de magasin qui doit utiliser le thème personnalisé. Testez le résultat sur Bêta avant de promouvoir le passage à la production.

Processus de changement d’URL pour Magento

Utilisez les contrôles d’URL pour Magento lorsque vous souhaitez que l’environnement soit réactif sur un domaine personnalisé. Entrez la nouvelle URL, Confirmez le changement et suivez les instructions de domaine et de certificat affichées. Modifications du DNS et du certificat La disponibilité peut prendre un certain temps, alors attendez la fin du processus avant d’essayer la nouvelle adresse.

  1. Enregistrez la nouvelle URL pour Magento personnalisé sans inclure le protocole.
  2. Déployez ou mettez à jour le certificat ACM CloudFront créé pour le domaine.
  3. Ajoutez l’enregistrement CNAME de validation ACM affiché à votre fournisseur DNS, attendez qu’il soit résolu et exécutez Verify. validation. Utilisez les valeurs exactes d’hôte et de destination affichées dans la boîte de dialogue.
  4. Déployez le CDN, puis pointez le domaine vers le nom d’hôte CloudFront affiché. Utiliser un enregistrement ALIAS pour une racine domaine lorsqu’il est pris en charge, ou un enregistrement CNAME pour un sous-domaine.
  5. Modifiez l’URL de base pour Magento une fois que les étapes du certificat et du CDN ont signalé le succès.

Ne résolvez pas un nom d’hôte CloudFront en vos adresses IP actuelles et créez des enregistrements A ou AAAA fixes à partir de celles-ci. valeurs, car les adresses CloudFront peuvent changer. La propagation DNS peut également différer entre l’autorité et des résolveurs publics, afin que le contrôle de validation autorisé puisse réussir avant que l’enregistrement n’apparaisse partout.

L’exemple suivant montre l’enregistrement de routage CNAME de validation et CloudFront configurés sur Namecheap. autre Les fournisseurs DNS utilisent des étiquettes différentes, mais les types d’enregistrement, les noms d’hôte et les valeurs cibles suivent le même processus.

Enregistrements

La section Journaux vous aide à enquêter sur les builds, les déploiements, les tests et les problèmes d’application. Sélectionnez le pertinent pipeline d’exécution ou environnement pour voir sa sortie, puis utilisez les horodatages et les messages d’état pour identifier où l’échec s’est produit. Il peut y avoir des liens vers les journaux CloudWatch associés pour un dépannage plus détaillé.

Les journaux incluent des horodatages et des identifiants, tels que des ID de déploiement, qui permettent de corréler un événement à votre pipeline. carte et déploiement AWS. Utilisez Actualiser pour charger une sortie plus récente pendant l’exécution d’un travail et Copier pour capturer le journal de rechercher, partager ou joindre à une demande d’assistance. Lors du dépannage, commencez près de la première erreur explicite plutôt que le message final de défaillance du pipeline, qui n’est souvent qu’un résumé d’un problème antérieur.