Mit Acquia arbeiten

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Apigee verwendet den Website-Verwaltungsdienst Acquia, um cloudbasierte Versionen des Developer Services-Portals zu hosten. Acquia wurde für die Zusammenarbeit mit Drupal entwickelt, damit Sie Ihr Portal in einer sicheren Umgebung entwickeln, testen und veröffentlichen können.

In den folgenden Abschnitten wird beschrieben, wie Sie Ihr Portal mit Acquia entwickeln und verwalten.

Auf die Acquia Cloud-Oberfläche zugreifen

Nachdem Ihr Acquia Cloud-Konto eingerichtet wurde, können Sie über die Acquia Cloud-Oberfläche unter https://cloud.acquia.com/ auf Ihr Portal zugreifen.

Wenn Sie sich das erste Mal anmelden, wird die Seite Applications (Anwendungen) angezeigt, wie in der folgenden Abbildung dargestellt.

Auf der Seite „Anwendungen“ werden alle Anwendungen angezeigt, auf die Sie Zugriff haben und die in Acquia Cloud gehostet werden. Eine Anwendung ist die Softwareeinheit, die Sie in der Acquia Cloud verwalten, z. B. auf Ihrer Drupal-basierten Portalwebsite.

In den folgenden Abschnitten wird beschrieben, wie Sie die Acquia Cloud-Benutzeroberfläche zum Verwalten Ihrer Portalinhalte verwenden.

Weitere Informationen zur Acquia Cloud-Schnittstelle finden Sie in der Acquia Cloud-Dokumentation unter Bei der Acquia Cloud-Oberfläche anmelden und Anwendungen mit Acquia Cloud verwalten.

Umgebungen verwalten

Rufen Sie die Acquia Cloud-Benutzeroberfläche auf und klicken Sie auf der Seite „Anwendungen“ auf Verwalten, die mit Ihrer Portalwebsite verknüpft ist, um auf das Dashboard zuzugreifen.

Zur Verwaltung Ihres Workflows stehen drei Umgebungen zum Entwickeln, Testen und Veröffentlichen Ihres Portals zur Verfügung, wie in der folgenden Tabelle dargestellt. Ihr Portal wird in jeder Umgebung bereitgestellt, kann sich jedoch in einem anderen Status mit einem eindeutigen Codezweig oder Tag, einer eindeutigen Datenbank usw. befinden. Siehe Code in Ihren Portalumgebungen bereitstellen.

Environment Beschreibung Standard-URL
Dev Entwickeln Sie neue Funktionen und passen Sie Ihr Portal an. http://{application-name}xxxxxx.devcloud.acquia-sites.com/

Dabei steht application-name für den Namen Ihrer Anwendung und xxxxxx für einen eindeutigen String zur Unterscheidung von Dev und Stage.

Phase Testen Sie den neuesten Code, bevor Sie ihn in die Produktionsumgebung übertragen. http://{application-name}yyyyyy.devcloud.acquia-sites.com/

Dabei steht application-name für den Namen Ihrer Anwendung und yyyyyy für einen eindeutigen String zur Unterscheidung von Dev und Stage.

Prod Veröffentlichen Sie Ihr Portal in der Produktion (Live). http://{application-name}.devcloud.acquia-sites.com/

Dabei ist application-name der Name Ihrer Anwendung.

Hinweis:Weitere Informationen finden Sie unter Benutzerdefinierte Domain konfigurieren.

Weitere Informationen finden Sie unter Mit Umgebungen arbeiten in der Acquia Cloud-Dokumentation.

Ihr Portal entwickeln

In den folgenden Abschnitten wird beschrieben, wie Sie Ihr Portal entwickeln.

In den folgenden Abschnitten finden Sie weitere Informationen zum Anpassen des Portals.

Gewünschte Aktion

Du kannst

Weitere Informationen

Design der Website ändern

Einfach: Verwenden Sie den Menüeintrag Darstellung auf der Portalwebsite, um Änderungen vorzunehmen, z. B. am Logo und an den Farben der Website.

