חלק 1: שירותי Google Cloud והגדרת ממשק משתמש היברידי

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

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

  • מסוף Google Cloud
  • ממשק המשתמש של Apigee Hybrid
  • gcloud שורת פקודה

משתני סביבה

השלבים שמבצעים באמצעות שורת הפקודה משתמשים במשתני סביבה שנוצרו על ידי המשתמש. אם חלון המסוף מתנתק, משתני הסביבה לא נשמרים.

משתני הסביבה שמשמשים בהליכים האלה הם:

‫Linux / MacOS 

export PROJECT_ID="your_project_id"
export ORG_NAME=$PROJECT_ID
export ORG_DISPLAY_NAME="org_friendly_name"
export ORGANIZATION_DESCRIPTION="org_description_text"
export ANALYTICS_REGION="analytics_region"
export RUNTIMETYPE=HYBRID
export ENV_NAME="environment_name"
export ENV_DISPLAY_NAME="env_friendly_name"
export ENV_DESCRIPTION="env_description_text"
export DOMAIN="example.com"
export ENV_GROUP="environment-group-name"
export CLUSTER_NAME="cluster_name"
export CLUSTER_LOCATION="cluster_region"

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

export ORGANIZATION_DESCRIPTION="My example organization number 1"

Windows 

set PROJECT_ID="your_project_id"
set ORG_NAME=$PROJECT_ID
set ORG_DISPLAY_NAME="org_friendly_name"
set ORGANIZATION_DESCRIPTION="org_description_text"
set ANALYTICS_REGION="analytics_region"
set RUNTIMETYPE=HYBRID
set ENV_NAME="environment_name"
set ENV_DISPLAY_NAME="env_friendly_name"
set ENV_DESCRIPTION="env_description_text"
set DOMAIN="example.com"
set ENV_GROUP="environment-group-name"
set CLUSTER_NAME="cluster_name"
set CLUSTER_LOCATION="cluster_region"

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

set ORGANIZATION_DESCRIPTION="My example organization number 1"

טוקן של פרטי כניסה להרשאה

התוקף של טוקן אישורי ההרשאה gcloud יפוג אחרי 20 דקות. אם לא תבצעו את כל השלבים בפרק הזמן הזה, תצטרכו לקבל שוב את פרטי הכניסה להרשאה. לדוגמה:

בשורת הפקודה, מריצים את הפקודה הבאה כדי לקבל את פרטי הכניסה לאימות ב-gcloud:

‫Linux / MacOS 

TOKEN=$(gcloud auth print-access-token)

Windows 

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

משתני סביבה אחרים

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

  • ‫LONG_RUNNING_OPERATION_ID: ה-UUID של הפעולה האסינכרונית הממושכת שמהווה חלק מתהליך יצירת הארגון.
  • ‫APIGEECTL_HOME: הנתיב לספרייה שבה מתקינים את כלי השירות apigeectl.

סקירה כללית על התהליך

בקטע הזה מוסבר על המשימות שצריך לבצע כדי להגדיר את ממשק המשתמש ההיברידי ואת שירותי Google Cloud.

התהליך הכללי להגדרת ממשק המשתמש ההיברידי של Apigee ושירותי Google Cloud הוא כדלקמן:

פעולה באמצעות תיאור
שלב 1: יצירת חשבון Google Cloud מסוף Google Cloud כדי לבצע את הפעולות האלה, צריך חשבון Google Cloud. החשבון הזה יקשר לארגון היברידי חדש.
שלב 2: יצירת פרויקט בענן ב-Google מסוף Google Cloud פרויקטים ב-Google Cloud הם הבסיס ליצירה, להפעלה ולשימוש בשירותי Google Cloud. בפרויקט מאורגנים כל המשאבים שלכם ב-Google Cloud.
שלב 3: הפעלת ממשקי API מסוף Google Cloud או שורת פקודה בלי הקישור הזה, שירותים היברידיים לא יוכלו לתקשר ביניהם או עם שירותים אחרים.
שלב 4: יצירת ארגון שורת הפקודה פרויקטים שייכים לארגונים. אחרי שיוצרים ארגון, כמעט מוכנים לבצע קריאות ל-API וליצור שרתי proxy ל-API.
שלב 5: הוספת סביבה ממשק המשתמש של Apigee Hybrid או שורת הפקודה סביבה מספקת הקשר מבודד או ארגז חול להרצת פרוקסי של API. באותו ארגון, אפשר ליצור כמה סביבות. אם לא תעשו את זה, לא תוכלו להשלים את ההתקנה של סביבת זמן הריצה ההיברידית, ולא יהיה לכם מקום לפרוס בו את שרתי ה-proxy של ה-API.

השלב הבא

כל אחד מהשלבים האלה מתואר בקטעים הבאים.

קדימה!