Dengan integrasi Secret Manager pada Cloud Code, Anda dapat membuat, melihat, mengupdate, dan menggunakan secret dalam IDE tanpa memilikinya di codebase Anda.
Halaman ini menjelaskan cara mengakses Secret Manager dalam IDE, serta cara mulai membuat dan mengelola secret.
Mengaktifkan Secret Manager
Saat mengelola secret dengan Cloud Code, secret disimpan dengan aman di Secret Manager dan dapat diambil secara terprogram saat Anda membutuhkannya. Anda hanya perlu mengaktifkan Secret Manager API dan izin yang tepat untuk mengelola secret:
Untuk meluncurkan Secret Manager, klik tab Secret Manager di sidebar Cloud Code kanan.
Jika Secret Manager API belum diaktifkan, Cloud Code akan meminta Anda untuk mengaktifkannya dalam panel Secret Manager dengan mengklik Enable API.
Rahasia Anda juga harus ada dalam project yang sama dengan kode aplikasi Anda. Pastikan Anda telah memilih project yang tepat atau beralih menggunakan pemilih project di panel Secret Manager.
Membuat dan melihat secret
Membuat secret
Anda dapat membuat secret dengan salah satu metode berikut:
Menggunakan panel Secret Manager
Buka panel Secret Manager.
Klik ikon Add.
Tindakan ini akan meluncurkan dialog Create Secret tempat Anda dapat menetapkan project, nama, dan nilai secret, serta memilih region untuk menyimpan secret dan label untuk mengatur secret Anda.
Menggunakan editor
- Buka file yang berisi teks yang ingin Anda simpan sebagai rahasia dalam editor.
Tandai dan klik kanan teks ini.
Dari menu, pilih item menu
Create Secret in Secret Manager.... Tindakan ini akan membuka dialog Create Secret dengan nilai secret yang diisi dengan teks yang ditandai. Anda dapat menyesuaikan project, nama, nilai, region, dan label secret di sini.
Menggunakan {i>project explorer<i}
- Di penjelajah project, klik kanan tanpa menandai teks apa pun.
- Dari menu, pilih item menu
Create Secret in Secret Manager.... Tindakan ini akan membuka dialog Create Secret. Pilih project rahasia Anda, nama, nilai, region, dan label di sini, lalu klik OK setelah selesai.
Membuat versi baru secret
Jika sudah memiliki secret dan ingin memperbaruinya, Anda dapat melakukannya dengan membuka tab Versions di panel Secret Manager:
Klik ikon Add di tab Versions.
Tindakan ini akan meluncurkan dialog Tambahkan versi baru tempat Anda dapat menetapkan nilai secret yang ada menggunakan kolom nilai Secret atau dengan mengimpor file.
Jika Anda ingin menghapus semua versi rahasia sebelumnya dan hanya mempertahankan versi baru yang dibuat, pilih Nonaktifkan semua versi lama.
Setelah mengklik OK dan versi berhasil ditambahkan, Anda dapat melihat versi secret terbaru, dan jika berlaku, semua versi secret yang tercantum di bawah tab Versions.
Melihat secret
Untuk melihat secret, dalam panel Secret Manager, pilih secret dari daftar yang ditampilkan di bagian Secret Name. Detailnya seperti nama, kebijakan replikasi, stempel waktu pembuatan, dan ID resource tercantum di tab Overview.
Anda juga dapat mengklik kanan secret dan memilih Open in Cloud Console untuk melihat dan mengelola secret di browser.
Melihat versi secret
Untuk melihat versi secret, pilih secret dari daftar yang ditampilkan di bagian Secret Name, lalu pilih tab Versions.
Klik kanan versi secret yang ingin Anda tindakan dan pilih dari opsi yang tersedia; melihat nilai secret, menyalin ID versi, mengaktifkan atau menonaktifkan versi, dan menghapus versi yang dipilih.
Mengakses secret dari aplikasi
Setelah rahasia dibuat, Anda dapat menyertakannya dalam kode dan menyiapkan autentikasi.
Untuk mengakses secret yang baru dibuat dari aplikasi, ikuti langkah-langkah berikut:
Instal library klien Secret Manager.
Buka Tools > Cloud Code > Add Cloud Libraries and Manage Cloud APIs, lalu pilih Secret Manager > Secret Manager API dari hierarki Google Cloud APIs explorer. Ikuti petunjuk khusus bahasa yang diuraikan di bagian Instal Library Klien.
Sesuaikan dan sertakan cuplikan kode yang relevan dalam kode aplikasi Anda.
Terakhir, untuk menyelesaikan penyiapan autentikasi, Anda harus mengikuti panduan autentikasi library Klien:
- Pengembangan lokal: Jika Anda mengembangkan di cluster lokal (seperti minikube, Docker Desktop) atau emulator lokal, Anda harus menyelesaikan langkah-langkah yang diilustrasikan di bagian Pengembangan lokal yang relevan dengan alur kerja Anda.
- Pengembangan jarak jauh: Jika menggunakan cluster GKE atau layanan Cloud Run di aplikasi Anda, Anda harus menyelesaikan langkah-langkah yang diilustrasikan di bagian Pengembangan jarak jauh yang relevan dengan alur kerja Anda, termasuk petunjuk khusus Secret Manager untuk menyiapkan peran yang diperlukan pada akun layanan Anda.