Menyiapkan lingkungan pengembangan Ruby

Tutorial ini menunjukkan cara menyiapkan mesin lokal untuk Ruby pengembangan, 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

  • Menginstal Ruby.
  • Menginstal Bundler.
  • Menginstal editor (opsional).
  • Menginstal Google Cloud CLI.
  • Menginstal 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. Tutorial ini berlaku untuk versi Ruby stabil dan non-end-of-life (EOL) yang tercantum di Ruby-lang.

macOS

Sebaiknya gunakan rbenv untuk mengelola penginstalan Ruby di macOS. rbenv mengelola beberapa penginstalan versi Ruby di mesin 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 update dan menghindari konflik dengan penggunaan versi default sistem operasi.

  1. Instal XCode.
  2. Instal alat command line XCode 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 dalam readme rbenv. Penginstalan homebrew mencakup 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 mesin Anda dan plugin rbenv bernama ruby-build menambahkan dukungan ke rbenv untuk menginstal versi Ruby tertentu.

  1. Instal rbenv di distribusi Linux menggunakan rbenv readme.

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

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 menggunakan file untuk menentukan gem dan versi yang diperlukan. Google CloudGemfile

  1. Instal Bundler.

    gem install bundler
    
  2. Instal dependensi gem yang ditentukan dalam Gemfile.

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

    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 CloudAlat ini berisi gcloud dan bq, yang dapat Anda gunakan untuk mengakses Compute Engine, Cloud Storage, BigQuery, serta produk dan 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 akan 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.

Menginstal Library Klien Cloud untuk Ruby

Library Klien Cloud untuk Ruby adalah cara idiomatis bagi developer Ruby untuk berintegrasi dengan Google Cloud layanan. Anda dapat menginstal paket untuk API individual, 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 melakukannya 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