Weitere Informationen finden Sie unter Darstellung anpassen.

Erweitert – Erweitern Sie das Apigee Responsive-Theme, um das gesamte Design der Website anzupassen.

Weitere Informationen finden Sie unter Design anpassen.

Verhalten der Websitefunktionen ändern

Einfach: Verwenden Sie die Administratoreinstellungen im Portal, um das Verhalten der Website zu ändern/konfigurieren.

Die Apigee-Dokumentation

Erweitert: Erstellen Sie ein benutzerdefiniertes Modul, um das Verhalten der Website zu ändern.

Siehe Benutzerdefinierte Module erstellen in der Drupal-Dokumentation

Übersicht über das Git-Repository

Das Git-Repository für Ihren Drupal-Code enthält Ihren gesamten Portalcode und ist nach der folgenden Struktur strukturiert.

Hinweis: Bearbeiten Sie nur Inhalte im Verzeichnis /sites/all. Wenn Sie Inhalte ändern, die sich außerhalb des Verzeichnisses /sites/all befinden, treten beim Upgrade auf neue Versionen Probleme auf. Außerdem können beim Prüfen von Änderungen in Git Zusammenführungskonflikte auftreten.

Ordner im Git-Repository

Beschreibung

/profiles/apigee

Apigee hat unter anderem folgende Module und Themen gepflegt:

  • /profiles/apigee/modules/contrib: von Apigee verwaltete Drupal-Beitragsmodule
  • /profiles/apigee/themes/contrib: von Apigee verwaltete Drupal-Beitragsthemen
  • /profiles/apigee/modules/custom: von Apigee erstellte benutzerdefinierte Module
  • /profiles/apigee/themes/custom: von Apigee erstellte benutzerdefinierte Designs

Hinweis: Ändern Sie keine Inhalte im Verzeichnis /profiles/apigee. Andernfalls treten beim Upgrade auf neue Versionen Probleme auf und beim Einchecken von Änderungen in Git können Zusammenführungskonflikte auftreten. Best Practices für Drupal finden Sie unter Core nie hacken.

/sites/all

Deine benutzerdefinierten Drupal-Module und -Designs. Informationen zum Verwalten der Inhalte in diesem Ordner finden Sie unter Benutzerdefinierte Module und Designs hinzufügen und Drupal-Profilmodule und -Designs überschreiben.

Hinweis: Bearbeiten Sie nur Inhalte im Verzeichnis /sites/all.

Zugriff auf Ihren Code

Für den Zugriff auf Ihr Code-Repository in Git müssen Sie die in den folgenden Abschnitten beschriebenen Aufgaben ausführen:

Siehe auch Wie greife ich auf den Quellcode des Drupal 7-Entwicklerportals zu?

SSH-Zugriff auf Ihren Server aktivieren

Bevor Sie Ihren Drupal-Code mit Git verwalten können, müssen Sie SSH für den Zugriff auf Ihren Server aktivieren. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter SSH-Zugriff aktivieren.

So aktivieren Sie den SSH-Zugriff:

  1. Melden Sie sich unter https://accounts.acquia.com in der Benutzeroberfläche von Acquia Accounts an.
  2. Klicken Sie auf Anmeldedaten.
  3. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Passwort noch einmal ein, um Ihre Identität zu bestätigen.
  4. Klicken Sie unter „SSH-Schlüssel“ auf SSH-Schlüssel hinzufügen.
  5. Geben Sie die folgenden Informationen ein:
    Feld Beschreibung
    Alias Alias für den SSH-Schlüssel. Der Alias kann alphanumerische Zeichen und Unterstriche enthalten.
    Öffentlicher Schlüssel Öffentlicher Schlüssel.

    Informationen zum Generieren eines öffentlichen SSH-Schlüssels finden Sie in der Acquia Cloud-Dokumentation unter Öffentlichen SSH-Schlüssel generieren.

  6. Klicken Sie auf Schlüssel hinzufügen.

