יצירת אפליקציית Ruby בסביבה גמישה ב-App Engine

יצירת אפליקציית Ruby בסביבה גמישה ב-App Engine

מזהה אזור

‫REGION_ID הוא קוד מקוצר ש-Google מקצה על סמך האזור שבוחרים כשיוצרים את האפליקציה. הקוד לא תואם למדינה או למחוז, למרות שחלק ממזהי האזורים עשויים להיראות דומים לקודים נפוצים של מדינות ומחוזות. באפליקציות שנוצרו אחרי פברואר 2020, המחרוזת REGION_ID.r כלולה בכתובות URL של App Engine. באפליקציות קיימות שנוצרו לפני התאריך הזה, מזהה האזור הוא אופציונלי בכתובת ה-URL.

מידע נוסף על מזהי אזורים

אישור

הערה: אם אתם פורסים שירות אינטרנט חדש של Ruby ב- Google Cloud, מומלץ להתחיל עם Cloud Run.

במדריך למתחילים הזה נסביר איך ליצור ולפרוס אפליקציה שמציגה הודעה קצרה. כדי להשתמש באפליקציה לדוגמה שבמדריך הזה בכל גרסה נתמכת של Ruby, צריך לציין את גרסת זמן הריצה ומערכת ההפעלה בקובץ app.yaml.

לפני שמתחילים

נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות להשלמת המדריך הזה, אתם צריכים לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

• אדמין App Engine (roles/appengine.appAdmin) בפרויקט
• עריכה ב-Cloud Build (roles/cloudbuild.builds.editor) בפרויקט
• אדמין של אובייקט אחסון (roles/storage.objectAdmin) בפרויקט
• ‫Logs Viewer (roles/logging.viewer) on the project
• משתמש בחשבון שירות (roles/iam.serviceAccountUser) בחשבון השירות
• מבקשים מהאדמין להקצות את התפקידים הבאים לחשבון השירות שמוגדר כברירת מחדל של App Engine:
  • ‫Artifact Registry Reader (roles/artifactregistry.reader) בפרויקט
  • חשבון השירות של Cloud Build (roles/cloudbuild.builds.builder) בפרויקט
  • צפייה באובייקטים באחסון (roles/storage.objectViewer) בפרויקט

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

דרישות מוקדמות נוספות

1. מאתחלים את אפליקציית App Engine עם הפרויקט ובוחרים את האזור שלה:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   כשמופיעה בקשה, בוחרים את האזור שבו רוצים למקם את אפליקציית App Engine.

   חשוב לדעת: אחרי שמגדירים את האזור של האפליקציה, אי אפשר לשנות אותו.

2. מתקינים את הרכיבים הבאים במחשב המקומי:

   • מורידים את Git ומתקינים אותו.

המיקומים של App Engine

‫App Engine הוא אזורי, כלומר התשתית שמריצה את האפליקציות שלכם ממוקמת באזור ספציפי, ו-Google מנהלת אותה כך שהיא זמינה באופן יתירתי בכל התחומים באזור הזה.

הקריטריונים העיקריים לבחירת האזור שבו האפליקציות שלכם יפעלו הם זמן האחזור, הזמינות או העמידות. בדרך כלל אפשר לבחור את האזור הקרוב ביותר למשתמשים של האפליקציה, אבל כדאי גם לבדוק איפה App Engine זמין וגם את המיקומים שלGoogle Cloud המוצרים והשירותים האחרים שהאפליקציה משתמשת בהם. שימוש בשירותים בכמה מיקומים יכול להשפיע על זמן האחזור של האפליקציה וגם על התמחור שלה.

אחרי שמגדירים את האזור של האפליקציה, אי אפשר לשנות אותו.

הערה: שני מיקומים, שנקראים europe-west ו-us-central בפקודות של App Engine ובמסוף Google Cloud , נקראים europe-west1 ו-us-central1, בהתאמה, במקומות אחרים במסמכי Google.

אם כבר יצרתם אפליקציית App Engine, תוכלו לראות את האזור שלה באחת מהדרכים הבאות:

• מריצים את הפקודה gcloud app describe.

• פותחים את מרכז הבקרה של App Engine במסוף Google Cloud . האזור מופיע בחלק העליון של הדף.

אישור

במדריך למתחילים הזה נדגים אפליקציית Ruby פשוטה שנכתבה באמצעות Sinatra, מסגרת אינטרנט שאפשר לפרוס ב-App Engine. בדוגמה הזו נעשה שימוש ב-Sinatra, אבל אפשר להשתמש גם במסגרות אחרות כמו Ruby on Rails.

הורדה של אפליקציית Hello World

יצרנו אפליקציית Hello World ל-App Engine כדי שתוכלו להבין במהירות איך פורסים אפליקציה ב- Google Cloud.

1. משכפלים את מאגר אפליקציית הדוגמה Hello World למחשב המקומי.

   git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
   

   אפשרות נוספת היא להוריד את הקובץ לדוגמה כקובץ ZIP ולחלץ אותו.

2. עוברים לספרייה שמכילה את הקוד לדוגמה.

      cd ruby-docs-samples/appengine/flexible/hello_world
   

הפעלת Hello World במחשב המקומי

בדוגמה הזו נעשה שימוש ב-Bundler כדי להריץ את אפליקציית Hello World במחשב המקומי:

1. אם שפת התכנות לא מותקנת בסביבת זמן הריצה, צריך להוריד ולהתקין את Ruby.

   הורדה והתקנה של Ruby

2. מתקינים את Bundler:

   gem install bundler
   

3. מתקינים את יחסי התלות בפרויקט הזה:

   bundle install
   

4. מפעילים שרת אינטרנט מקומי.

   bundle exec ruby app.rb -p 8080
   

5. בדפדפן האינטרנט, מזינים:

   http://localhost:8080

ההודעה Hello World מאפליקציית הדוגמה מוצגת בדף. בחלון הטרמינל, מקישים על Ctrl+C כדי לצאת משרת האינטרנט.

פריסה והפעלה של Hello World ב-App Engine

כדי לפרוס את האפליקציה בסביבה הגמישה של App Engine:

1. מריצים את הפקודה הבאה מהספרייה flexible/hello_world כדי לפרוס את אפליקציית Hello World:

   gcloud app deploy

   מידע על הדגלים האופציונליים

   הגדרות flag נפוצות של הפקודה gcloud

   • כדי לציין מזהה שמזהה באופן ייחודי את הגרסה של האפליקציה, צריך לכלול את הדגל --version. אחרת, המערכת תיצור מזהה בשבילכם. לדוגמה: --version [YOUR_VERSION_ID]
   • כדי לציין מזהה פרויקט חלופי ב- Google Cloud , שונה ממה שהוגדר כברירת מחדל בכלי gcloud, צריך לכלול את הדגל --project. דוגמה: --project [YOUR_PROJECT_ID]

   דוגמה:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   במאמר בדיקה ופריסה של האפליקציה תוכלו לקרוא מידע נוסף על פריסת האפליקציה משורת הפקודה. רשימה של כל הדגלים של הפקודה מופיעה במאמר בנושא gcloud app deploy.

   אישור

2. מפעילים את הדפדפן כדי לראות את האפליקציה בכתובת https://PROJECT_ID.REGION_ID.r.appspot.com

   ‫

   gcloud app browse

   כאשר PROJECT_ID מייצג את מזהה הפרויקט ב- Google Cloud.

הפעם, הדף שמציג את ההודעה Hello World מועבר על ידי שרת אינטרנט שפועל במופע של App Engine.

מזל טוב! פרסתם את האפליקציה הראשונה שלכם ב-App Engine בסביבה הגמישה ב-App Engine!

אם נתקלתם בשגיאות כלשהן במהלך פריסת האפליקציה, כדאי לעיין בטיפים לפתרון בעיות.

בקטעים הבאים מפורט מידע על ניקוי, וגם קישורים לפעולות אפשריות שאפשר לבצע.

הסרת המשאבים

כדי להימנע מחיובים, אתם יכולים למחוק את הפרויקט Google Cloud כדי להפסיק את החיוב על כל המשאבים שנעשה בהם שימוש במסגרת הפרויקט.

זהירות: כשמוחקים פרויקט:
• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.
1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

המאמרים הבאים

לומדים את כל הפלטפורמה

עכשיו, אחרי שראיתם איך מפתחים ומפעילים אפליקציות App Engine, אתם יכולים לעיין בשאר המאמרים בנושא Google Cloud. כבר מותקן אצלכם Google Cloud CLI, שכולל את הכלים שמאפשרים לכם ליצור אינטראקציה עם מוצרים כמו Cloud SQL, ‏ Cloud Storage,‏ Firestore ועוד.

מידע על סביבה גמישה ב-App Engine

הנה כמה נושאים שיעזרו לכם להמשיך ללמוד על App Engine:

• סקירה כללית של App Engine
• ניתוב בקשות
• טיפול בבקשות
• ניהול מופעים

סקר קוד של Hello World

האפליקציה Hello World היא האפליקציה הכי פשוטה שאפשר ליצור ב-App Engine, כי היא מכילה רק שירות אחד, יש לה רק גרסה אחת וכל הקוד שלה נמצא בספריית השורש של האפליקציה. בקטע הזה מוסבר על כל אחד מקובצי האפליקציה.

app.rb

אפליקציית Hello World היא אפליקציית Sinatra בסיסית עם קובץ אחד:

require "sinatra"

get "/" do
  "Hello world!"
end

app.yaml

בקובץ app.yaml מפורטת התצורה הבאה של האפליקציה:

• הערך env: flex מציין שהאפליקציה משתמשת בסביבה גמישה ב-App Engine.

• הגדרה של סביבת זמן הריצה שבה האפליקציה משתמשת.

  runtime: ruby
  env: flex
  entrypoint: bundle exec ruby app.rb
  
  runtime_config:
    operating_system: ubuntu22
  
  # This sample incurs costs to run on the App Engine flexible environment.
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/ruby/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  

  • מידע נוסף על אופן הפעולה של זמן הריצה של Ruby זמין במאמר בנושא זמן הריצה של Ruby.

  • לפרטים נוספים על תכנון האפליקציה כדי לנצל את היתרונות של גרסאות ושירותים, אפשר לעיין במאמר סקירה כללית של App Engine.

  • פרטים נוספים על הגדרות התצורה של App Engine זמינים במאמר בנושא הגדרת האפליקציה באמצעות app.yaml.

Gemfile

‫Gemfile משמש לציון קשרי התלות של האפליקציה ב-RubyGem, ו-Bundler משמש להצהרה על קשרי תלות ולהתקנתם. אפליקציית Hello World דורשת gem אחד של Ruby: ‏ Sinatra,‏ framework אינטרנטי:

source "https://rubygems.org"

gem "sinatra"
gem "webrick", "~> 1.8"

ruby "~>3.4"
group :test do
  gem "rack-test"
  gem "rspec"
  gem "rspec_junit_formatter"
end

gem "puma", "~> 6.6"
gem "rackup", "~> 2.2"