Menginstal dan menggunakan Cloud Tools for PowerShell

1. Ringkasan

PowerShell adalah shell command line dan bahasa skrip terkait yang dibangun di .NET Framework. Ini adalah alat otomatisasi tugas dan manajemen konfigurasi default yang digunakan di Windows. Cmdlet PowerShell adalah perintah ringan yang dipanggil dalam PowerShell.

Cloud Tools for PowerShell adalah kumpulan cmdlet untuk mengakses dan memanipulasi resource Google Cloud seperti Google Compute Engine, Google Cloud Storage, Google Cloud SQL, dan Google Cloud DNS —dan akan ada lebih banyak lagi.

Ikuti lab ini untuk mempelajari cara berinteraksi dengan resource Google Cloud dari PowerShell.

Yang akan Anda pelajari

  • Cara menginstal Cloud Tools for PowerShell.
  • Cara melakukan autentikasi dengan Google Cloud SDK.
  • Cara membuat dan mengelola Google Compute Engine dari PowerShell.
  • Cara mencadangkan data ke Google Cloud Storage dari PowerShell.

Yang Anda butuhkan

  • Project Google Cloud Platform.
  • Browser, seperti Chrome atau Firefox.
  • Komputer Windows.

Bagaimana Anda akan menggunakan tutorial ini?

Hanya membacanya Membacanya dan menyelesaikan latihan

Bagaimana penilaian Anda terhadap pengalaman dengan Google Cloud Platform?

Pemula Menengah Mahir

2. Penyiapan dan Persyaratan

Untuk codelab ini, Anda memerlukan project Google Cloud untuk berinteraksi dengan PowerShell. Jika sudah memiliki project, Anda dapat menggunakannya atau membuat project baru menggunakan langkah-langkah berikut.

Penyiapan lingkungan mandiri

Jika belum memiliki Akun Google (Gmail atau GSuite), Anda harus membuatnya. Login ke Konsol Google Cloud ( console.cloud.google.com) dan buat project baru:

aa2b71cbc7c28c59.png

60b154eb0fd9569a.png

Ingat project ID, nama unik di semua project Google Cloud Platform. Project ID tersebut selanjutnya akan dirujuk di codelab ini sebagai PROJECT_ID.

Selanjutnya, Anda harus mengaktifkan penagihan di Konsol Google Cloud untuk menggunakan resource Google Cloud Platform seperti Google Cloud Datastore dan Cloud Storage.

Pengguna baru Google Cloud Platform memenuhi syarat untuk mendapatkan uji coba gratis senilai$300. Menjalankan codelab ini tidak akan menghabiskan biaya lebih dari beberapa dolar, tetapi bisa lebih jika Anda memutuskan untuk menggunakan lebih banyak resource atau jika Anda membiarkannya berjalan (lihat bagian "pembersihan" di akhir dokumen ini).

3. Penginstalan

Penginstalan lingkungan mandiri

Cmdlet PowerShell disertakan sebagai bagian dari Cloud SDK for Windows. Jika Anda belum melakukannya, download dan instal Google Cloud SDK untuk Windows, seperti yang dijelaskan dalam panduan Mulai Cepat untuk Windows. Pastikan Anda telah mencentang opsi PowerShell saat menginstal Cloud SDK.

d6df1af5b5b08e41.png

4. Autentikasi

Cloud Tools for PowerShell menggunakan kredensial dan setelan yang disimpan di Cloud SDK. Jadi, untuk mulai menggunakan cmdlet, Anda harus login terlebih dahulu menggunakan Cloud SDK.

Autentikasi lingkungan mandiri

Mulai Google Cloud SDK Shell dan jalankan perintah berikut.

gcloud init

Terima opsi untuk login menggunakan akun pengguna Google Anda.

To continue, you must log in. Would you like to log in (Y/n)? Y

Di browser, login ke akun pengguna Google Anda saat diminta dan klik Izinkan untuk memberikan izin akses ke resource Google Cloud Platform.

Di command prompt, pilih project Cloud Platform dari daftar project tempat Anda memiliki izin Pemilik, Editor, atau Pelihat.

Pick a cloud project to use:
[1] [my-project-1]
[2] [my-project-2]
...
Please enter your numeric choice:

5. Menjalankan cmdlet Google Cloud dalam PowerShell

Setelah diautentikasi, Anda siap menggunakan cmdlet Google Cloud dalam PowerShell. Cari dan buka shell command line PowerShell.

66b0c5d9b1cd7c68.png

Untuk memastikan cmdlet Google Cloud diinstal dengan benar, jalankan cmdlet Get-GceInstance. Perintah ini akan mencantumkan instance Compute Engine yang Anda miliki di project Anda.

3ffd420f66f76b06.png

6. Membuat dan Mengelola instance Google Compute Engine

Di bagian ini, Anda akan membuat dan mengelola Google Compute Engine dari dalam Google Cloud Tools for PowerShell.

Membuat konfigurasi instance

Sebelum membuat instance, Anda harus membuat konfigurasi instance terlebih dahulu. Setidaknya, Anda memerlukan nama, jenis mesin, dan image boot disk atau boot disk yang sudah ada. Gunakan Get-GceImage untuk membuat image disk dan New-GceInstanceConfig untuk membuat konfigurasi.

$disk = Get-GceImage "windows-cloud" -Family "windows-2012-r2"
$config = New-GceInstanceConfig "my-vm-1" `
    -MachineType "n1-standard-4" `
    -DiskImage $disk

Pada tahap ini, Anda memiliki konfigurasi yang dapat digunakan untuk membuat instance.