Auf Ihr Code-Repository in Git zugreifen

Das Git-Repository enthält den gesamten Code Ihrer Portalwebsite. Sie können neuen Code hinzufügen oder vorhandenen Code anpassen, um Ihr Portal zu konfigurieren. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter Code-Repository verwenden.

So greifen Sie auf Ihr Code-Repository im Git-Repository zu:

  1. Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
  2. Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details des Portals aufzurufen.
  3. Klicken Sie in der Navigationsleiste auf App Info.

  4. Kopieren Sie den Befehl zum Klonen im Dialogfeld „Anwendungsinformationen“.
  5. Klonen Sie das Git-Repository in Ihre lokale Umgebung, indem Sie einen der folgenden Git-Befehle ausführen:

    So klonen Sie das Git-Repository und erstellen einen neuen Zweig:

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    Klonen Sie das Git-Repository aus dem master-Branch:

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. Wiederholen Sie diese Schritte, wenn Sie bereit sind, Ihre Änderungen mithilfe der entsprechenden Befehle im Anwendungsfenster bereitzustellen und per Commit in das Git-Repository zu übertragen.

    Wenn Sie einen Commit für einen Zweig an Ihr Repository durchführen, aktualisiert Acquia Cloud die Umgebung, in der dieser Codezweig ausgeführt wird. Sie können Code in Ihren Portalumgebungen bereitstellen, wie im nächsten Abschnitt beschrieben.

Code in Portalumgebungen bereitstellen

Wenn Sie Code in einer Portalumgebung bereitstellen, wechseln oder zurücksetzen, zwischen Umgebungen verschieben oder mehr über die Repository-Struktur und den empfohlenen Workflow erfahren möchten, lesen Sie in der Acquia Cloud-Dokumentation den Abschnitt Mit Websites in Aquia Cloud arbeiten. Wenn Sie neuen Code in einer Umgebung bereitstellen, müssen Sie update.php ausführen, um die erforderlichen Datenbankaktualisierungen vorzunehmen.

Benutzerdefinierte Module und Designs hinzufügen

Sie können die Funktionen des Portals erweitern, indem Sie den in der folgenden Tabelle aufgeführten Ordnern Ihre eigenen benutzerdefinierten Module und Designs hinzufügen.

Hinweis: Bearbeiten Sie nur Inhalte im Verzeichnis /sites/all. Wenn Sie Inhalte ändern, die sich außerhalb des Verzeichnisses /sites/all befinden, kann es beim Prüfen von Änderungen in Git zu Zusammenführungskonflikten kommen.

Modul/Thema Ordner im Git-Repository Weitere Informationen (Dokumentation zu Drupal)
Benutzerdefinierte Module sites/all/modules/custom Benutzerdefinierte Module erstellen
Benutzerdefinierte Designs sites/all/themes Design anpassen
Drupal 7 als Design-Design verwenden

Nachdem Sie das benutzerdefinierte Modul oder Design in der Dev-Umgebung hinzugefügt haben, können Sie es zu Testzwecken in der Testumgebung und dann in der Live-Umgebung für die Produktion bereitstellen, wie unter Code in Portalumgebungen bereitstellen beschrieben.

Drupal-Profilmodule und -designs überschreiben

Die Module und Designs in den folgenden Verzeichnissen überschreiben die von Apigee in /profiles/apigee verwalteten und verteilten Drupal-Profilmodule und Themen. Siehe Übersicht über Ihr Git-Repository.

Sie können beispielsweise in den folgenden Szenarien ein Modul in der Apigee Drupal-Distribution überschreiben:

  • Sie möchten eine andere Version eines bestimmten Moduls verwenden.
  • Sie möchten vor dem nächsten geplanten Apigee-Release ein Sicherheitsupdate implementieren.
Modul/Thema Ordner im Git-Repository Weitere Informationen (Dokumentation zu Drupal)
Von Drupal unterstützte Module sites/all/modules/contrib

Hinweis: Module, die an einer beliebigen Stelle unter /sites/all/modules gespeichert sind, überschreiben die Apigee Drupal-Distributionsmodule.

Bereitgestellte Module

Hinweis: Drupal-Module in diesem Verzeichnis überschreiben äquivalente Module, die von Apigee in /profiles/apigee/modules verwaltet und verteilt werden. Entfernen Sie alle doppelten Module, die Sie diesem Ordner hinzugefügt haben, wenn Sie die von Apigee verwalteten Drupal-Profilmodule verwenden möchten.

Von Drupal unterstützte Designs sites/all/themes Eingereichte Themen

Hinweis: Von Drupal bereitgestellte Themen in diesem Verzeichnis überschreiben äquivalente Module, die von Apigee in /profiles/apigee/themes verwaltet und verteilt werden. Entfernen Sie alle doppelten Module, die Sie diesem Ordner hinzugefügt haben, wenn Sie die von Apigee verwalteten Profildesigns verwenden möchten.

SSL aktivieren

Wenn Sie den sicheren Zugriff auf Ihre Website über HTTPS ermöglichen möchten, müssen Sie SSL aktivieren.

So aktivieren Sie SSL:

  1. Fordern Sie ein SSL-Zertifikat von einer Zertifizierungsstelle (Certificate Authority, CA) oder einem Anbieter für SSL-Zertifikat an. Weitere Informationen finden Sie unter SSL aktivieren.
  2. Laden Sie das SSL-Zertifikat auf der SSL-Seite der Acquia Cloud-Benutzeroberfläche hoch. Weitere Informationen finden Sie unter SSL-Zertifikate verwalten.

Produktionsumgebung schützen

Wenn Sie eine Anwendung zum ersten Mal erstellen, können Sie die Produktionsumgebung frei verwalten und Änderungen aus der Entwicklungs- und Staging-Umgebung übernehmen. Nachdem Sie Ihre Inhalte veröffentlicht haben, sollten Sie die Produktionsumgebung sperren, um nicht autorisierte oder versehentliche Aktualisierungen der Inhalte zu verhindern. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter Live-Anwendung mit dem Produktionsmodus schützen.

So sichern Sie Ihre Produktionsumgebung:

  1. Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
  2. Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details Ihrer Portalwebsite aufzurufen.
  3. Klicken Sie auf Prod, um die Details zur Produktionsumgebung aufzurufen.
  4. Klicken Sie in der Navigationsleiste auf Produktionsmodus.
  5. Klicke auf Aktivieren, um den Produktionsmodus zu aktivieren.

Modul- und Designaktualisierungen auf das Portal anwenden

Apigee aktualisiert die Module und Designs in Ihrem Portal regelmäßig automatisch auf die neueste Version. Aktualisierungen werden nur an der Dev-Umgebung vorgenommen und mit Tags versehen, um anzuzeigen, dass sie in andere Portalumgebungen migriert werden müssen.

Wenn Ihre Website nicht zur Abrechnungsorganisation von Apigee Acquia gehört (z. B. eine neue Website, die von einem anderen Hostanbieter in Ihre eigene Organisation migriert wurde), müssen Sie Apigee Zugriff auf Ihr Git-Repository gewähren, um automatisierte Push-Übertragungen von Devportal-Updates zu erhalten. Weitere Informationen erhalten Sie vom Apigee-Support.

Wenn Sie benutzerdefinierte Module oder Designs hinzugefügt haben, müssen Sie diese manuell aktualisieren.

In der folgenden Tabelle sind die Schritte zusammengefasst, die zum Anwenden von Modul- und Designaktualisierungen auf das Portal erforderlich sind.

Module/Themen Beschreibung
Apigee Edge-Module

Apigee wendet Updates nur in der Dev-Umgebung automatisch an.

Nachdem Sie die Aktualisierungen getestet haben, migrieren Sie sie von Dev in die Phase in die Produktionsumgebung, wie unter Code in Portalumgebungen bereitstellen beschrieben.

Responsives Apigee-Design

Apigee wendet Updates nur in der Dev-Umgebung automatisch an.

Nachdem Sie die Aktualisierungen getestet haben, migrieren Sie sie von Dev in die Phase in die Produktionsumgebung, wie unter Code in Portalumgebungen bereitstellen beschrieben.

Kern- und Beitragsmodule von Drupal

Apigee wendet Updates nur in der Dev-Umgebung automatisch an.

Nachdem Sie die Aktualisierungen getestet haben, migrieren Sie sie von Dev in die Phase in die Produktionsumgebung, wie unter Code in Portalumgebungen bereitstellen beschrieben.

Benutzerdefinierte Module und Designs

Wenn Sie Ihrem Portal benutzerdefinierte Module und Designs hinzugefügt haben, wie unter Benutzerdefinierte Module und Designs hinzufügen beschrieben, müssen Sie Updates manuell installieren.

Laden Sie die neueste Version manuell oder mit Drush in Ihr lokales Verzeichnis herunter. Stellen Sie dann die Aktualisierungen bereit, führen Sie einen Commit durch und übertragen Sie sie in das Git-Repository. Nachdem Sie die Aktualisierungen getestet haben, migrieren Sie sie von Dev in die Phase in die Produktionsumgebung, wie unter Code in Portalumgebungen bereitstellen beschrieben.

Benutzerdefinierte Features migrieren

Wenn Sie dem Portal benutzerdefinierten Code oder Konfigurationen hinzufügen, müssen Sie diese pflegen und von Dev- in Stage- und Prod-Umgebungen migrieren.

Für Code im Git-Repository können Sie den unter Code in Ihren Portalumgebungen bereitstellen beschriebenen Prozess verwenden, um den Code von Dev zu Stage und Prod zu migrieren.

Wenn Sie benutzerdefinierte Konfigurationen erstellt haben, verwenden Sie eine der folgenden Methoden, um diese zu migrieren:

Methode Beschreibung
Konfiguration in Code exportieren Viele gängige Konfigurationen lassen sich mithilfe des Moduls „Features“ in Code exportieren. Zum Beispiel Ansichten, Felder, Bild-Cache usw.
Funktion hook_update_N() implementieren Drupal verwaltet Datenbank- und Konfigurationsänderungen mit der Funktion hook_update_N().

Mit einem benutzerdefinierten Modul haben Sie folgende Möglichkeiten:

  • Fügen Sie der Datei .install Ihres Moduls hook_update_N()-Funktionen hinzu, um Ihre Änderungen zu verarbeiten.
  • Stellen Sie diese Änderungen zusammen mit Ihrem Code bereit.
  • Führen Sie update.php aus, um die Änderungen in der Phase der Phase und Produktion zu migrieren.

Benutzerdefinierte Domain konfigurieren

Wie unter Umgebungen verwalten erwähnt, enden die Standard-Domainnamen für die Portalumgebungen alle auf acquia-sites.com. Es empfiehlt sich, einen eigenen benutzerdefinierten Domainnamen anzugeben, der den Zweck Ihrer Website personalisiert und besser widerspiegelt. Hier ist eine beliebte Alternative:

https://developers.mycompany.com

So konfigurieren Sie eine benutzerdefinierte Domain:

  1. Fügen Sie der Umgebung Ihrer Portalwebsite Ihre Domain hinzu. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter Domains verwalten.
  2. Richten Sie die benutzerdefinierte Domain bei Ihrem DNS-Anbieter ein. Verweisen Sie dazu den DNS-Eintragseintrag Ihres Domainnamens auf die öffentliche IP-Adresse und nicht auf eine acquia-sites.com-Domain. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter DNS-Einträge auf öffentliche IP-Adressen verweisen.

    Hinweis: Legen Sie den CNAME-Eintrag des Domainnamens nicht auf eine acquia-sites.com-Domain fest. Dies kann zu Latenzproblemen oder Ausfallzeiten auf Ihrer Portalwebsite führen.

Monitoring Ihres Portals mit Acquia Insight

