Langkah 5: Buat kredensial dan akun layanan

Saat ini Anda sedang melihat versi 1.4 dokumentasi hybrid Apigee. This version is end of life. You should upgrade to a newer version. Untuk informasi lebih lanjut, lihat Versi yang didukung.

Version 1.4 (unsupported)

Versi yang didukung:

• v1.12 (terbaru)                        
• v1.11                         
• v1.10                                        
• Daftar versi yang didukung

Versi yang tidak didukung:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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 agar komponen hybrid dapat berkomunikasi dengan melakukan panggilan API yang diotorisasi.

Pada langkah ini, Anda akan menggunakan alat command line hybrid Apigee untuk membuat sekumpulan akun layanan dan mendownload file kunci pribadi akun layanan.

Untuk mempelajari lebih lanjut akun layanan dan membaca daftar lengkap akun layanan yang direkomendasikan untuk lingkungan produksi, lihat artikel berikut:

• Tentang akun layanan
• Akun dan peran layanan yang digunakan oleh komponen campuran

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 yang terkait, lihat Membuat dan mengelola akun layanan serta Membuat dan mengelola kunci akun layanan.

1. Pastikan Anda berada di direktori base_directory/hybrid-files yang Anda konfigurasikan di bagian Menyiapkan struktur direktori project.
2. Jalankan perintah berikut dari dalam direktori hybrid-files. Perintah ini membuat akun layanan untuk komponen apigee-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 tersebut dibuat, maka alat tersebut hanya akan membuatnya, dan Anda tidak perlu melakukan 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.
   

3. 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

   Catatan: Cloud Pub/Sub API harus diaktifkan di project Google Cloud yang memiliki akun layanan untuk Synchronizer. Lihat Mengaktifkan API.
4. Pastikan kunci akun layanan telah dibuat menggunakan perintah berikut. Anda bertanggung jawab 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

Tips: Apigee Hybrid menyertakan validator yang memeriksa izin dan file utama akun layanan saat apigeectl menerapkan komponen runtime hybrid Apigee ke cluster Anda. Validasi ini diaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat Validasi akun layanan.

Membuat sertifikat TLS

Anda harus menyediakan sertifikat TLS untuk gateway masuk runtime dalam konfigurasi hybrid 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.

Catatan: Dalam lingkungan produksi, Anda harus menggunakan sertifikat yang ditandatangani. Anda dapat menggunakan sertifikat dan pasangan kunci atau rahasia Kubernetes. Untuk contoh cara mendapatkan sertifikat TLS dari certificate authority (CA) Lets Encrypt, lihat Mendapatkan kredensial TLS: Contoh.

Pada langkah ini, Anda akan membuat file kredensial TLS dan menambahkannya ke direktori base_directory/hybrid-files/certs. Pada Langkah 6: Konfigurasikan cluster, Anda akan menambahkan jalur file ke file konfigurasi cluster.

1. Pastikan Anda berada di direktori base_directory/hybrid-files yang Anda konfigurasi di Menyiapkan struktur direktori project.
2. Pastikan untuk menyimpan nama domain ke variabel lingkungan DOMAIN menggunakan perintah berikut:

   echo $DOMAIN

3. 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 Anda di Bagian 1, Langkah 5: Buat grup lingkungan.

   Perintah ini membuat pasangan sertifikat/kunci yang ditandatangani sendiri yang dapat Anda gunakan untuk penginstalan panduan memulai.

4. Periksa untuk memastikan file berada dalam direktori ./certs menggunakan perintah berikut:

   ls ./certs
     keystore.pem
     keystore.key

   Dengan keystore.pem adalah file sertifikat TLS yang ditandatangani sendiri dan keystore.key adalah file kunci.

Anda sekarang 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 hybrid ke cluster.

1 2 3 4 5 (NEXT) Langkah 6: