תחילת העבודה עם Go ב-Compute Engine

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

מטרות

• שימוש ב-Cloud Shell להורדה ולפריסה של אפליקציית Hello World לדוגמה.
• במדריך הזה נלמד איך משתמשים ב-Cloud Build כדי ליצור אפליקציה לדוגמה של Hello World.
• פריסת אפליקציית Hello World לדוגמה במכונה וירטואלית אחת ב-Compute Engine.

עלויות

במסמך הזה משתמשים ברכיבים הבאים של Google Cloud, והשימוש בהם כרוך בתשלום:

• Compute Engine
• Cloud Build

כדי להעריך את ההוצאות בהתאם לתחזית השימוש שלכם, אתם יכולים להיעזר במחשבון העלויות.

משתמשים חדשים של Google Cloud ? יכול להיות שאתם זכאים לתקופת ניסיון בחינם.

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

נכנסים לחשבון 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 Compute Engine and Cloud Build APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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 Compute Engine and Cloud Build APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

1. במסוף Google Cloud , פותחים את האפליקציה ב-Cloud Shell.

   כניסה ל-Cloud Shell

   ‫Cloud Shell מספק גישה למשאבי הענן שלכם דרך שורת הפקודה ישירות מהדפדפן.

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

3. ב-Cloud Shell, מגדירים את ה-CLI של gcloud לשימוש בפרויקט החדש Google Cloud :

   # Configure gcloud for your project
   gcloud config set project YOUR_PROJECT_ID

הפעלת האפליקציה ב-Cloud Shell

1. ב-Cloud Shell, מפעילים שרת אינטרנט מקומי:

   go build -o app
   ./app
   

2. ב-Cloud Shell, לוחצים על תצוגה מקדימה באינטרנט ובוחרים באפשרות תצוגה מקדימה ביציאה 8080. ייפתח חלון חדש עם האפליקציה הפועלת.

   בדפדפן האינטרנט, מופיע הסמל Hello, World!.

3. כדי להמשיך, לוחצים על Control+C ב-Cloud Shell כדי לעצור את שרת האינטרנט המקומי.

פריסה למופע יחיד

בקטע הזה מוסבר איך להריץ מופע יחיד של האפליקציה ב-Compute Engine.

מ-Cloud Shell, אפשר לבצע פריסה למכונה וירטואלית (VM) של Compute Engine שבה האפליקציה פועלת.

שימוש ב-Cloud Build כדי ליצור את האפליקציה

השירות Cloud Build משמש ליצירת האפליקציה, לדחיסתה בקובץ tar ולהעלאת הקובץ לקטגוריה של Cloud Storage. קטגוריות הן הקונטיינרים הבסיסיים ששומרים את הנתונים שלכם ב-Cloud Storage.

1. בחלון המסוף, יוצרים קטגוריה של Cloud Storage, כאשר YOUR_BUCKET_NAME מייצג את שם הקטגוריה:

   gcloud storage buckets create gs://YOUR_BUCKET_NAME

   אתם יכולים לבחור כל שם לקטגוריה של Cloud Storage. מומלץ לתת למאגר את אותו השם של מזהה הפרויקט. שמות הקטגוריות חייבים להיות ייחודיים בכלGoogle Cloud, ולכן יכול להיות שלא תוכלו להשתמש במזהה הפרויקט כשם הקטגוריה.

2. מתחילים את תהליך ה-build ב-Cloud:

   gcloud builds submit --substitutions=_DEPLOY_DIR=gs://YOUR_BUCKET_NAME,_DEPLOY_FILENAME=app.tar.gz

   הפקודה gcloud builds submit משתמשת ב---substitutions כדי להגדיר את המיקום שאליו יועלה קובץ ה-tar שנוצר. בהמשך, קובץ ה-tar יורד למופע של Compute Engine.

   ‫Cloud Build משתמש בקובץ תצורה בפורמט YAML כדי להגדיר את השלבים שנדרשים ל-build.

   steps:
     # Print the Go version being used.
     - name: 'mirror.gcr.io/library/golang'
       args: ['go', 'version']
     # Make a deploy directory we'll tar after building the app.
     - name: 'debian'
       args: ['mkdir', '-p', 'deploy/etc/systemd/system/', 'deploy/usr/bin']
     # Build the app.
     - name: 'mirror.gcr.io/library/golang'
       env: [
         'GO111MODULE=on',
         'GOPROXY=https://proxy.golang.org,direct',
         'GOOS=linux',
         'GOARCH=amd64'
       ]
       args: ['go', 'build', '-o', 'deploy/usr/bin/app', '.']
     # Copy the systemd service file into the deploy directory.
     - name: 'debian'
       args: ['cp', 'my-app.service', 'deploy/etc/systemd/system/']
     # Compress the deploy directory.
     - name: 'debian'
       args: ['tar', '-czf', '${_DEPLOY_FILENAME}', '-C', './deploy', '.']
   # Upload the tarball to Cloud Storage.
   artifacts:
     objects:
       location: '${_DEPLOY_DIR}'
       paths: ['${_DEPLOY_FILENAME}']

שימוש בסקריפט לטעינה בזמן ההפעלה כדי לאתחל מכונה

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

סקריפט לטעינה בזמן ההפעלה מופעל כשמכונה מופעלת בפעם הראשונה.

set -ex

# Install logging monitor. The monitor will automatically pickup logs sent to syslog.
curl "https://storage.googleapis.com/signals-agents/logging/google-fluentd-install.sh" --output google-fluentd-install.sh
checksum=$(sha256sum google-fluentd-install.sh | awk '{print $1;}')
if [ "$checksum" != "ec78e9067f45f6653a6749cf922dbc9d79f80027d098c90da02f71532b5cc967" ]; then
    echo "Checksum does not match"
    exit 1
