Menyiapkan lingkungan pengembangan Ruby

Tutorial ini menunjukkan cara menyiapkan mesin lokal untuk pengembangan Ruby, termasuk mengembangkan aplikasi Ruby yang berjalan di Google Cloud. Ikuti tutorial ini untuk menginstal Ruby dan alat yang relevan.

Baca Panduan memulai untuk Ruby dan Google Cloud untuk mendapatkan ringkasan Ruby dan mempelajari cara menjalankan aplikasi Ruby di Google Cloud.

Tujuan

  • Instal Ruby.
  • Instal Bundler.
  • Instal editor (opsional).
  • Instal Google Cloud CLI.
  • Instal Library Klien Cloud untuk Ruby.
  • Menyiapkan autentikasi.

Menginstal Ruby

Petunjuk penginstalan Ruby bervariasi menurut sistem operasi. Ikuti panduan untuk sistem operasi yang Anda gunakan di mesin pengembangan lokal Anda. Tutorial ini berlaku untuk versi Ruby stabil dan non-akhir siklus proses (EOL) yang tercantum di Ruby-lang.

macOS

Sebaiknya gunakan rbenv untuk mengelola penginstalan Ruby di macOS. rbenv mengelola beberapa penginstalan versi Ruby di komputer Anda dan plugin rbenv bernama ruby-build menambahkan dukungan ke rbenv untuk menginstal versi Ruby tertentu.

Meskipun macOS menyertakan versi Ruby secara default, sebaiknya lakukan penginstalan terpisah untuk versi Ruby terbaru agar tetap mendapatkan versi terbaru dan menghindari konflik dengan penggunaan versi default oleh sistem operasi.

  1. Instal XCode.

  2. Instal alat command line XCode dengan menggunakan perintah berikut di terminal:

    xcode-select --install

  3. Instal homebrew dengan mengikuti petunjuk di halaman beranda homebrew.

  4. Instal rbenv menggunakan homebrew, dengan mengikuti petunjuk di readme rbenv. Penginstalan homebrew menyertakan plugin ruby-build.

Pelajari lebih lanjut cara menggunakan rbenv dan ruby-build untuk menginstal berbagai versi Ruby.

Linux

Sebaiknya gunakan rbenv untuk mengelola penginstalan Ruby di distribusi Linux. rbenv mengelola beberapa penginstalan versi Ruby di komputer Anda dan plugin rbenv bernama ruby-build menambahkan dukungan ke rbenv untuk menginstal versi Ruby yang ditentukan.

  1. Instal rbenv di distribusi Linux Anda menggunakan readme rbenv.

  2. Instal plugin ruby-build untuk rbenv menggunakan petunjuk dalam file readme ruby-build.

Pelajari lebih lanjut cara menggunakan rbenv dan ruby-build untuk menginstal berbagai versi Ruby.

Windows

Untuk Windows, sebaiknya gunakan salah satu opsi berikut:

Menginstal Bundler

Bundler adalah gem Ruby yang mengelola dependensi gem project yang ditentukan dalam file bernama Gemfile. Contoh Ruby dalam dokumentasi Google Cloudmenggunakan file Gemfile untuk menentukan gem dan versi yang diperlukan.

  1. Instal Bundler.

    gem install bundler

  2. Instal dependensi gem yang ditentukan dalam Gemfile.

    bundle install

  3. Jalankan project Ruby Anda hanya menggunakan gem yang ditentukan dalam Gemfile Anda.

    bundle exec ruby app.rb

Pelajari lebih lanjut cara membuat Gemfile dengan membaca dokumentasi Bundler.

Menginstal editor

Editor populer (tanpa urutan tertentu) yang digunakan untuk mengembangkan aplikasi Ruby mencakup, tetapi tidak terbatas pada:

Editor ini (terkadang dengan bantuan plugin) memberi Anda segalanya mulai dari penyorotan sintaksis, intelli-sense, dan penyelesaian kode hingga kemampuan proses debug yang terintegrasi sepenuhnya, sehingga memaksimalkan efikasi pengembangan Ruby Anda.

Menginstal gcloud CLI

gcloud CLI adalah serangkaian alat untuk Google Cloud. Cloud SDK berisi gcloud dan bq, yang dapat Anda gunakan untuk mengakses Compute Engine, Cloud Storage, BigQuery, dan produk serta layanan lainnya dari command line. Anda dapat menjalankan alat ini secara interaktif atau dalam skrip otomatis.

Sebagai contoh, berikut adalah perintah sederhana yang men-deploy aplikasi web Ruby ke lingkungan fleksibel App Engine. Setelah deployment, App Engine mencoba memulai aplikasi dengan bundle exec ruby app.rb -p 8080:

gcloud app deploy

Pelajari cara men-deploy aplikasi Ruby on Rails ke lingkungan fleksibel App Engine.

Instal Library Klien Cloud untuk Ruby

Library Klien Cloud untuk Ruby adalah cara idiomatis bagi developer Ruby untuk berintegrasi dengan layanan Google Cloud. Anda dapat menginstal paket untuk setiap API, seperti Cloud Storage misalnya:

gem install google-cloud-storage

Anda juga dapat menggunakan Bundler dan menambahkan gem ke dependensi Gemfile, misalnya:

bundle add google-cloud-storage

Menyiapkan autentikasi

Untuk menggunakan Library Klien Cloud di lingkungan pengembangan lokal, siapkan Kredensial Default Aplikasi.

Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

gcloud auth application-default login

Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan library klien.

Langkah berikutnya