Diese Seite enthält Empfehlungen zu Namenskonventionen der Cloudprojekte, die Sie möglicherweise zusätzlich zum Cloudprojekt für Ihr Produktions-Back-End erstellen müssen.
Je nach Zweck der Umgebung und der Phase im API-Lebenszyklus haben Sie folgende Möglichkeiten:
- API-Namen oder Cloud Endpoints-Dienstnamen ändern. Weitere Informationen finden Sie unter Endpoints konfigurieren.
- Anderes Projekt erstellen
- Pfad ändern, über den die API bereitgestellt wird
Es folgen einige allgemeine Muster, die sie verwenden können:
API versionieren: Wenn Sie davon ausgehen, dass Sie künftig rückwärtsinkompatible Änderungen vornehmen müssen, sollten Sie vorausplanen und die Versionsnummer in den Pfad einfügen, über den die API bereitgestellt wird. Beispiel:
my-api.endpoints.my‐project.cloud.goog/v1/echo
Entwicklung/Testinstanzen: Jeder Entwickler erstellt eine eigene Version des Dienstes im jeweils eigenen Projekt. Zum Beispiel verwendet der Entwickler Daniel:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Staging: Bevor Sie Ihre APIs für die Produktion bereitstellen, testen Sie sie in Ihrem Staging-Back-End, das sich in seinem eigenen Projekt befindet. Beispiel:
my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
Private Alphaversion ausführen: Wenn Sie eine neue Version Ihres Dienstes bei einigen, aber nicht allen Kunden testen möchten, ist die einfachste Methode, die Alphaversion in ein eigenes Projekt einzufügen, was das höchste Maß an Isolation von der Produktion bietet. Beispiel:
my-api.endpoints.my‐project-alpha.cloud.goog/v2alpha/echo
Alternativ können Sie die Alphaversion auch in dasselbe Projekt einfügen, aber als separaten Dienst konfigurieren. Da es ein separater Dienst ist, können Sie den Zugriff auf die Alpha-Kunden beschränken. Beispiel:
my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
Offene Alphaversion ausführen: Wenn Sie eine Alphaversion veröffentlichen möchten, die für alle Kunden verfügbar ist, können Sie sie in denselben Dienst und dasselbe Projekt wie die vorhandene Version einfügen und den Pfad ändern. Beispiel:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo