create-service-account

Membuat akun layanan Google Cloud Platform dengan peran yang memungkinkan setiap komponen hybrid Apigee membuat panggilan API yang sah dan mendownload file kunci akun layanan terkait. Anda dapat menggunakan file kunci akun layanan yang dihasilkan oleh perintah ini dalam file penggantian konfigurasi Anda.

Alat create-service-account terletak di direktori HYBRID_ROOT_DIR/tools.

Prasyarat

Alat create-service-account mengharuskan CLI gcloud diinstal. Pengguna yang memanggil utilitas harus memiliki peran Service Account Admin.

Untuk memulai, pastikan konfigurasi project gcloud Anda disetel ke project yang Anda buat di Langkah 2: Buat project Google Cloud:

gcloud config list project

Jika Anda perlu mengubah project ID saat ini, gunakan perintah berikut: 

gcloud config set project GC_PROJECT_ID

Dengan GC_PROJECT_ID adalah project yang dibuat di Langkah 2: Buat project Google Cloud.

Sintaksis create-service-account

Alat create-service-account menggunakan sintaksis berikut:

create-service-account HYBRID_SERVICE OUTPUT_DIR [GC_PROJECT_ID]

Dengan:

  • HYBRID_SERVICE: Menentukan layanan hybrid yang menggunakan akun layanan. Nilai yang valid adalah:
    • apigee-cassandra
    • apigee-distributed-trace
    • apigee-logger
    • apigee-mart
    • apigee-metrics
    • apigee-synchronizer
    • apigee-udca
    • apigee-watcher

    Perhatikan bahwa alat create-service-account tidak dapat membuat akun layanan apigee-org-admin. Anda harus membuatnya dengan gcloud API, seperti yang dijelaskan dalam Membuat akun layanan.

  • OUTPUT_DIR: Direktori output tempat menyimpan kunci akun layanan yang didownload.
  • GCP_PROJECT_ID: (Opsional) Menentukan ID project Google Cloud dari project yang terikat ke organisasi yang mendukung hybrid Anda. Jika ID project Google Cloud tidak diberikan, alat akan mencoba mengambilnya dari konfigurasi gcloud saat ini.

Deskripsi mendetail

Alat create-service-account:

  • Membuat akun layanan Google Cloud yang digunakan oleh komponen hybrid. Akun layanan yang dibuat diberi peran yang diperlukan oleh komponen tertentu agar dapat beroperasi.
  • Mendownload kunci akun layanan ke sistem Anda. Anda menempatkan kunci akun layanan di file penggantian konfigurasi hybrid, seperti yang dijelaskan dalam petunjuk penginstalan hybrid.

Alat ini membuat akun layanan untuk komponen berikut:

Komponen* Peran Diperlukan untuk penginstalan dasar? Deskripsi
apigee-cassandra Storage Object Admin
roles/storage.objectAdmin		 Mengizinkan pencadangan Cassandra ke Cloud Storage, seperti yang dijelaskan dalam Pencadangan dan pemulihan.
apigee-distributed-trace Cloud Trace Agent
roles/cloudtrace.agent		 Memungkinkan bidang runtime hybrid berpartisipasi dalam pelacakan permintaan terdistribusi dalam format yang kompatibel dengan sistem seperti Google Cloud Trace dan Jaeger.
apigee-logger Logs Writer
roles/logging.logWriter		 Mengizinkan pengumpulan data logging, seperti yang dijelaskan dalam Logging. Hanya diperlukan untuk penginstalan cluster non-GKE.
apigee-mart Apigee Connect Agent
roles/apigeeconnect.Agent		 Mengizinkan autentikasi layanan MART. Peran Apigee Connect Agent memungkinkan agen berkomunikasi secara aman dengan proses Apigee Connect, seperti yang dijelaskan dalam Menggunakan Apigee Connect.
apigee-metrics Monitoring Metric Writer
roles/monitoring.metricWriter		 Mengizinkan pengumpulan data metrik, seperti yang dijelaskan dalam Ringkasan pengumpulan metrik.
apigee-synchronizer Apigee Synchronizer Manager
roles/apigee.synchronizerManager		 Memungkinkan sinkronisasi mendownload paket proxy dan data konfigurasi lingkungan. Juga memungkinkan pengoperasian fitur rekaman aktivitas.
apigee-udca Apigee Analytics Agent
roles/apigee.analyticsAgent		 Mengizinkan transfer data status deployment, analisis, dan rekaman aktivitas ke bidang pengelolaan.
apigee-watcher Apigee Runtime Agent
roles/apigee.runtimeAgent		 Apigee Watcher menarik perubahan terkait host virtual untuk organisasi dari sinkronisasi dan membuat perubahan yang diperlukan untuk mengonfigurasi ingress istio.
* Nama ini digunakan dalam nama file kunci akun layanan yang didownload.

Anda juga dapat membuat akun layanan di konsol Google Cloud. Lihat juga Membuat dan mengelola akun layanan.

Contoh

Contoh berikut membuat akun layanan baru untuk layanan apigee-logger dan menempatkan kunci yang didownload di direktori ./service-accounts.

./my-hybrid-root/tools/create-service-account apigee-logger ./service-accounts