שלב 8: קידום ארכיון לסביבת הייצור

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

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

בשלב הזה, מעלים ארכיון של הגדרת proxy ל-API לסביבת ייצור בארגון Apigee.

  1. פועלים לפי השלבים במאמר יצירת סביבה כדי לבצע את הפעולות הבאות:
    1. יוצרים סביבת prod חדשה בארגון Apigee, ומפעילים את הארכיון כסוג הפריסה. משתמשים בממשק המשתמש או ב-API.
    2. מצרפים את הסביבה למופע בזמן ריצה באמצעות Instances attachment API.

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

    3. אם עדיין אין לכם קבוצת סביבות, אתם יכולים ליצור אותה באמצעות Create environment groups API.

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

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. מצרפים את הסביבה החדשה לקבוצת הסביבות באמצעות Environment group attachment API.

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

  2. יוצרים סביבת prod חדשה בסביבת הפיתוח המקומית:
    1. ב-Apigee ב-VS Code, מציבים את הסמן מעל התיקייה environments בקטע Apigee ולוחצים על יצירת סמל.

      הסימן + מוצג כשמציבים את הסמן מעל התיקייה environments

      אשף ליצירת סביבה ייפתח.

    2. מזינים prod בשם הסביבה ומקישים על Enter.

      הסביבה נוצרת.

    3. מרחיבים את תיקיית הסביבה prod בקטע Apigee כדי לראות את התוכן שלה.
    4. מציבים את הסמן מעל הקובץ deployments.json בקטע Apigee ולוחצים על סמל ההגדרה.

      אשף הפריסות ייפתח.

    5. בוחרים את ה-proxy ל-API‏ helloworld כדי להוסיף אותו לפריסה ולוחצים על OK.

      קובץ deployments.json נפתח בעורך. הקובץ עודכן כך שיכלול את proxy ל-API של helloworld במערך הפריסה proxies, כמו שמוצג בהמשך:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. פריסת ארכיון של הגדרות proxy ל-API בסביבת prod בארגון Apigee.
    1. בכרטיסייה Terminal ב-Apigee VS Code, עוברים לספרייה myapigeeworkspace.
      cd myapigeeworkspace
    2. מריצים את הפקודה הבאה:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      זוהי דוגמה לתגובה:

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. מריצים את הפקודה הבאה כדי לבדוק את סטטוס הפעולה, ומחליפים את $OPERATION_ID במזהה הפעולה שהוחזר בקריאה הקודמת:
      gcloud beta apigee operations describe $OPERATION_ID

      בהמשך מופיעה דוגמה לתגובה. הערה: הערך של state מוגדר כ-IN_PROGRESS.

      Using Apigee organization 'prod'
      done: true
      metadata:
        '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
        operationType: INSERT
        state: IN_PROGRESS
        targetResourceName: uri
      name: organizations/prod/operations/$OPERATION_ID
      organization: prod
      response:
        '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
        control: 1-5-0-20210319-071117-ghq74
        endTime: '2021-03-20T06:15:44.329363950Z'
        metricLabels:
          env: test
          location: us-central1
        name: uri
        startTime: '2021-03-20T06:14:44.306534584Z'
        treatment: 1-5-0-20210319-190954-if0wk
        verdict: NONE
      uuid: $OPERATION_ID
    4. חוזרים על השלב הקודם עד שהערך של state הוא FINISHED, מה שמציין שהפריסה של הארכיון הושלמה.
    5. מריצים את הפקודה הבאה כדי לראות את כל פריסות הארכיון בסביבת prod:
      gcloud beta apigee archives list --environment=prod

      זוהי דוגמה לתגובה:

      Using Apigee organization 'prod'
      ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
      vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

מזל טוב! קידמת בהצלחה את ארכיון ה-API שלך לסביבת ייצור של Apigee.