במדריך הזה נסביר איך להכין את המכונה המקומית לפיתוח ב-Ruby, כולל פיתוח אפליקציות Ruby שפועלות ב- Google Cloud. כדי להתקין את Ruby ואת הכלים הרלוונטיים, פועלים לפי המדריך הזה.
במאמר מדריך למתחילים בנושא Ruby ו- Google Cloud תוכלו לקרוא סקירה כללית על Ruby וללמוד איך להריץ אפליקציות Ruby ב- Google Cloud.
מטרות
- מתקינים את Ruby.
- מתקינים את Bundler.
- מתקינים כלי עריכה (אופציונלי).
- מתקינים את Google Cloud CLI.
- מתקינים את ספריות הלקוח של Cloud לשימוש ב-Ruby.
- מגדירים אימות.
התקנת Ruby
הוראות ההתקנה של Ruby משתנות בהתאם למערכת ההפעלה. פועלים לפי ההוראות במדריך למערכת ההפעלה שבה משתמשים במחשב הפיתוח המקומי. המדריך הזה רלוונטי לגרסאות יציבות של Ruby שלא הגיעו לסוף חיי המוצר (EOL), שמופיעות ב-Ruby-lang.
macOS
מומלץ להשתמש ב-rbenv כדי לנהל את ההתקנות של Ruby ב-macOS. rbenv מנהל התקנות של כמה גרסאות Ruby במכונה, ופלאגין rbenv בשם ruby-build מוסיף תמיכה ל-rbenv כדי להתקין גרסה מסוימת של Ruby.
ב-macOS יש גרסה של Ruby כברירת מחדל, אבל מומלץ להתקין בנפרד את הגרסאות העדכניות של Ruby כדי להישאר מעודכנים ולמנוע התנגשויות עם השימוש של מערכת ההפעלה בגרסת ברירת המחדל שלה.
- מתקינים את XCode.
מתקינים את כלי שורת הפקודה של XCode באמצעות הפקודה הבאה בטרמינל:
xcode-select --installמתקינים את
homebrewלפי ההוראות בדף הבית של Homebrew.מתקינים את
rbenvבאמצעותhomebrew, לפי ההוראות בקובץ rbenv readme. ההתקנה של Homebrew כוללת את הפלאגיןruby-build.
מידע נוסף על שימוש ב-rbenv ועל ruby-build להתקנת גרסאות שונות של Ruby.
Linux
מומלץ להשתמש ב-rbenv כדי לנהל את ההתקנות של Ruby בהפצות של Linux. rbenv מנהל התקנות של כמה גרסאות Ruby במכונה, ופלאגין של rbenv בשם ruby-build מוסיף תמיכה ל-rbenv כדי להתקין גרסה מסוימת של Ruby.
מתקינים את
rbenvבהפצת Linux באמצעות קובץ ה-readme שלrbenv.מתקינים את הפלאגין
ruby-buildל-rbenvלפי ההוראות בקובץ readme שלruby-build.
מידע נוסף על שימוש ב-rbenv וב-ruby-build להתקנת גרסאות שונות של Ruby.
Windows
ב-Windows, מומלץ להשתמש באחת מהאפשרויות הבאות:
התקנת Bundler
Bundler הוא Ruby gem שמנהל את יחסי התלות של gem בפרויקט, שמוגדרים בקובץ בשם Gemfile. הדוגמאות של Ruby במסמכי התיעוד של Google Cloudמשתמשות בקובצי Gemfile כדי לציין את הגרסאות וה-gems הנדרשים.
מתקינים את Bundler.
gem install bundler
מתקינים את יחסי התלות של
gemשמוגדרים ב-Gemfile.bundle install
מריצים את פרויקט Ruby רק באמצעות gems שמוגדרים ב-
Gemfile.bundle exec ruby app.rb
מידע נוסף על יצירת Gemfile זמין במסמכי התיעוד של Bundler.
התקנת עורך
אלו כמה מהעורכים הפופולריים (בסדר אקראי) שמשמשים לפיתוח אפליקציות Ruby:
- Sublime Text מאת Jon Skinner
- Atom של GitHub
- RubyMine של JetBrains
- Vim מאת Vim the editor
עורכי הקוד האלה (לפעמים בעזרת פלאגינים) מספקים לכם את כל מה שאתם צריכים כדי למקסם את יעילות הפיתוח ב-Ruby, החל מהדגשת תחביר, IntelliSense והשלמת קוד ועד ליכולות ניפוי באגים משולבות באופן מלא.
התקנת ה-CLI של gcloud
ה-CLI של gcloud הוא קבוצת כלים ל- Google Cloud. הוא מכיל את gcloud ואת bq, שבעזרתם אפשר לגשת ל-Compute Engine, ל-Cloud Storage, ל-BigQuery ולמוצרים ושירותים אחרים משורת הפקודה. אפשר להריץ את הכלים האלה באופן אינטראקטיבי או בסקריפטים אוטומטיים.
bundle exec ruby app.rb -p 8080:
gcloud app deploy
איך פורסים אפליקציית Ruby on Rails בסביבה הגמישה ב-App Engine
התקנה של ספריית הלקוח של Cloud ל-Ruby
ספריית הלקוח של Cloud ל-Ruby היא הדרך המקובלת למפתחי Ruby לשלב שירותי Google Cloud. אתם יכולים להתקין את החבילה של API ספציפי, כמו Cloud Storage, לדוגמה:
gem install google-cloud-storage
אפשר גם להשתמש ב-Bundler ולהוסיף את ה-gem ליחסי התלות של Gemfile, לדוגמה:
bundle add google-cloud-storage
מגדירים אימות
כדי להשתמש בספריות הלקוח של Cloud בסביבת פיתוח מקומית, צריך להגדיר את Application Default Credentials.
יוצרים פרטי כניסה לאימות מקומי בחשבון המשתמש:
gcloud auth application-default login
אם מופיעה שגיאת אימות, ודאו ש נכנסתם ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף זמין במאמר אימות לצורך שימוש בספריות לקוח.
(אופציונלי) ניראות (observability)
Google Cloud Observability כולל שירותי ניטור שעוזרים לכם להבין את ההתנהגות, התקינות והביצועים של אפליקציות Ruby. מידע נוסף מופיע במאמר Google Cloud Observability ל-Ruby.