שלב 1: הגדרת משתני סביבה

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

מה עושים בשלב הזה

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

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

ביצוע השלב

כדי להגדיר משתני סביבה בשורת הפקודה:

  1. מגדירים את משתני הסביבה הבאים לפרויקט הנוכחי: 
    PROJECT_ID="YOUR_PROJECT_ID"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="YOUR_RUNTIME_LOCATION"
ANALYTICS_REGION="YOUR_ANALYTICS_REGION"
RUNTIMEDBKEY_LOCATION="RUNTIMEDB_LOCATION"
APPKEY_KEY_RING_NAME="RUNTIMEDB_KEY_RING_NAME"
APPKEY_KEY_NAME="RUNTIMEDB_KEY_NAME"
DISK_KEY_RING_NAME="DISK_KEY_RING_NAME"
DISK_KEY_NAME="DISK_KEY_NAME"

    כאשר:

    • ‫PROJECT_ID הוא מזהה פרויקט בענן שיצרתם במסגרת הדרישות המוקדמות. אם אתם לא בטוחים מה מזהה הפרויקט שלכם, תוכלו להשתמש במסוף Cloud או בפקודה gcloud projects list כדי למצוא אותו.
    • ‫PROJECT_NUMBER הוא מספר הפרויקט בענן שיצרתם במסגרת הדרישות המוקדמות. בדוגמה הזו מריצים את הפקודה gcloud כדי לקבל את מספר הפרויקט. אפשר גם למצוא אותו במרכז הבקרה של הפרויקט במסוף Google Cloud או להשתמש בפקודה gcloud projects list.

    • ‫RUNTIME_LOCATION הוא המיקום הפיזי שבו נמצא המופע שלכם. הערכים התקפים הם כל אזור של Compute Engine (בארגונים בתשלום) או תחום של Compute Engine (בארגוני ניסיון). מידע נוסף זמין במאמר בנושא מיקומים ב-Compute Engine.

    • ‫ANALYTICS_REGION הוא המיקום הפיזי שבו מאוחסנים נתוני הניתוח.

      הערכים התקפים הם קבוצת משנה של האזורים ב-Compute Engine. הערכים שאפשר לבחור הם:

      • asia-northeast1
      • asia-south1
      • europe-west1
      • us-central1
      • us-east1
      • us-west1
      • australia-southeast1
      • europe-west2

      גם בחשבונות ניסיון וגם בחשבונות בתשלום נעשה שימוש באזורים למיקום הניתוח. לכן, בארגונים בתשלום, הערך שלו יכול להיות זהה לערך של RUNTIME_LOCATION (גם הוא אזור). אבל הערך של ANALYTICS_REGION לא חייב להיות זהה לערך של RUNTIME_LOCATION. עם זאת, יכול להיות שיהיה שיפור בביצועים אם הם זהים.

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

    • ‫RUNTIME_LOCATION הוא המיקום הפיזי שבו מאוחסנים אוסף המפתחות והמפתח של האפליקציה. ‫Apigee משתמש במפתח אפליקציה כדי להצפין נתוני אפליקציה כמו מכונות KVM, מטמון וסודות לקוח, שנשמרים במסד הנתונים.

      בדומה לאזור של Analytics, הערכים האפשריים הם קבוצת משנה של האזורים ב-Compute Engine. הערך יכול להיות זהה לערך של $RUNTIME_LOCATION (גם הוא אזור), אבל הוא לא חייב להיות זהה. אם הם זהים, יכול להיות שיהיה שיפור בביצועים.

    • ‫RUNTIME_LOCATION הוא השם של אוסף המפתחות שבו מאוחסן מפתח האפליקציה. השם של מחזיק המפתחות צריך להיות ייחודי בארגון. אם יוצרים אזורים נוספים, השמות של אוספי המפתחות באזורים האלה לא יכולים להיות זהים לשמות של אוספי מפתחות קיימים.
    • ‫APPKEY_KEY_NAME הוא השם של מפתח האפליקציה. השמות של מפתחות האפליקציה חייבים להיות ייחודיים בתוך אוסף מפתחות נתון.
    • ‫DISK_KEY_RING_NAME הוא השם של אוסף המפתחות של הדיסק. It השם של אוסף המפתחות של הדיסק צריך להיות שונה משם המפתח של האפליקציה. תצטרכו ליצור את אוסף מפתחות הדיסק באותו מיקום שבו נמצא $RUNTIME_LOCATION.
    • ‫DISK_KEY_NAME הוא השם של מפתח הצפנת הדיסק, שמשמש את Apigee להצפנת נתוני מופע בזמן ריצה לפני שהם נכתבים לדיסק.

    בדוגמה הבאה מוגדרים משתני סביבה לארגון בתשלום. 

    PROJECT_ID="my-cloud-project"
PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")
RUNTIME_LOCATION="us-west1"
ANALYTICS_REGION="us-west1"
RUNTIMEDBKEY_LOCATION="us-west1"
APPKEY_KEY_RING_NAME="us-west1"
APPKEY_KEY_NAME="us-west1"
DISK_KEY_RING_NAME="us-west1"
DISK_KEY_NAME="us-west1"

    אם מדובר בארגון לצורך הערכה, הערך של RUNTIME_LOCATION יהיה אזור במקום אזור.

    תשתמשו בשמות המשתנים, כמו $PROJECT_ID, כמחרוזות מילוליות בפקודות.

    שימו לב: יכול להיות שלא תשתמשו בכל משתני הסביבה האלה במהלך ההקצאה וההגדרה.

  2. (אופציונלי) כדי לבדוק את העבודה, אפשר להציג את הערכים שהגדרתם. שימו לב: כשרוצים להשתמש במשתנה בפקודות, צריך להוסיף לפני שם המשתנה סימן דולר ($). 
    echo $PROJECT_ID
echo $PROJECT_NUMBER
echo $ANALYTICS_REGION
echo $RUNTIMEDBKEY_LOCATION
echo $APPKEY_KEY_RING_NAME
echo $APPKEY_KEY_NAME
echo $DISK_KEY_RING_NAME
echo $DISK_KEY_NAME

    התגובות לפקודות echo אמורות להיראות כך:

    Authorization: Bearer ya29.a123456678940B63hPSAMPLEsampleKKYVsample0f3pWDWZDuH2-hENkNa
TvgZ1PD977TMvv6edBQPJezdHw040880Ol_LoD5ZDkt-i-knizia_KhA9L20sSvztL81-SAMPLE42ELPMASk2_
1CxN
my-cloud-project
1234567890
us-west1
us-west1
us-west1
$RUNTIMEDB_KEY_RING_NAME
$RUNTIMEDB_KEY_NAME
$DISK_KEY_RING_NAME
$DISK_KEY_NAME

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

1 השלב הבא: הפעלת ממשקי API 3 4 5 6 7 8