בדף הזה מוסבר איך להתחיל להשתמש בספריות הלקוח של Cloud עבור Compute Engine API. ספריות לקוח מאפשרות לגשת בקלות ל-Cloud de Confiance by S3NS APIs בשפה נתמכת. אמנם אפשר להשתמש ישירות ב-Cloud de Confiance by S3NS APIs על ידי יצירת בקשות גולמיות חדשות לשרת, אבל ספריות לקוח מפשטות את התהליך ומפחיתות באופן משמעותי את כמות הקוד שתצטרכו לכתוב.
מידע נוסף על ספריות הלקוח ב-Cloud ועל ספריות הלקוח הישנות של Google API זמין במאמר הסבר על ספריות לקוח.
התקנת ספריית הלקוח
C++
פועלים לפי ההוראות של Quickstart.
C#
מתקינים את חבילת Google.Cloud.Compute.V1 מ-NuGet.
מידע נוסף מופיע במאמר הגדרת סביבת פיתוח בשפת C# .
Go
go get cloud.google.com/go/compute/apiv1
מידע נוסף זמין במאמר הגדרת סביבת פיתוח בשפת Go.
Java
אם משתמשים ב-Maven, צריך להוסיף את הקוד הבא לקובץ pom.xml. במאמר העוסק בספריות BOM ל-Google Cloud Platform תוכלו לקרוא מידע נוסף על עצי מוצרים (BOM).
אם משתמשים ב-Gradle, צריך להוסיף את הקוד הבא ליחסי התלות:
אם משתמשים ב-sbt, צריך להוסיף את הקוד הבא ליחסי התלות:
הגרסה הישנה יותר של ספריות הלקוח של Java ל-Compute Engine ב-Cloud זמינה כגרסה 0.120.x או גרסה מוקדמת יותר ב-Maven artifact. גרסאות 0.120.x וגרסאות קודמות של הספרייה הזו לא תואמות לגרסאות מאוחרות יותר.
מידע נוסף זמין במאמר הגדרת סביבת פיתוח בשפת Java.
Node.js
npm install @google-cloud/compute
הגרסה הישנה יותר של ספריות הלקוח של Cloud ל-Node.js ל-Compute Engine זמינה כגרסה 2.5.x או גרסה קודמת בחבילת npm. גרסאות 2.5.x וגרסאות קודמות של הספרייה הזו לא תואמות לגרסאות מאוחרות יותר.
מידע נוסף זמין במאמר הגדרת סביבת פיתוח של Node.js.
PHP
composer require google/cloud-compute
מידע נוסף זמין במאמר שימוש ב-PHP ב-Google Cloud.
Python
pip install --upgrade google-cloud-compute
מידע נוסף מופיע במאמר בנושא הגדרת סביבת פיתוח בשפת Python.
Ruby
gem install google-cloud-compute-v1
מידע נוסף זמין במאמר הגדרת סביבת פיתוח בשפת Ruby.
Rust
cargo add google-cloud-compute-v1
מידע נוסף זמין במאמר תחילת העבודה עם Rust.
מגדירים אימות
כדי לאמת קריאות לממשקי ה-API של Cloud de Confiance by S3NS , ספריות הלקוח תומכות ב-Application Default Credentials (ADC). בספריות מתבצע חיפוש של פרטי כניסה בקבוצה של מיקומים מוגדרים, והמערכת משתמשת בפרטי הכניסה האלה כדי לאמת בקשות ל-API. בעזרת ADC, פרטי הכניסה לאפליקציה יכולים להיות זמינים בסביבות שונות, כמו בפיתוח מקומי או בייצור, בלי שיהיה צריך לשנות את קוד האפליקציה.בסביבות ייצור, אופן ההגדרה של ADC תלוי בשירות ובהקשר. מידע נוסף זמין במאמר בנושא הגדרה של Application Default Credentials.
בסביבת פיתוח מקומית, אפשר להגדיר את ADC עם פרטי הכניסה שמשויכים לחשבון Google שלכם:
-
התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud init -
יוצרים פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מסך הכניסה יופיע. אחרי שנכנסים, פרטי הכניסה נשמרים בקובץ פרטי הכניסה המקומי שמשמש את ADC.
שימוש בספריית הלקוח
בדוגמה הבאה מוצג איך להשתמש בספריית הלקוח כדי להציג רשימה של מופעים באזור מסוים. דוגמאות נוספות זמינות במאמר שימוש בספריות לקוח.
C#
Go
Java
Node.js
PHP
Python
Ruby
Rust
מקורות מידע נוספים
C++
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של C++:
C#
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של C#:
Go
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Go:
Java
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Java:
Node.js
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Node.js:
PHP
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של PHP:
Python
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Python:
Ruby
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Ruby:
Rust
ברשימה הבאה מופיעים קישורים למקורות מידע נוספים שקשורים לספריית הלקוח של Rust:
ספריות לקוח ישנות יותר
ספריות הלקוח ב-Cloud מבוססות על מודל ספריות הלקוח העדכני שלנו, והן האפשרות המומלצת לגישה ל-Cloud APIs באופן פרוגרמטי.
במקרים שבהם אי אפשר להשתמש בספריות לקוח ב-Cloud, אפשר להשתמש בספריות הלקוח של Google API הבאות:
ספריות לקוח של צד שלישי ל-Compute Engine API
libcloud
libcloud היא ספריית Python שמשמשת לאינטראקציה עם כמה ספקי שירותי ענן באמצעות ממשק API מאוחד יחיד.
פרויקט Apache libcloud API מקבל תמיכה ועדכונים ל-Compute Engine מאז יולי 2013. הוא תומך במגוון רחב של תכונות של Compute Engine, כולל מכונות, דיסקים, רשתות ומאזני עומסים. הדמו 'תחילת העבודה' כולל דוגמת קוד שמראה איך להשתמש ב-libcloud וב-Compute Engine ביחד.
jclouds
jclouds היא ספרייה בקוד פתוח שמאפשרת לכם להשתמש ב-Java וב-Clojure אצל כמה ספקי ענן.
ממשק הענן jclouds API תומך ב-Compute Engine ומאפשר לכם לנהל משאבים כמו מכונות וירטואליות, דיסקים ורשתות. החל מגרסה 1.9, Compute Engine קודם לליבת jclouds.
fog.io
fog.io היא ספריית קוד פתוח של Ruby שמאפשרת לכם ליצור אינטראקציה עם כמה שירותי ענן באמצעות API אחד.
ב-API של הענן fog.io יש תמיכה ב-Compute Engine מאז גרסה 1.11.0 במאי 2013. היא תומכת בפעולות על מופעים כמו יצירה ומחיקה, וגם בפעולות ניהול של משאבים אחרים כמו דיסקים, רשתות ומאזני עומסים.