Halaman ini menyediakan rekomendasi untuk penamaan konvensi project Cloud yang mungkin perlu Anda buat selain project Cloud untuk backend produksi Anda.
Bergantung pada tujuan lingkungan atau tahap dalam siklus proses API, Anda dapat:
- Ubah nama API atau nama layanan Cloud Endpoints. Lihat Mengonfigurasi Endpoint untuk informasi selengkapnya.
- Buat project yang berbeda.
- Mengubah jalur asal API.
Berikut adalah beberapa pola umum yang mungkin ingin Anda gunakan:
Pembuatan Versi API: Jika Anda merasa perlu membuat perubahan yang tidak kompatibel dengan versi sebelumnya 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 menampilkan versi layanannya sendiri dalam project-nya sendiri. Misalnya, Dan developer menggunakan:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Staging: Sebelum men-deploy ke produksi, Anda menguji API pada 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 yang paling mudah 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 di 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 dalam layanan dan project yang sama dengan versi yang sudah ada, dan mengubah jalurnya. Contoh:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo