DE
Plattformdokumentation

Erste Schritte

Konfigurieren Sie Ihr Konto, stellen Sie die Magento-Anwendung zusammen und folgen Sie einer Änderung vom Beta-Testen bis zu einem sichere Production-Bereitstellung.

Kontovorbereitung

Vor Ihrem ersten Einsatz

Bevor Sie Ihre erste Bereitstellung ausführen, müssen Sie einige anfängliche Einrichtungsschritte durchführen.

Die erste Aufgabengruppe bezieht sich auf die Sicherheit Ihres Kontos. Öffnen Sie die Konfigurationsseite, indem Sie auf klicken Klicken Sie auf das Zahnradsymbol in der oberen rechten Ecke des Bildschirms und führen Sie die folgenden Schritte aus:

  • Bestätigen Sie Ihre Telefonnummer
  • Bestätigen Sie Ihre E-Mail-Adresse
  • Zwei-Faktor-Authentifizierung (2FA) einrichten

Der nächste Schritt ist optional und nur erforderlich, wenn Sie private Composer- oder Git-Pakete bereitstellen möchten. Wenn ja, Sie müssen die erforderlichen Schlüssel auf der Konfigurationsseite hinzufügen. Sobald Sie sie gespeichert haben, speichern wir sie an einem sicheren Ort Tresor. Aus Sicherheitsgründen können Sie die Schlüssel nicht erneut einsehen, sie bleiben jedoch sicher aufbewahrt und steht der Plattform nur in einem privaten Netzwerk zur Verfügung.

Wählen Sie als Nächstes a Abonnementplan Wählen Sie auf der Konfigurationsseite die Option aus, die Ihren Anforderungen entspricht.

Nachdem Sie diese Schritte abgeschlossen haben, stellt unser Team Ihre dedizierten AWS-Konten bereit, was normalerweise dauert 3–5 Werktage. Sobald dieser Vorgang abgeschlossen ist, wird der Menüpunkt "Pipeline" im UI angezeigt.

An diesem Punkt sind Sie bereit, Ihre erste Magento-Anwendung bereitzustellen. Öffnen Sie Ihr Pipeline Seite, fügen Sie die Pakete hinzu, die Sie bereitstellen möchten, und klicken Sie auf "Deploy".

Abonnements

Um unsere Plattform nutzen zu können, müssen Sie einen unserer Pläne abonnieren. Sie können zwischen drei Plänen wählen:

Basic

Ein praktischer Einstieg für kleine Teams und Startups.

Premium

Höhere Ressourcengrenzen mit mehr Unterstützung durch unser Team.

Enterprise

Benutzerdefinierte Einrichtung, zusätzliche Funktionen und 24/7-Support für größere Organisationen.

Um sich anzumelden, klicken Sie einfach auf der Konfigurationsseite auf die Schaltfläche "Subscribe".

Pipeline

Die Seite Pipeline ist die Hauptansicht unserer Plattform. Es zeigt alle Bereitstellungen und deren Status, Testverlauf, Protokolle und direkte Links zu CloudWatch-Dashboards mit Metriken. Sie können bei Bedarf auf eine frühere Version zurückgreifen aller Probleme. Sie können auch die automatische Heraufstufung zwischen den Phasen aktivieren, um den vollständigen CI/CD zu erreichen, oder sie deaktivieren Verwalten Sie Werbeaktionen manuell. Jede Bereitstellungsänderung hat ihre eigene eindeutige ID und wir verwenden zur Erstellung unterschiedliche Farben Es ist einfach, die neuesten Änderungen zu erkennen und zu sehen, in welchem Stadium sie sich gerade befinden.

Auf jeder Bereitstellungskarte werden die Änderungs- und Build-ID, der aktuelle Status, das Ergebnis der Abwärtskompatibilität und der Start angezeigt und Endzeiten, Nachrichten und die in diesem Build enthaltenen Repositorys. Erweitern Sie die Bereiche Magento und Tests für umgebungsspezifische Aktionen, oder wählen Sie unter „Protokolle“ die Option „Ansicht“ aus, um die Ausgabe für diese Phase zu überprüfen.

Pakete

Unsere Pipeline beginnt mit dem Hinzufügen von Paketen. Sie können Pakete aus den Repositorys Composer oder Git mit einem Hauptverzeichnis hinzufügen Paket, das normalerweise Magento 2 CE selbst ist. Sie können so viele Pakete hinzufügen, wie Sie benötigen. Wenn Sie verwenden Für private Pakete müssen Sie auf der Konfigurationsseite die erforderlichen Anmeldeinformationen angeben.

Verwenden Sie die Schaltfläche „Bearbeiten“ neben einem Repository, um dessen Quelle Git oder Composer zu ändern, eine optionale Version auszuwählen oder Bezeichnen Sie es als Hauptpaket. Ein Repository kann auch als Theme markiert werden. Zu den unterstützten Thementypen gehören: Less, Sass und PWA, sodass der Bereitstellungsprozess jedes Frontend-Paket angemessen verarbeiten kann.

Beta

Sobald Ihre Änderungen das Stadium Beta erreichen, können Sie automatisierte Tests für Ihre Anwendung einrichten. Sie können aktivieren API, UI und Leistungstests, und Sie können jeden von ihnen jederzeit ein- oder ausschalten.

Die Beta-Bereitstellungskarte zeigt außerdem den Live-Bereitstellungsstatus, die Kompatibilität, das Timing, Nachrichten, Repositorys usw. an. Magento-Links und -Aktionen sowie die Anzahl der konfigurierten Tests. Verwenden Sie die Zahnradtaste, um eine zu konfigurieren Einzeltest und die Play-Taste, um es bei Bedarf auszuführen.

Jeder Testtyp verfügt über eigene Konfigurationsoptionen:


  • API & UI Tests
    • Testsuite
    • Testfilter
    • Max wiederholt sich
  • Leistungstests
    • Vorrichtungsprofil
    • Ziel-Cache-Trefferquote
    • Anzahl der Frontend-Benutzer
    • Anzahl der Admin-Benutzer
    • Anzahl der Schleifen zur Ausführung aller aktivierten Tests
    • Max wiederholt sich

Wenn Sie mit den Ergebnissen in Beta zufrieden sind, können Sie Ihre Änderungen an Production weiterleiten oder die automatische Aktivierung aktivieren Förderung, um den Prozess vollständig CI/CD-gesteuert zu machen.

Förderung

Durch die Aktion wird eine erfolgreich getestete Änderung von Beta nach Production verschoben. Sie können eine Änderung manuell heraufstufen wenn Sie bereit sind, oder aktivieren Sie die automatische Heraufstufung, damit die Pipeline fortgesetzt wird, nachdem alle erforderlichen Tests bestanden wurden. Überprüfen Sie vor der Hochstufung den Bereitstellungsstatus und die Testergebnisse, um sicherzustellen, dass Sie die beabsichtigte Verschiebung durchführen ändern.

Zu den Steuerelementen zwischen den Phasen gehören die Umschalter „Rollback“ und „Force Deployment“. Rollback gibt den Datenverkehr an den zurück vorherige Bereitstellung, wenn diese Aktion verfügbar ist. Durch Force Deployment kann eine Bereitstellung manuell fortgesetzt werden. Verwenden Sie es vorsichtig, da es den normalen automatisierten Fortschritt der Pipeline umgehen kann.

Production

Die Bereitstellung von Production ist der letzte Schritt der CI/CD-Pipeline. Es kann automatisch nach Beta ausgelöst werden Tests bestehen. Bereitstellungen werden ohne Ausfallzeiten durchgeführt und Sie können ein Rollback auf die vorherige Version durchführen bei Problemen. Die Bereitstellung ist in zwei Phasen unterteilt:

  • Bereitstellung der Dienste: RDS, OpenSearch, ElastiCache, MQ, SES. Sie brauchen sich darüber keine Sorgen zu machen In diesem Schritt geht es in erster Linie darum, die Clusterkonfiguration zu aktualisieren, zusätzliche Funktionen zu aktivieren usw Upgrade auf neuere und sicherere Versionen der zugrunde liegenden Dienste.
  • ECS-Clusterbereitstellung: Hier wird der Anwendungscode ohne Ausfallzeiten ersetzt für abwärtskompatible Änderungen. Während dieses Schritts wird Admin für Magento in den Wartungsmodus versetzt Die Storefront bleibt voll funktionsfähig.

Während Production bereitgestellt wird, zeigt die Karte den Betriebsstatus und die verstrichene Dauer an. Der Stopp und Die Rollback-Bereitstellungsaktion ist für unterstützte laufende Bereitstellungen verfügbar. Nach Abschluss überprüfen die bereitgestellten Repository-Versionen, den Magento-Status, Storefront-Links und Protokolle, bevor Sie die Veröffentlichung in Betracht ziehen abgeschlossen.

Anwendung für Magento

Der Anwendungsblock für Magento bietet schnellen Zugriff auf anwendungsspezifische Links, Anmeldeinformationen und Aktionen für ausgewählte Umgebung. Es umfasst die Storefront Magento, URL, PWA URL, Admin für URL für Magento und Admin Anmeldeinformationen. Sie können diesen Block auch verwenden, um ein Design anzuwenden, statische Magento-Dateien zu generieren und das zu löschen Anwendungscache nach Konfigurations- oder Storefront-Änderungen.

Statusbezeichnungen zeigen an, ob Magento-, statische Generierungs- und Cache-Vorgänge aktiv sind oder ausgeführt werden. Wählen Sie ein konfiguriertes Design aus und klicken Sie auf „Übernehmen“, um es zu aktivieren. Verwenden Sie „Nach Theme- oder Frontend-Änderungen neu generieren“, und Löschen, wenn Magento veraltete zwischengespeicherte Inhalte bereitstellt. Einige Aktionen bleiben nicht verfügbar, während andere nicht verfügbar sind Die Bereitstellung oder der Magento-Vorgang wird ausgeführt.

So fügen Sie ein benutzerdefiniertes Design hinzu

Durch das Hinzufügen des Pakets wird das Design für die Bereitstellung verfügbar gemacht, Magento muss es jedoch auch der Bereitstellung zuweisen Die beabsichtigte Speicheransicht wird gespeichert, bevor die Pipeline sie auf die Umgebung anwendet.

  1. 1

    Fügen Sie das Themenpaket hinzu

    Fügen Sie das Repository Git oder Composer auf der Seite Pipeline hinzu, markieren Sie es als Design und wählen Sie den entsprechenden Designtyp aus.

  2. 2

    Stellen Sie das Paket bereit

    Stellen Sie die Änderung in der Phase bereit, in der Sie das Design konfigurieren und überprüfen möchten, und warten Sie dann, bis die Bereitstellung erfolgreich abgeschlossen ist.

  3. 3

    Öffnen Sie Admin für Magento

    Erweitern Sie den Block Magento für diese Phase und verwenden Sie Admin URL und Anmeldeinformationen, um sich bei Admin für Magento anzumelden.

  4. 4

    Weisen Sie das Thema der Store-Ansicht zu

    Öffnen Sie in Admin für Magento Inhalt > Design > Konfiguration, bearbeiten Sie die erforderliche Store-Ansicht, wählen Sie das benutzerdefinierte Design aus und speichern Sie die Konfiguration.

  5. 5

    Wenden Sie das Design aus der Pipeline an

    Kehren Sie zur Seite Pipeline zurück, wählen Sie das Thema im Block Magento aus und klicken Sie auf Übernehmen.

  6. 6

    Warten Sie auf den Abschluss

    Lassen Sie die Seite geöffnet, während der Designvorgang ausgeführt wird. Wenn der Status erfolgreich abgeschlossen ist, öffnen Sie die Storefront und überprüfen Sie die ausgewählte Store-Ansicht.

Wiederholen Sie die Administratorzuweisung für Magento für jede Store-Ansicht, die das benutzerdefinierte Design verwenden soll. Testen Sie das Ergebnis in Beta, bevor Sie die Änderung zu Production vorantreiben.

URL-Änderungsprozess für Magento

Verwenden Sie die Steuerelemente URL für Magento, wenn die Umgebung auf einer benutzerdefinierten Domäne reagieren soll. Geben Sie den neuen URL ein, Bestätigen Sie die Änderung und befolgen Sie die angezeigten Domänen- und Zertifikatsanweisungen. DNS und Zertifikatsänderungen Es kann einige Zeit dauern, bis die neue Adresse verfügbar ist. Warten Sie daher, bis der Vorgang abgeschlossen ist, bevor Sie die neue Adresse testen.

  1. Speichern Sie den neuen benutzerdefinierten URL für Magento, ohne das Protokoll einzuschließen.
  2. Stellen Sie das für die Domäne erstellte ACM-Zertifikat CloudFront bereit oder aktualisieren Sie es.
  3. Fügen Sie den angezeigten ACM-Validierungs-CNAME-Eintrag bei Ihrem DNS-Anbieter hinzu, warten Sie, bis er aufgelöst ist, und führen Sie „Check“ aus Validierung. Verwenden Sie die genauen Host- und Zielwerte, die im Dialogfeld angezeigt werden.
  4. Stellen Sie das CDN bereit und verweisen Sie dann die Domäne auf den angezeigten CloudFront-Hostnamen. Verwenden Sie einen ALIAS-Eintrag für einen Root Domain, sofern unterstützt, oder ein CNAME-Eintrag für eine Subdomain.
  5. Ändern Sie die Magento-Basis URL, nachdem die Zertifikats- und CDN-Schritte einen Erfolg melden.

Lösen Sie einen CloudFront-Hostnamen nicht in seine aktuellen IP-Adressen auf und erstellen Sie daraus keine festen A- oder AAAA-Einträge Werte, da sich CloudFront-Adressen ändern können. Die Weitergabe von DNS kann sich auch zwischen autorisierenden und unterscheiden öffentliche Resolver, sodass die maßgebliche Validierungsprüfung erfolgreich sein kann, bevor der Datensatz überall angezeigt wird.

Das folgende Beispiel zeigt den in Namecheap konfigurierten Validierungs-CNAME- und CloudFront-Routing-Datensatz. Andere DNS-Anbieter verwenden unterschiedliche Bezeichnungen, aber die Datensatztypen, Hostnamen und Zielwerte folgen demselben Prozess.

Protokolle

Der Abschnitt „Protokolle“ hilft Ihnen bei der Untersuchung von Builds, Bereitstellungen, Tests und Anwendungsproblemen. Wählen Sie das entsprechende aus Pipeline-Ausführung oder Umgebung, um deren Ausgabe anzuzeigen, und verwenden Sie dann Zeitstempel und Statusmeldungen, um zu identifizieren, wo a Es ist ein Fehler aufgetreten. Für eine detailliertere Fehlerbehebung stehen möglicherweise Links zu den zugehörigen CloudWatch-Protokollen zur Verfügung.

Protokolle umfassen Zeitstempel und Kennungen wie Bereitstellungs-IDs, die dabei helfen, ein Ereignis mit seiner Pipeline zu korrelieren Karte und AWS-Bereitstellung. Verwenden Sie „Aktualisieren“, um neuere Ausgaben zu laden, während ein Job ausgeführt wird, und „Kopieren“, um das Protokoll zu erfassen Suchen, Teilen oder Anhängen an eine Supportanfrage. Beginnen Sie bei der Fehlerbehebung in der Nähe des ersten expliziten Fehlers und nicht die endgültige Pipeline-Fehlermeldung, die oft nur eine Zusammenfassung eines früheren Problems ist.