Langkah ini menjelaskan cara membuat akun layanan Google Cloud dan kredensial TLS yang diperlukan agar Apigee hybrid dapat beroperasi.
Membuat akun layanan
Apigee hybrid menggunakan akun layanan Google Cloud untuk memungkinkan komponen hybrid berkomunikasi dengan melakukan panggilan API yang diotorisasi.
Pada langkah ini, Anda akan menggunakan alat command line hybrid Apigee untuk membuat kumpulan akun layanan dan mendownload file kunci pribadi akun layanan.
Untuk mempelajari akun layanan lebih lanjut dan membaca daftar lengkap akun layanan yang direkomendasikan untuk lingkungan produksi, lihat hal berikut:
Apigee menyediakan alat, create-service-account
, yang membuat akun layanan,
menetapkan peran ke akun layanan, serta membuat dan mendownload file kunci untuk akun
layanan dalam satu perintah. Untuk mempelajari konsep Google Cloud terkait, lihat
Membuat
dan mengelola akun layanan serta
Membuat
dan mengelola kunci akun layanan.
-
Pastikan Anda berada di direktori
base_directory/hybrid-files
yang dikonfigurasi di Menyiapkan struktur direktori project. -
Jalankan perintah berikut dari dalam direktori
hybrid-files
. Perintah ini membuat akun layanan untuk komponenapigee-metrics
dan menempatkan kunci yang didownload di direktori./service-accounts
../tools/create-service-account apigee-metrics ./service-accounts
Saat Anda melihat perintah berikut, masukkan y:
[INFO]: gcloud configured project ID is project_id. Press: y to proceed with creating service account in project: project_id Press: n to abort.
Jika ini adalah pertama kalinya SA dengan nama persis yang ditetapkan oleh alat dibuat, alat tersebut hanya akan membuatnya, dan Anda tidak perlu melakukan tindakan apa pun.
Namun, jika Anda melihat pesan dan perintah berikut, masukkan y untuk membuat kunci baru:
[INFO]: Service account apigee-metrics@project_id.iam.gserviceaccount.com already exists. ... [INFO]: The service account might have keys associated with it. It is recommended to use existing keys. Press: y to generate new keys.(this does not de-activate existing keys) Press: n to skip generating new keys.
-
Sekarang, buat akun layanan lainnya menggunakan perintah berikut. Perintah
create-service-account
bersifat interaktif dan memerlukan respons untuk setiap akun../tools/create-service-account apigee-synchronizer ./service-accounts
./tools/create-service-account apigee-udca ./service-accounts
./tools/create-service-account apigee-mart ./service-accounts
./tools/create-service-account apigee-cassandra ./service-accounts
./tools/create-service-account apigee-logger ./service-accounts
./tools/create-service-account apigee-watcher ./service-accounts
./tools/create-service-account apigee-distributed-trace ./service-accounts
-
Pastikan kunci akun layanan dibuat menggunakan perintah berikut. Anda bertanggung jawab untuk menyimpan
kunci pribadi ini dengan aman. Nama file kunci diawali dengan nama project Google Cloud Anda.
ls ./service-accounts
Hasilnya akan terlihat seperti berikut:
gcp-project-id-apigee-cassandra.json gcp-project-id-apigee-distributed-trace.json gcp-project-id-apigee-logger.json gcp-project-id-apigee-mart.json gcp-project-id-apigee-metrics.json gcp-project-id-apigee-synchronizer.json gcp-project-id-apigee-udca.json gcp-project-id-apigee-watcher.json
Membuat sertifikat TLS
Anda harus memberikan sertifikat TLS untuk gateway ingress runtime dalam konfigurasi hibrida Apigee. Untuk tujuan panduan memulai ini (penginstalan uji coba non-produksi), gateway runtime dapat menerima kredensial yang ditandatangani sendiri. Pada langkah-langkah berikut, openssl digunakan untuk membuat kredensial yang ditandatangani sendiri.
Pada langkah ini, Anda akan membuat file kredensial TLS dan menambahkannya ke direktori base_directory/hybrid-files/certs
.
Di Langkah 6: Konfigurasi
cluster, Anda akan menambahkan jalur file ke file konfigurasi cluster.
- Pastikan Anda berada di direktori
base_directory/hybrid-files
yang dikonfigurasi di Menyiapkan struktur direktori project. - Pastikan untuk menyimpan nama domain ke variabel lingkungan
DOMAIN
menggunakan perintah berikut:echo $DOMAIN
-
Jalankan perintah berikut dari dalam direktori
hybrid-files
:openssl req -nodes -new -x509 -keyout ./certs/keystore.key -out \ ./certs/keystore.pem -subj '/CN='$DOMAIN'' -days 3650
Dengan
DOMAIN
sama dengan yang Anda gunakan untuk lingkungan di Bagian 1, Langkah 5: Buat grup lingkungan.Perintah ini membuat pasangan kunci/sertifikat yang ditandatangani sendiri yang dapat Anda gunakan untuk penginstalan quickstart.
-
Periksa untuk memastikan file berada di direktori
./certs
menggunakan perintah berikut:ls ./certs
keystore.pem keystore.keyDengan
keystore.pem
adalah file sertifikat TLS yang ditandatangani sendiri dankeystore.key
adalah file kunci.
Sekarang Anda memiliki akun layanan dan kredensial yang diperlukan untuk mengelola Apigee hybrid di cluster Kubernetes. Selanjutnya, Anda akan membuat file yang digunakan oleh Kubernetes untuk men-deploy komponen runtime campuran ke cluster.
1 2 3 4 5 (BERIKUTNYA) Langkah 6: Konfigurasikan runtime campuran 7