Dokumen ini menjelaskan cara mengonfigurasi izin Google Cloud dan Cloud Storage menggunakan Aplikasi Penyiapan Cloud Peralatan.
Aplikasi Penyiapan Cloud Appliance akan meminta informasi, seperti ID sesi transfer, bucket Cloud Storage tujuan, dan preferensi Cloud Key Management Service (Cloud KMS). Dengan menggunakan informasi yang Anda berikan, Aplikasi Penyiapan Cloud Appliance akan mengonfigurasi izin Google Cloud, bucket Cloud Storage pilihan, dan kunci Cloud KMS untuk transfer Anda.
Sebelum memulai
Pastikan Anda memiliki:
Nama project dan lokasi bisnis yang digunakan untuk memesan perangkat.
ID Appliance, ID sesi, nama bucket, awalan bucket, dan kunci enkripsi yang ditentukan saat memesan appliance. Informasi ini dapat ditemukan dalam email berjudul Google Transfer Appliance Prepare Permissions and Storage.
Agen layanan Storage Transfer Service yang tercantum dalam email berjudul Google Transfer Appliance Prepare Permissions and Storage. Tampilannya serupa dengan contoh berikut:
project-TENANT_IDENTIFIER@storage-transfer-service.
Dalam contoh ini,
TENANT_IDENTIFIER
adalah nomor yang dihasilkan khusus untuk project tertentu ini.Kami menggunakan Storage Transfer Service untuk mentransfer data dari appliance ke bucket Cloud Storage Anda.
Menetapkan peran IAM
Anda harus memiliki peran IAM yang benar di project dan bucket Cloud Storage.
Jika Anda adalah pemilik project, roles/owner
sudah cukup. Langsung ke bagian berikutnya, Mendownload Aplikasi Penyiapan Cloud Appliance.
Jika tidak memiliki roles/owner
, Anda harus memiliki peran berikut:
roles/serviceusage.serviceUsageAdmin
: Untuk mengaktifkan API yang diperlukan dalam project.roles/iam.serviceAccountCreator
: Untuk membuat akun layanan baru.roles/iam.serviceAccountKeyAdmin
: Untuk membuat dan mendownload kunci akun layanan. Dapat diberikan di tingkat project, atau dapat diberikan ke akun layanan Appliance setelah dibuat oleh aplikasi izin.roles/storagetransfer.admin
: Untuk membuat akun layanan Storage Transfer Service.roles/transferappliance.viewer
: Untuk mengambil bucket Cloud Storage dan detail kunci Cloud Key Management Service.roles/storage.admin
: Dapat diberikan di tingkat project jika Anda belum membuat bucket Cloud Storage, atau dapat diberikan di tingkat bucket jika Anda menggunakan bucket Cloud Storage yang ada.roles/cloudkms.admin
: Dapat diberikan di tingkat project jika Anda belum membuat kunci Cloud KMS, atau dapat diberikan di tingkat kunci jika Anda menggunakan kunci Cloud KMS yang ada.
Melihat peran
Untuk melihat peran IAM yang dimiliki akun utama Anda untuk project dan resource-nya, lakukan tindakan berikut:
Di konsol Google Cloud, buka halaman IAM.
Halaman ini menampilkan semua akun utama yang memiliki peran IAM di project Anda.
Mendownload Aplikasi Penyiapan Cloud Appliance
Untuk mendownload Aplikasi Penyiapan Cloud Appliance:
Buka halaman Sambutan konsol Google Cloud.
Pastikan nama project yang digunakan untuk transfer ditampilkan di pemilih project. Pemilih project memberi tahu Anda project yang sedang dikerjakan.
Jika Anda tidak melihat nama project yang digunakan untuk transfer, klik pemilih project, lalu pilih project yang benar.
Klik Aktifkan Cloud Shell.
Di Cloud Shell, gunakan perintah
wget
untuk mendownload Aplikasi Penyiapan Cloud Appliance:wget https://storage.googleapis.com/transferappliance/cloudsetup/ta_cloudsetup_x86_64-linux -O ta_cloudsetup_x86_64-linux
Menjalankan Aplikasi Penyiapan Cloud Appliance
Di Cloud Shell, jalankan perintah berikut untuk memulai Aplikasi Penyiapan Cloud Appliance:
chmod 0777 ta_cloudsetup_x86_64-linux && ./ta_cloudsetup_x86_64-linux
Aplikasi akan memandu Anda melalui langkah-langkah yang diperlukan untuk mengonfigurasi project.
Output aplikasi
Aplikasi Penyiapan Cloud Appliance menyelesaikan tindakan berikut:
- Memberikan izin ke akun layanan Appliance yang digunakan untuk mentransfer data ke bucket Cloud Storage Anda.
- Jika Anda memilih untuk menggunakan kunci enkripsi yang dikelola pelanggan, berikan izin ke akun layanan Appliance untuk mengakses data kunci Cloud KMS.
Menampilkan informasi berikut:
- Nama resource kunci kriptografis Google Cloud, jika Anda memilih untuk menggunakan kunci enkripsi Cloud KMS yang dikelola pelanggan.
- Nama bucket tujuan Google Cloud Storage.
- Awal bucket tujuan Google Cloud Storage, jika Anda menyediakannya.
- Jika berlaku, nama akun layanan Transfer Online, dan nama agen layanan Storage Transfer Service.
Informasi yang ditampilkan juga disimpan dalam direktori beranda di Cloud Shell, bernama SESSION_ID-output.txt
, dengan SESSION_ID
adalah ID sesi untuk transfer khusus ini.
Nama akun layanan yang diberi izin untuk transfer khusus ini disimpan dalam direktori beranda di Cloud Shell, yang bernama cloudsetup.log
.
Mengirim informasi CMEK ke Google
Jika Anda menentukan kunci enkripsi yang dikelola pelanggan, kirimkan informasi kunci kepada kami dengan melengkapi formulir yang ditautkan dari email berjudul Google Transfer Appliance Prepare Permissions and Storage.
Mendownload kunci akun layanan
Download dan simpan kunci akun layanan untuk Akun Layanan Transfer Online.
gcloud iam service-accounts keys create key.json \ --iam-account=APPLIANCE_SERVICE_ACCOUNT_EMAIL
Nilai APPLIANCE_SERVICE_ACCOUNT_EMAIL ditampilkan dalam output aplikasi izin:
...
Appliance Service Account Name:
example-sa@example-project.
Saat Anda menerima appliance, upload kunci ke direktori /tmp
di
appliance.
Pemecahan masalah
Error 400: Akun layanan tidak ada
Masalah:
Aplikasi Penyiapan Cloud Appliance menampilkan pesan berikut:
Service account ta-SESSION_ID@transfer-appliance-zimbru. does not exist.
Dengan SESSION_ID
adalah ID sesi yang diberikan ke
Aplikasi Penyiapan Cloud Appliance.
Solusi:
Verifikasi ID sesi untuk transfer Anda. ID sesi bersifat unik untuk setiap sesi transfer dan dibagikan oleh Tim Transfer Appliance. Jika Anda belum menerima ID sesi, hubungi data-support@google.com.
Error: Mencantumkan lokasi KMS
Masalah:
Aplikasi Penyiapan Cloud Appliance menampilkan pesan berikut:
Error: listing kms locations
Solusi:
Lakukan hal berikut dalam Cloud Shell:
Lakukan autentikasi ulang dengan menjalankan
gcloud auth login
.Coba lagi Aplikasi Penyiapan Cloud Appliance.
Jika error tetap berlanjut, hubungi Tim Transfer Appliance di data-support@google.com.
Error: Membuat error batasan kunci Cloud KMS
Masalah:
Aplikasi Penyiapan Cloud Appliance akan menampilkan pesan yang mirip dengan berikut ini:
Error: creating cloud kms key violates constraint error: code = FailedPrecondition desc= europe-west6 violates constraint 'constraints/gcp.resourceLocations' on the resource 'projects/test/locations/europe-west6'
Solusi:
Project Google Cloud Anda mungkin memiliki kebijakan organisasi yang tidak mengizinkan pembuatan kunci Cloud Key Management Service di lokasi tertentu. Berikut adalah kemungkinan solusinya:
- Pilih lokasi lain untuk membuat kunci Cloud Key Management Service.
- Perbarui kebijakan organisasi untuk mengizinkan pembuatan kunci Cloud Key Management Service di lokasi yang Anda inginkan.
Untuk informasi selengkapnya, lihat Membatasi Lokasi Resource.