fi
chmod +x google-fluentd-install.sh && ./google-fluentd-install.sh
service google-fluentd restart &

APP_LOCATION=$(curl -s "http://metadata.google.internal/computeMetadata/v1/instance/attributes/app-location" -H "Metadata-Flavor: Google")
gcloud storage cp "$APP_LOCATION" app.tar.gz
tar -xzf app.tar.gz

# Start the service included in app.tar.gz.
service my-app start

סקריפט לטעינה בזמן ההפעלה מבצע את המשימות הבאות:

• הסוכן Cloud Logging מותקן ומוגדר למעקב אחרי יומני האפליקציה.

• מוריד ומחלץ את קובץ ה-tar של הפריסה.

• מפעיל שירות systemd כדי להריץ את האפליקציה.

יצירה והגדרה של מכונה של Compute Engine

1. יצירת מכונה של Compute Engine:

   ‫Linux/macOS

   gcloud compute instances create my-app-instance \
   --image-family=debian-10 \
   --image-project=debian-cloud \
   --machine-type=g1-small \
   --scopes userinfo-email,cloud-platform \
   --metadata-from-file startup-script=startup-script.sh \
   --metadata app-location="gs://YOUR_BUCKET_NAME/app.tar.gz" \
   --zone YOUR_ZONE \
   --tags http-server

   מחליפים את YOUR_ZONE באזור פיתוח, למשל us-central1-a. מידע נוסף על אזורים ותחומים זמין במאמר מיקום גיאוגרפי ואזורים.

   הדגל --metadata app-location מציין לסקריפט לטעינה בזמן ההפעלה איפה להוריד את קובץ ה-tar של האפליקציה.

   Windows

   gcloud compute instances create my-app-instance ^
   --image-family=debian-10 ^
   --image-project=debian-cloud ^
   --machine-type=g1-small ^
   --scopes userinfo-email,cloud-platform ^
   --metadata-from-file startup-script=startup-script.sh ^
   --metadata app-location="gs://YOUR_BUCKET_NAME/app.tar.gz" ^
   --zone YOUR_ZONE ^
   --tags http-server

   מחליפים את YOUR_ZONE באזור פיתוח, למשל us-central1-a. מידע נוסף על אזורים ותחומים זמין במאמר מיקום גיאוגרפי ואזורים.

   הדגל --metadata app-location מציין לסקריפט לטעינה בזמן ההפעלה איפה להוריד את קובץ ה-tar של האפליקציה.

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

2. בודקים את התקדמות יצירת המופע:

   gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
   

   בסיום סקריפט לטעינה בזמן ההפעלה, תוצג ההודעה הבאה:

   startup-script: INFO Finished running startup scripts.
   

3. יוצרים כלל חומת אש שמאפשר תעבורת נתונים למופע:

   gcloud compute firewall-rules create default-allow-http-80 \
       --allow tcp:80 \
       --source-ranges 0.0.0.0/0 \
       --target-tags http-server \
       --description "Allow port 80 access to http-server"
   

4. מקבלים את כתובת ה-IP החיצונית של המופע:

   gcloud compute instances list
   

5. כדי לראות את האפליקציה פועלת, מזינים את כתובת ה-URL הזו בדפדפן:

   http://YOUR_INSTANCE_IP
   

   מחליפים את הערך YOUR_INSTANCE_IP בכתובת ה-IP החיצונית של המכונה.

ניהול של אירוע ומעקב אחריו

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

1. נכנסים לדף VM instances במסוף Google Cloud .

   כניסה לדף VM instances

2. ברשימת המכונות הווירטואליות, לוחצים על SSH בשורה של המכונה שרוצים להתחבר אליה.

3. כדי לראות את כל היומנים שנוצרו על ידי משאבי Compute Engine, עוברים לדף Logs Explorer.

   כניסה לדף Logs Explorer

   Cloud Logging מוגדר באופן אוטומטי לאיסוף יומנים משירותים נפוצים שונים, כולל syslog.

הסרת המשאבים

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

מחיקת הפרויקט

זהירות: כשמוחקים פרויקט:

• התוכן של הפרויקט נמחק כולו. אם השתמשתם בפרויקט קיים כדי לתרגל את המשימות במדריך הזה, כשתמחקו אותו תימחק גם כל העבודה שביצעתם באותו פרויקט.
• מאבדים את מזהה הפרויקט בהתאמה אישית. כשיצרתם את הפרויקט, יכולתם לבחור לו מזהה פרויקט בהתאמה אישית כדי להשתמש בו בעתיד. כדי לשמור על כתובות ה-URL שמשתמשות במזהה הפרויקט, כמו appspot.com, צריך למחוק את המשאבים שנבחרו בפרויקט אבל לא את הפרויקט כולו.

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

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

מחיקת המשאבים הבודדים

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-80

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

• כדאי להעמיק את הקריאה ולהכיר דוגמאות לארכיטקטורות, תרשימים ושיטות מומלצות בנושאי Google Cloud. כל אלה זמינים במרכז הארכיטקטורה של Cloud.

• כדי לקבל מידע על משאבים אחרים של Go לבניית אפליקציות, אפשר לעיין במקורות המידע הבאים:

  • אפשר לנהל ולנטר את הפריסה של קבוצת המופעים בCompute Engine > קבוצות של מופעים.
  • אפשר לנהל את הגדרות איזון העומסים, כולל מיפויי כתובות URL ושירותים לקצה העורפי, בשירותי רשת > איזון עומסים.
  • פריסת אפליקציה ב-Google Kubernetes Engine
  • אפשר לעיין בGoogle Cloud שירותים אחרים.