Halaman ini menjelaskan akun layanan dan cakupan akses VM serta cara penggunaannya dengan Managed Service untuk Apache Spark.
Persyaratan keamanan mulai 3 Agustus 2020: Pengguna Managed Service untuk Apache Spark harus memiliki izin akun layanan ActAs untuk men-deploy resource Managed Service untuk Apache Spark, seperti membuat cluster dan mengirimkan tugas. Peran
Service Account User memiliki izin ini. Lihat Peran untuk autentikasi akun layanan
untuk mengetahui informasi tentang peran Managed Service untuk Apache Spark yang diperlukan.
Memilih ikut serta untuk pengguna Managed Service untuk Apache Spark yang sudah ada: Pengguna Managed Service untuk Apache Spark yang sudah ada pada 3 Agustus 2020 dapat memilih ikut serta dalam persyaratan keamanan ini (lihat Mengamankan Managed Service untuk Apache Spark, Dataflow, dan Cloud Data Fusion).
Apa yang dimaksud dengan akun layanan?
Akun layanan adalah akun khusus yang dapat digunakan oleh layanan dan aplikasi yang berjalan di instance virtual machine (VM) Compute Engine untuk berinteraksi dengan API Google Cloud lainnya. Aplikasi dapat menggunakan kredensial akun layanan untuk mengizinkan dirinya sendiri ke serangkaian API dan melakukan tindakan di VM dalam izin yang diberikan ke akun layanan.
Akun layanan cluster Managed Service untuk Apache Spark
Akun layanan berikut harus memiliki izin yang diperlukan untuk melakukan tindakan Managed Service untuk Apache Spark di project tempat cluster Anda berada.
Akun layanan VM Managed Service untuk Apache Spark
VM di cluster Managed Service untuk Apache Spark menggunakan akun layanan untuk
operasi bidang data Managed Service untuk Apache Spark.
Akun layanan default Compute Engine,
project_number-compute@developer.gserviceaccount.com, digunakan sebagai akun layanan VM kecuali jika Anda menentukan
akun layanan kustom
saat membuat cluster. Akun layanan VM harus memiliki peran Managed Service untuk Apache Spark Worker, yang mencakup izin yang diperlukan untuk operasi bidang data Managed Service untuk Apache Spark. Untuk mengetahui informasi selengkapnya, lihat
Peran Managed Service untuk Apache Spark.
Melihat peran akun layanan VM
Untuk melihat peran yang diberikan ke akun layanan VM Managed Service untuk Apache Spark, lakukan hal berikut:
Di konsol Google Cloud , buka halaman IAM.
Klik Sertakan pemberian peran yang disediakan Google.
Lihat peran yang tercantum untuk akun layanan VM. Gambar berikut menunjukkan peran Dataproc Worker yang diperlukan yang tercantum untuk akun layanan default Compute Engine (
project_number-compute@developer.gserviceaccount.com) yang digunakan Managed Service untuk Apache Spark secara default sebagai akun layanan VM.
Anda dapat mengklik ikon pensil yang ditampilkan di baris akun layanan untuk memberikan atau menghapus peran akun layanan.
Akun layanan Agen Layanan Managed Service untuk Apache Spark
Managed Service untuk Apache Spark membuat
akun layanan Agen Layanan,
service-project_number@dataproc-accounts.iam.gserviceaccount.com, dan memberikan peran
Agen Layanan Managed Service untuk Apache Spark
kepada akun layanan di project Google Cloud . Akun layanan ini melakukan operasi bidang kontrol Managed Service untuk Apache Spark, seperti pembuatan, update, dan penghapusan VM cluster. Anda tidak dapat mengganti akun layanan ini dengan akun layanan VM kustom saat membuat cluster.
Pemberian peran ke akun layanan Agen Layanan di jaringan VPC Bersama
Jika cluster Managed Service untuk Apache Spark menggunakan jaringan VPC Bersama, Admin VPC Bersama harus memberikan peran Network User kepada akun layanan Agen Layanan Managed Service untuk Apache Spark untuk project host VPC Bersama. Untuk informasi selengkapnya, lihat referensi berikut:
- Membuat cluster yang menggunakan jaringan VPC di project lain
- Dokumentasi VPC Bersama: mengonfigurasi akun layanan sebagai Admin Project Layanan
Membuat cluster dengan akun layanan VM kustom
Saat membuat cluster, Anda dapat menentukan akun layanan VM kustom yang akan digunakan cluster Anda untuk operasi bidang data Managed Service untuk Apache Spark, bukan akun layanan VM default (Anda tidak dapat mengubah akun layanan VM setelah cluster dibuat). Dengan menggunakan akun layanan VM yang diberi peran IAM, Anda dapat memberikan akses terperinci ke resource project untuk cluster Anda.
Langkah-langkah awal
Buat akun layanan VM kustom dalam project tempat cluster akan dibuat.
Berikan peran Managed Service untuk Apache Spark Worker ke akun layanan VM kustom di project dan peran tambahan yang diperlukan oleh tugas Anda, seperti peran BigQuery Reader and Writer (lihat peran Managed Service untuk Apache Spark).
Contoh gcloud CLI:
- Contoh perintah berikut memberikan peran Dataproc Worker di tingkat project kepada akun layanan VM kustom di project cluster:
gcloud projects add-iam-policy-binding CLUSTER_PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role="roles/dataproc.worker"
- Pertimbangkan peran khusus: Daripada memberikan peran Pekerja Dataproc bawaan (
roles/dataproc.worker) kepada akun layanan, Anda dapat memberikan peran khusus yang berisi izin peran Pekerja, tetapi membatasi izinstorage.objects.*.- Peran kustom setidaknya harus memberikan izin
storage.objects.create,storage.objects.get, danstorage.objects.updateakun layanan VM pada objek di bucket penyiapan dan sementara Managed Service untuk Apache Spark dan pada bucket tambahan yang diperlukan oleh tugas yang akan berjalan di cluster.
- Peran kustom setidaknya harus memberikan izin
Membuat cluster
- Buat cluster di project Anda.
KonsolGoogle Cloud
Menetapkan akun layanan VM Managed Service untuk Apache Spark di konsol tidak didukung.
Untuk menetapkan cakupan akses cloud-platform pada VM cluster saat Anda membuat cluster:
- Buka halaman Create cluster.
- Klik Konfigurasi tambahan untuk meluaskan bagian tersebut.
- Edit Keamanan.
- Di panel yang terbuka, pada bagian Project access, centang kotak Enables the cloud-platform scope for this cluster.
gcloud CLI
Gunakan perintah gcloud dataproc clusters create untuk membuat cluster dengan akun layanan VM kustom.
gcloud dataproc clusters create CLUSTER_NAME \ --region=REGION \ --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --scopes=SCOPE
Ganti kode berikut:
- CLUSTER_NAME: Nama cluster, yang harus unik dalam project. Nama harus diawali dengan huruf kecil, dan dapat berisi hingga 51 huruf kecil, angka, dan tanda hubung. Tidak boleh diakhiri dengan tanda hubung. Nama cluster yang dihapus dapat digunakan kembali.
- REGION: Region tempat cluster akan berada.
- SERVICE_ACCOUNT_NAME: Nama akun layanan.
- PROJECT_ID: Google Cloud Project ID project yang berisi akun layanan VM Anda. Ini akan menjadi ID project tempat cluster Anda akan dibuat atau ID project lain jika Anda membuat cluster dengan akun layanan VM kustom di project lain.
- SCOPE: Cakupan akses untuk instance VM cluster (misalnya,
https://www.googleapis.com/auth/cloud-platform).
REST API
Saat menyelesaikan
GceClusterConfig
sebagai bagian dari permintaan API
clusters.create, tetapkan kolom berikut:
serviceAccount: Akun layanan akan berada di project tempat cluster Anda akan dibuat, kecuali jika Anda menggunakan akun layanan VM dari project lain.serviceAccountScopes: Tentukan cakupan akses untuk instance VM cluster (misalnya,https://www.googleapis.com/auth/cloud-platform).
Membuat cluster dengan akun layanan VM kustom dari project lain
Saat membuat cluster, Anda dapat menentukan akun layanan VM kustom yang akan digunakan cluster untuk operasi bidang data Managed Service untuk Apache Spark, bukan menggunakan akun layanan VM default (Anda tidak dapat menentukan akun layanan VM kustom setelah cluster dibuat). Dengan menggunakan akun layanan VM kustom dengan peran IAM yang ditetapkan, Anda dapat memberikan akses yang lebih terperinci ke resource project untuk cluster Anda.
Langkah-langkah awal
Di project akun layanan (project tempat akun layanan VM kustom berada):
Mengaktifkan akun layanan untuk dilampirkan di seluruh project.
Mengaktifkan Dataproc API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin
serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.
Berikan peran Service Account User ke akun email Anda (pengguna yang membuat cluster) di project akun layanan atau, untuk kontrol yang lebih terperinci, akun layanan VM kustom di project akun layanan.
Untuk mengetahui informasi selengkapnya: Lihat Mengelola akses ke project, folder, dan organisasi untuk memberikan peran di tingkat project dan Mengelola akses ke akun layanan untuk memberikan peran di tingkat akun layanan.
Contoh gcloud CLI:
- Contoh perintah berikut memberikan peran Service Account User kepada pengguna di tingkat project:
gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \ --member=USER_EMAIL \ --role="roles/iam.serviceAccountUser"
Catatan:
USER_EMAIL: Berikan alamat email akun pengguna Anda, dalam format:user:user-name@example.com.- Contoh perintah berikut memberikan peran Service Account User kepada pengguna di tingkat akun layanan:
gcloud iam service-accounts add-iam-policy-binding VM_SERVICE_ACCOUNT_EMAIL \ --member=USER_EMAIL \ --role="roles/iam.serviceAccountUser"
Catatan:
USER_EMAIL: Berikan alamat email akun pengguna Anda, dalam format:user:user-name@example.com.Beri akun layanan VM kustom peran Managed Service untuk Apache Spark Worker di project cluster.
Contoh gcloud CLI:
gcloud projects add-iam-policy-binding CLUSTER_PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com \ --role="roles/dataproc.worker"
Berikan peran Managed Service untuk Apache Spark Service Agent service account di project cluster Service Account User dan Service Account Token Creator di project akun layanan atau, untuk kontrol yang lebih terperinci, akun layanan VM kustom di project akun layanan. Dengan melakukannya, Anda mengizinkan akun layanan agen layanan Dataproc di project cluster untuk membuat token bagi akun layanan VM Dataproc kustom di project akun layanan.
Untuk mengetahui informasi selengkapnya: Lihat Mengelola akses ke project, folder, dan organisasi untuk memberikan peran di tingkat project dan Mengelola akses ke akun layanan untuk memberikan peran di tingkat akun layanan.
Contoh gcloud CLI:
- Contoh perintah berikut memberikan peran Service Account User dan Service Account Token Creator di tingkat project kepada akun layanan Managed Service untuk Apache Spark Service Agent di project cluster:
gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@dataproc-accounts.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountUser"
gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@dataproc-accounts.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountTokenCreator"
- Contoh perintah berikut memberikan peran Service Account User dan Service Account Token Creator kepada akun layanan Managed Service untuk Apache Spark Service Agent di project cluster pada tingkat akun layanan VM:
gcloud iam service-accounts add-iam-policy-binding VM_SERVICE_ACCOUNT_EMAIL \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@dataproc-accounts.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountUser"
gcloud iam service-accounts add-iam-policy-binding VM_SERVICE_ACCOUNT_EMAIL \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@dataproc-accounts.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountTokenCreator"
Berikan peran Service Account Token Creator kepada akun layanan Agen Layanan Compute Engine di project cluster pada project akun layanan atau, untuk kontrol yang lebih terperinci, akun layanan VM kustom di project akun layanan. Dengan melakukannya, Anda memberikan kemampuan kepada akun layanan Compute Agent Service Agent di project cluster untuk membuat token bagi akun layanan VM Dataproc kustom di project akun layanan.
Untuk mengetahui informasi selengkapnya: Lihat Mengelola akses ke project, folder, dan organisasi untuk memberikan peran di tingkat project dan Mengelola akses ke akun layanan untuk memberikan peran di tingkat akun layanan.
Contoh gcloud CLI:
- Contoh perintah berikut memberikan peran Service Account Token Creator di tingkat project kepada akun layanan Agen Layanan Compute Engine di project cluster:
gcloud projects add-iam-policy-binding SERVICE_ACCOUNT_PROJECT_ID \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@compute-system.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountTokenCreator"
- Contoh perintah berikut memberikan peran Service Account Token Creator kepada akun layanan Agen Layanan Compute Engine di project cluster pada tingkat akun layanan VM:
gcloud iam service-accounts add-iam-policy-binding VM_SERVICE_ACCOUNT_EMAIL \ --member=serviceAccount:service-CLUSTER_PROJECT_NUMBER@compute-system.iam.gserviceaccount.com \ --role="roles/iam.serviceAccountTokenCreator"
Membuat cluster
Langkah berikutnya
- Akun layanan
- Izin Managed Service untuk Apache Spark dan peran IAM
- Principal dan peran Managed Service untuk Apache Spark
- Multi-tenancy Aman Berbasis Akun Layanan Managed Service untuk Apache Spark
- Autentikasi Cluster Pribadi Managed Service untuk Apache Spark
- IAM Terperinci Managed Service untuk Apache Spark