Automatisieren von Bereitstellungen im Entwicklerportal

  • Artikel

GILT FÜR: Developer | Basic | Basic v2 | Standard | Standard v2 | Premium

Das API Management-Entwicklerportal unterstützt den programmgesteuerten Zugriff auf Inhalte. Es ermöglicht Ihnen das Importieren oder Exportieren von Daten in einen API Management-Dienst über die REST-API für die Inhaltsverwaltung. Der REST-API-Zugriff funktioniert sowohl für verwaltete als auch für selbstgehostete Portale.

Automatisiertes Migrationsskript

Sie können die API verwenden, um die Migration von Inhalten zwischen zwei API Management-Diensten zu automatisieren, z. B. einem Dienst in der Testumgebung und einem Dienst in der Produktionsumgebung. Das scripts.v3/migrate.js-Skript im API Management-Entwicklerportal GitHub-Repository vereinfacht diesen Automatisierungsprozess.

Warnung

Mit dem Skript wird der Inhalt des Entwicklerportals im Ziel-API-Management entfernt. Wenn Sie Bedenken haben, stellen Sie sicher, dass Sie eine Sicherung durchführen.

Hinweis

Wenn Sie ein selbstgehostetes Portal mit einem explizit definierten benutzerdefinierten Speicherkonto zum Hosten von Mediendateien verwenden (d. h., Sie definieren die blobStorageUrl-Einstellung in der config.design.json-Konfigurationsdatei), müssen Sie das ursprüngliche Skriptscripts/migrate.js verwenden. Das ursprüngliche Skript funktioniert nicht für verwaltete oder selbstgehostete Portale mit dem Medienspeicherkonto, das von API Management verwaltet wird. Verwenden Sie in diesem Fall stattdessen das Skript aus dem /scripts.v3-Ordner.

Das Skript führt die folgenden Schritte aus:

  1. Erfassen Sie die Portalinhalte und -medien aus dem API Management-Dienst.
  2. Entfernen Sie die Portalinhalte und -medien aus dem API Management-Dienst.
  3. Laden Sie die Portalinhalte und -medien im angestrebten API Management-Dienst hoch.
  4. Optional und nur für verwaltete Portale: Veröffentlichen Sie das Portal automatisch.

Nachdem das Skript erfolgreich ausgeführt wurde, sollte der Ziel-API-Management-Dienst den gleichen Portalinhalt wie der Quelldienst enthalten, und Sie können ihn als Administrator sehen.

  • Wenn Sie ein verwaltetes Portal verwenden, können Sie das Skript so festlegen, dass das Zielportal automatisch veröffentlicht wird, damit die migrierte Version den Besucher automatisch zur Verfügung gestellt wird.
  • Wenn Sie ein selbstgehostetes Portal verwenden, müssen Sie das Zielportal manuell veröffentlichen. Befolgen Sie die Anweisungen zum Veröffentlichen und Hosten im Tutorial, um ein selbstgehostetes Entwicklerportal einzurichten.

Nächste Schritte

Weitere Informationen zum Entwicklerportal: