שלב 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.

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

  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.