Acquia Insight umfasst eine Reihe von Tools, mit denen Sie Leistung, Sicherheit und Suchmaschinenoptimierung Ihrer Portalwebsite überwachen können. Weitere Informationen findest du unter Acquia Insight.

Sichern Ihres Portals

In den folgenden Tabellen werden die Optionen zusammengefasst, die für die Sicherung Ihrer Portalkomponenten zur Verfügung stehen.

Komponente Sicherungsdetails Weitere Informationen in Acquia Cloud Docs
Code
  • Der Code wird von einem Versionskontrollsystem verwaltet und bei jedem Commit getaggt.
  • Sie können jederzeit ein bestimmtes Tag synchronisieren oder zu einem bestimmten Tag wiederherstellen.
Datenbank
  • Tägliche Sicherungen werden durchgeführt und drei Tage lang aufbewahrt.
  • Automatische und On-Demand-Sicherungen planen
  • Für alle Daten werden stündlich Snapshots von internen Notfällen erstellt.
Files Führen Sie manuelle Sicherungen durch oder planen Sie einen Cronjob.
Vollständige Anwendung Führen Sie eine manuelle Sicherung mit Drush durch.
.
Drupal-Dateisystem Führen Sie manuelle Sicherungen mit einer der folgenden Optionen durch:
  • Kopieren Sie Ihre Dateien mit einem FTP-Client oder Befehlszeilentools (rsync und scp).
  • Erstellen Sie mit Drush ein komprimiertes Archiv.

Hinweis: Das Modul Backup and Migrate wird in Acquia Cloud nicht unterstützt. Weitere Informationen finden Sie unter Das Backup and Migrate-Modul wird in Acquia Cloud nicht unterstützt.

Anzeigen von Aktivitätsbenachrichtigungen

Sie können sich Aktivitätsbenachrichtigungen ansehen, um den Überblick über wichtige Aktionen auf Ihrer Portalwebsite zu behalten, z. B. das Installieren oder Kopieren von Code zwischen Umgebungen, Datenbankaktualisierungen und -sicherungen, Serveränderungen und mehr. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter Aktivitätsbenachrichtigungen ansehen.

So rufen Sie die Liste der Benachrichtigungen auf:

  1. Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
  2. Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details Ihrer Portalwebsite aufzurufen.
  3. Klicken Sie rechts oben in der Navigationsleiste auf das Glockensymbol, um die neuesten Benachrichtigungen aufzurufen.

  4. Klicken Sie auf den Pfeil neben einer Benachrichtigung, um weitere Informationen über die Aktivität anzuzeigen.

Statusupdates abonnieren

Sie können Apigee-Release- und -Statusupdates unter status.apigee.com abonnieren. Klicken Sie auf Subscribe to Updates, geben Sie Ihre Kontaktdaten wie z. B. Ihre E-Mail-Adresse ein, wenn Sie dazu aufgefordert werden, und klicken Sie auf Abonnieren. Prüfen Sie auf der Seite zur Verwaltung von E-Mail-Benachrichtigungen, ob Entwicklerportal ausgewählt ist. Ändern Sie nach Bedarf andere Benachrichtigungseinstellungen und klicken Sie auf Einstellungen aktualisieren.

Sie können Acquia-Statusupdates abonnieren, um Benachrichtigungen zu Dienstunterbrechungen, Notfallwartungen oder Sicherheitsupdates zu erhalten, die auf der Plattform vorgenommen werden. So abonnieren Sie Acquia Cloud-Updates:

  1. Rufen Sie die Seite Acquia-Status auf.
  2. Klicken Sie auf Benachrichtigungen abonnieren.
  3. Wählen Sie die Methode aus, über die Sie Updates erhalten möchten (E-Mail, SMS usw.).
  4. Wählen Sie auf der Seite „Benachrichtigungen“ die Produkte aus, für die Sie Statusupdates erhalten möchten. Beispiel: Acquia Cloud Enterprise.
  5. Klicken Sie auf Einstellungen aktualisieren.