Halaman ini memberikan rekomendasi untuk konvensi penamaan 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 mungkin ingin:
- Ubah nama API atau nama layanan Cloud Endpoints. Lihat Mengonfigurasi Endpoint untuk mengetahui informasi selengkapnya.
- Buat project lain.
- Ubah jalur tempat API ditayangkan.
Berikut adalah beberapa pola umum yang mungkin ingin Anda gunakan:
Membuat 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 projectnya sendiri. Misalnya, Dan si developer menggunakan:
my-api.endpoints.dan-dev-project.cloud.goog/v1/echo
Penyiapan: Sebelum men-deploy ke produksi, Anda menguji API di backend penyiapan, yang berada dalam projectnya 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 di projectnya 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, lalu mengubah jalur. Contoh:
my-api.endpoints.my-project.cloud.goog/v2alpha/echo