במדריך הזה מוסבר איך להכין את המחשב המקומי לפיתוח ב-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לפי ההוראות בקובץ ה-Readme של rbenv. ההתקנה של 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 by Vim the editor
העורכים האלה (לפעמים בעזרת תוספים) מספקים לכם את כל מה שאתם צריכים, החל מהדגשת תחביר, חיזוי והשלמת קוד ועד ליכולות ניפוי באגים משולבות לחלוטין, כדי למקסם את היעילות של פיתוח 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 באמצעות המאגר המאוחד לניהול זהויות.
מידע נוסף זמין במאמר אימות לצורך שימוש בספריות לקוח.