שלב 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 הוא מספר הפרויקט ב-Cloud שיצרתם כחלק מהדרישות המוקדמות. בדוגמה הזו מופעלת פקודת gcloud כדי לקבל את מספר הפרויקט. לחלופין, אפשר למצוא אותו בלוח הבקרה של הפרויקט ב-Google Cloud Console או להשתמש בפקודה 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

      גם בחשבונות ניסיון וגם בחשבונות בתשלום נעשה שימוש באזורים למיקום של Analytics. לכן, בארגונים בתשלום, הערך של ANALYTICS_REGION יכול להיות זהה לערך של 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