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 |
| Phase | Testen Sie den neuesten Code, bevor Sie ihn in die Produktionsumgebung übertragen. |
http://{application-name}yyyyyy.devcloud.acquia-sites.com/
Dabei steht |
| Prod | Veröffentlichen Sie Ihr Portal in der Produktion (Live). |
http://{application-name}.devcloud.acquia-sites.com/
Dabei ist 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.
- Übersicht über das Git-Repository
- Zugriff auf den Code
- Code in Ihren Portalumgebungen bereitstellen
- Benutzerdefinierte Module und Designs hinzufügen
- Drupal-Profilmodule und -designs überschreiben
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. |
|
|
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:
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:
- Melden Sie sich unter https://accounts.acquia.com in der Benutzeroberfläche von Acquia Accounts an.
- Klicken Sie auf Anmeldedaten.
- Wenn Sie dazu aufgefordert werden, geben Sie Ihr Passwort noch einmal ein, um Ihre Identität zu bestätigen.
- Klicken Sie unter „SSH-Schlüssel“ auf SSH-Schlüssel hinzufügen.
- 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.
- 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:
- Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
- Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details des Portals aufzurufen.
- Klicken Sie in der Navigationsleiste auf App Info.
- Kopieren Sie den Befehl zum Klonen im Dialogfeld „Anwendungsinformationen“.
- 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] - 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 |
Bereitgestellte Module
Hinweis: Drupal-Module in diesem Verzeichnis überschreiben äquivalente Module, die von Apigee in |
| 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 |
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:
- 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.
- 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:
- Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
- Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details Ihrer Portalwebsite aufzurufen.
- Klicken Sie auf Prod, um die Details zur Produktionsumgebung aufzurufen.
- Klicken Sie in der Navigationsleiste auf Produktionsmodus.
- 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:
|
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:
- Fügen Sie der Umgebung Ihrer Portalwebsite Ihre Domain hinzu. Weitere Informationen finden Sie in der Acquia Cloud-Dokumentation unter Domains verwalten.
- 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 |
|
|
| Datenbank |
|
|
| 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:
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:
- Melden Sie sich unter https://cloud.acquia.com/ auf der Acquia Cloud-Oberfläche an.
- Klicken Sie auf der Seite „Anwendungen“ auf Verwalten, um die Details Ihrer Portalwebsite aufzurufen.
- Klicken Sie rechts oben in der Navigationsleiste auf das Glockensymbol, um die neuesten Benachrichtigungen aufzurufen.
- 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:
- Rufen Sie die Seite Acquia-Status auf.
- Klicken Sie auf Benachrichtigungen abonnieren.
- Wählen Sie die Methode aus, über die Sie Updates erhalten möchten (E-Mail, SMS usw.).
- Wählen Sie auf der Seite „Benachrichtigungen“ die Produkte aus, für die Sie Statusupdates erhalten möchten. Beispiel: Acquia Cloud Enterprise.
- Klicken Sie auf Einstellungen aktualisieren.