Buat instance

Gunakan cmdlet Add-GceInstance untuk membuat instance Compute Engine baru. Anda dapat menentukan project dan zona, tetapi jika tidak ditentukan, nilai parameter akan ditetapkan secara default ke nilai dalam konfigurasi Cloud SDK aktif Anda saat ini. Jika Anda menentukan project, pastikan untuk mengganti PROJECT_ID dengan project ID Anda sendiri.

$config | Add-GceInstance -Project PROJECT_ID -Zone europe-west1-b

Mengelola instance

Anda dapat menggunakan cmdlet Get-GceInstance untuk mengambil instance virtual machine project. Karena nama instance mungkin tidak unik di seluruh project atau zona, Anda dapat menentukan parameter Project atau Zona untuk mempersempit penelusuran. Secara default, cmdlet menggunakan nilai apa pun yang ada dalam konfigurasi Cloud SDK aktif.

$instance = Get-GceInstance "my-vm-1"

Anda dapat menetapkan tag instance, disk, konfigurasi akses, dan metadata lainnya setelah membuat instance dengan cmdlet Set-GceInstance. Tambahkan beberapa metadata, lalu hapus seperti berikut.

Set-GceInstance $instance -AddMetadata @{"newKey" = "newValue"}
Set-GceInstance $instance -RemoveMetadata "newKey"
Set-GceInstance $instance -RemoveTag "beta" -AddTag "alpha"

Sekarang, tambahkan tag yang akan Anda gunakan nanti untuk menghapus instance.

Set-GceInstance $instance -AddTag "to-be-removed"

Anda dapat memulai, menghentikan, atau memulai ulang instance menggunakan berbagai cmdlet. Anda dapat merujuk ke instance menggunakan nama atau objek berjenis kuat yang ditampilkan dari cmdlet Get-GceInstance. Coba beberapa perintah ini.

Stop-GceInstance $instance
Start-GceInstance $instance
Restart-GceInstance "my-vm-1"

Terakhir, setelah selesai menggunakan instance, hapus instance tersebut dari Compute Engine menggunakan cmdlet Remove-GceInstance dan berikan tag yang Anda tentukan sebelumnya.

Get-GceInstance -Project $project |
    Where { $_.Tags.Items -contains "to-be-removed" } |
    Remove-GceInstance -WhatIf

7. Mencadangkan data ke Google Cloud Storage

Di bagian codelab ini, Anda akan mencadangkan data dari mesin lokal ke Google Cloud Storage menggunakan Cloud Tools for PowerShell.

Membuat bucket

Sebelum mengupload file ke Cloud Storage, Anda harus membuat bucket. Gunakan cmdlet New-GcsBucket untuk membuat bucket baru.

$bucket = "my-gcs-bucket"
New-GcsBucket $bucket

Mengupload file ke bucket

Anda dapat menggunakan New-GcsObject untuk mengupload file atau seluruh folder ke bucket.

Anda dapat mengupload konten file lokal ke Cloud Storage menggunakan parameter -File dan menentukan jalur file. Atau, Anda dapat meneruskan konten objek sebagai string melalui pipeline PowerShell, atau Anda dapat menggunakan parameter -Value.

Pilih file lokal di komputer Anda dan upload ke bucket Anda seperti berikut.

New-GcsObject -Bucket "my-gcs-bucket" -File "C:\path\to\some\file\hello.txt"

Anda dapat mengupload seluruh direktori dari disk lokal ke Cloud Storage dengan menggunakan parameter -UploadFolder dan menentukan jalur folder. Jika Anda tidak ingin folder diupload langsung ke root bucket Cloud Storage, gunakan -ObjectNamePrefix untuk menentukan awalan yang akan diterapkan ke setiap objek yang diupload.

Pilih folder lokal di komputer Anda dan upload ke bucket Anda seperti berikut.

New-GcsObject -Bucket "my-gcs-bucket" -Folder "C:\path\to\some\folder"

Menelusuri data

Anda dapat menelusuri data dengan cmdlet, atau dengan penyedia melalui cmdlet penelusuran file umum. Coba perintah berikut dengan bucket Anda.

Get-GcsObject $bucket | Select Name, Size | Out-GridView

Anda akan melihat pop-up petak dengan nama dan ukuran.

59d92a6bfec86f89.png

Membaca data

Anda dapat menggunakan cmdlet Read-GcsObject untuk membaca data. Sebagai contoh, Anda dapat menggunakan perintah berikut untuk membaca file bernama hello.txt ke desktop Anda.

Read-GcsObject $bucket "hello.txt" `
    -OutFile "$Env:UserProfile\Desktop\hello.txt"

Menghapus data

Terakhir, Anda dapat menghapus data menggunakan cmdlet Remove-GcsObject. Gunakan perintah berikut untuk menghapus semua konten bucket.

Get-GcsObject $bucket | Remove-GcsObject

8. Selamat!

Dalam codelab ini, Anda telah mempelajari cara mengelola instance Compute Engine dan bucket Cloud Storage dari PowerShell, tetapi masih ada lagi! Anda juga dapat mengelola resource Cloud SQL dan Cloud CDN menggunakan PowerShell. Lihat daftar langkah berikutnya di bawah untuk mempelajari lebih lanjut.

Yang telah kita bahas

  • Cara menginstal Cloud Tools for PowerShell.
  • Cara melakukan autentikasi dengan Google Cloud SDK.
  • Cara membuat dan mengelola Google Compute Engine dari PowerShell.
  • Cara mencadangkan data ke Google Cloud Storage dari PowerShell.

Langkah Berikutnya