Halaman ini memberikan rekomendasi untuk konvensi penamaan project Cloud yang mungkin perlu Anda buat selain project Cloud untuk backend produksi.
Bergantung pada tujuan lingkungan atau tahap dalam siklus proses API, Anda dapat:
- Ubah nama API atau nama layanan Cloud Endpoints. Lihat Mengonfigurasi Endpoint untuk mengetahui informasi selengkapnya.
- Buat project yang berbeda.
- Ubah jalur tempat API ditayangkan.
Berikut adalah beberapa pola umum yang mungkin ingin Anda gunakan:
Memberi versi API: Jika Anda merasa perlu melakukan perubahan yang tidak kompatibel dengan versi lama di masa mendatang, rencanakan terlebih dahulu dan tambahkan nomor versi di jalur tempat API ditayangkan. Contoh:
my-api.endpoints.my‐project.cloud.goog/v1/echo
Instance pengembangan/pengujian: Setiap developer menyiapkan versi layanannya sendiri, dalam project mereka sendiri. Misalnya, Dan developer menggunakan:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Staging: Sebelum men-deploy ke produksi, Anda menguji API di backend staging, yang berada dalam project-nya sendiri. Contoh:
my-api.endpoints.my‐project-staging.cloud.goog/v1/echo
Menjalankan alfa pribadi: Jika Anda ingin menguji versi baru layanan dengan beberapa pelanggan, tetapi tidak semua, pendekatan termudah adalah menempatkan versi alfa dalam project-nya sendiri, yang memberikan tingkat isolasi tertinggi dari produksi. Contoh:
my-api.endpoints.my‐project-alpha.cloud.goog/v2alpha/echo
Atau, Anda dapat menempatkan versi alfa dalam project yang sama, tetapi mengonfigurasinya sebagai layanan terpisah. Karena merupakan layanan terpisah, Anda dapat membatasi akses hanya untuk pelanggan alfa. Contoh:
my-api-alpha.endpoints.my-project.cloud.goog/v2alpha/echo
Menjalankan alfa terbuka: Jika ingin merilis versi alfa yang tersedia untuk semua pelanggan, Anda dapat menempatkannya di layanan dan project yang sama dengan versi yang ada, dan mengubah jalurnya. Contoh:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo