במדריך הזה מוסבר איך להכין את המחשב המקומי לפיתוח ב-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 כדי לציין את אבני החן והגרסאות הנדרשות.
מתקינים את Bundler.
gem install bundler
מתקינים את יחסי התלות של
gemשמוגדרים ב-Gemfile.bundle install
מריצים את פרויקט Ruby רק באמצעות gems שמוגדרים ב-
Gemfile.bundle exec ruby app.rb
במסמכי התיעוד של Bundler מוסבר איך יוצרים Gemfile.
התקנת כלי עריכה
אלה כמה מהעורכים הפופולריים (ללא סדר מסוים) שמשמשים לפיתוח אפליקציות Ruby:
- Sublime Text מאת Jon Skinner
- Atom של GitHub
- RubyMine מבית JetBrains
- Vim מאת Vim the editor
העורכים האלה (לפעמים בעזרת פלאגינים) מספקים לכם הכול, החל מהדגשת תחביר, IntelliSense והשלמת קוד ועד ליכולות ניפוי באגים משולבות באופן מלא, כדי למקסם את יעילות הפיתוח ב-Ruby.
התקנת ה-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
ספריית הלקוח של Ruby ב-Cloud היא הדרך המקובלת למפתחי 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
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מידע נוסף זמין במאמר אימות לצורך שימוש בספריות לקוח.