שלב 4: התקנת apigeectl

בשלב הזה מוסבר איך להוריד ולהתקין את apigeectl.

הורדה והתקנה של apigeectl

apigeectl הוא ממשק שורת הפקודה (CLI) להתקנה ולניהול של Apigee Hybrid באשכול Kubernetes.

בשלבים הבאים מוסבר איך להוריד ולהתקין את apigeectl:

Linux

  1. מורידים את חבילת הגרסה למערכת ההפעלה שלכם באמצעות הפקודה הבאה:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_linux_64.tar.gz
  2. יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
  3. מחלקים את התוכן של קובץ ה-gzip שהורד לתיקיית הבסיס שיצרתם באמצעות הפקודה הבאה:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
  5. כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.6.9-d591b23_linux_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:

    mv apigeectl_1.6.9-d591b23_linux_64 apigeectl
  6. עוברים לספרייה באמצעות הפקודה הבאה:
    cd ./apigeectl

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

  7. כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
    ./apigeectl version
    Version: 1.6.9
  8. יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
    export APIGEECTL_HOME=$PWD
  9. כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
    echo $APIGEECTL_HOME

Mac OS

  1. מורידים את חבילת הגרסה למערכת ההפעלה שלכם באמצעות הפקודה הבאה:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_mac_64.tar.gz
  2. יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
  3. מחלקים את התוכן של קובץ ה-gzip שהורד לתיקיית הבסיס שיצרתם באמצעות הפקודה הבאה:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
  5. כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.6.9-d591b23_mac_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:

    mv apigeectl_1.6.9-d591b23_mac_64 apigeectl
  6. עוברים לספרייה באמצעות הפקודה הבאה:
    cd ./apigeectl

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

  7. כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
    ./apigeectl version
    Version: 1.6.9
  8. יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
    export APIGEECTL_HOME=$PWD
  9. כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
    echo $APIGEECTL_HOME

Windows

  1. מורידים את חבילת הגרסה למערכת ההפעלה שלכם באמצעות הפקודה הבאה:
    curl -LO ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_windows_64.zip
  2. יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
  3. כדי לחלץ את התוכן של קובץ ה-ZIP שהורדתם לספרייה הנוכחית, משתמשים בפקודה הבאה:

    tar xvzf filename.zip -C path-to-base-directory
  4. משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
  5. תוכן קובץ ה-tar מורחב כברירת מחדל לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: .\apigeectl_1.6.9-d591b23_windows_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:

    rename apigeectl_1.6.9-d591b23_windows_64 apigeectl
  6. עוברים לספרייה באמצעות הפקודה הבאה:
    cd .\apigeectl

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

  7. כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
    ./apigeectl version
    Version: 1.6.9
  8. יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
    set APIGEECTL_HOME=%CD%
  9. כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
    echo %APIGEECTL_HOME%

הגדרת מבנה ספריות הפרויקט

הגישה המומלצת היא להשתמש במבנה הספריות הבא. הוא מפריד בין תוכנת Apigee hybrid לבין קובצי התצורה שצריך ליצור. באמצעות המשתנה $APIGEECTL_HOME וקישורים סמליים שאתם יוצרים, אתם יכולים לעבור בקלות לגרסה חדשה של התוכנה אם תרצו. אפשר לעיין גם במאמר בנושא שדרוג Apigee Hybrid.

Linux

  1. כדי לוודא שאתם נמצאים בספריית הבסיס (הספרייה שבה נמצאת הספרייה apigeectl), משתמשים בפקודה הבאה:
    cd $APIGEECTL_HOME/..
  2. יוצרים תיקייה חדשה בשם hybrid-files באמצעות הפקודה הבאה. אפשר לתת לספרייה כל שם שרוצים, אבל במסמכים אנחנו משתמשים בשם hybrid-files באופן עקבי. בהמשך, תאחסנו בתיקייה הזו קובצי הגדרות, מפתחות של חשבונות שירות ואישורי TLS. התיקייה הזו מאפשרת לכם לשמור את קובצי ההגדרה בנפרד מהתקנת התוכנה apigeectl.
    mkdir hybrid-files
  3. מבנה הספריות הנוכחי נראה עכשיו כך:
    pwd && ls
    /hybrid-base-directory
      apigeectl
      hybrid-files
  4. משנים את הספרייה לתיקייה hybrid-files באמצעות הפקודה הבאה:
    cd hybrid-files
  5. בתוך התיקייה hybrid-files, יוצרים את תיקיות המשנה הבאות כדי לארגן את הקבצים שייווצרו בהמשך:
    mkdir overrides
    mkdir certs
  6. בתוך הספרייה hybrid-files, יוצרים את הקישורים הסימבוליים הבאים אל $APIGEECTL_HOME. הקישורים האלה מאפשרים להריץ את הפקודה apigeectl מתוך הספרייה hybrid-files, כמו בדוגמה הבאה:
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  7. כדי לוודא שהקישורים הסמליים נוצרו בצורה נכונה, מריצים את הפקודה הבאה ומוודאים שנתיבי הקישורים מצביעים על המיקומים הנכונים:
    ls -l | grep ^l

Mac OS

  1. כדי לוודא שאתם נמצאים בספריית הבסיס (הספרייה שבה נמצאת הספרייה apigeectl), משתמשים בפקודה הבאה:
    cd $APIGEECTL_HOME/..
  2. יוצרים תיקייה חדשה בשם hybrid-files באמצעות הפקודה הבאה. אפשר לתת לספרייה כל שם שרוצים, אבל במסמכים אנחנו משתמשים בשם hybrid-files באופן עקבי. בהמשך, תאחסנו בתיקייה הזו קובצי הגדרות, מפתחות של חשבונות שירות ואישורי TLS. התיקייה הזו מאפשרת לכם לשמור את קובצי ההגדרה בנפרד מהתקנת התוכנה apigeectl.
    mkdir hybrid-files
  3. מבנה הספריות הנוכחי נראה עכשיו כך:
    pwd && ls
    /hybrid-base-directory
      apigeectl
      hybrid-files
  4. משנים את הספרייה לתיקייה hybrid-files באמצעות הפקודה הבאה:
    cd hybrid-files
  5. בתוך התיקייה hybrid-files, יוצרים את תיקיות המשנה הבאות כדי לארגן את הקבצים שייווצרו בהמשך:
    mkdir overrides
    mkdir certs
  6. בתוך הספרייה hybrid-files, יוצרים את הקישורים הסימבוליים הבאים אל $APIGEECTL_HOME. הקישורים האלה מאפשרים להריץ את הפקודה apigeectl מתוך הספרייה hybrid-files, כמו בדוגמה הבאה:
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  7. כדי לוודא שהקישורים הסמליים נוצרו בצורה נכונה, מריצים את הפקודה הבאה ומוודאים שנתיבי הקישורים מצביעים על המיקומים הנכונים:
    ls -l | grep ^l

Windows

  1. כדי לוודא שאתם נמצאים בספריית הבסיס (הספרייה שבה נמצאת הספרייה apigeectl), משתמשים בפקודה הבאה:
    cd %APIGEECTL_HOME%\..
  2. יוצרים תיקייה חדשה בשם hybrid-files באמצעות הפקודה הבאה. אפשר לתת לספרייה כל שם שרוצים, אבל במסמכים אנחנו משתמשים בשם hybrid-files באופן עקבי. בהמשך, תאחסנו בתיקייה הזו קובצי הגדרות, מפתחות של חשבונות שירות ואישורי TLS. התיקייה הזו מאפשרת לכם לשמור את קובצי ההגדרה בנפרד מהתקנת התוכנה apigeectl.
    mkdir hybrid-files
  3. מבנה הספריות הנוכחי נראה עכשיו כך:
    dir
     Directory of C:\Users\example\hybrid
    
    08/05/2021  01:38 PM    <DIR>          .
    08/05/2021  01:38 PM    <DIR>          ..
    08/02/2021  01:11 PM    <DIR>          apigeectl
    08/02/2021  11:13 AM         5,803,963 apigeectl_1.6.9rc1-437dccc_windows_64.zip
    08/05/2021  01:38 PM    <DIR>          hybrid-files
  4. משנים את הספרייה לתיקייה hybrid-files.
  5. בתוך התיקייה hybrid-files, יוצרים את תיקיות המשנה הבאות כדי לארגן את הקבצים שייווצרו בהמשך:
    mkdir overrides
    mkdir certs
  6. בתוך הספרייה hybrid-files, יוצרים את הקישורים הסימבוליים הבאים אל $APIGEECTL_HOME. הקישורים האלה מאפשרים להריץ את הפקודה apigeectl מתוך הספרייה hybrid-files, כמו בדוגמה הבאה:
    mklink /d config %APIGEECTL_HOME%\config\
    mklink /d plugins %APIGEECTL_HOME%\plugins\
    mklink /d templates %APIGEECTL_HOME%\templates\
    mklink /d tools %APIGEECTL_HOME%\tools\
  7. כדי לוודא שהקישורים הסמליים נוצרו בצורה נכונה, משתמשים בפקודה dir:
    dir
     Directory of C:\Users\example\hybrid\hybrid-files
    
    08/05/2021  01:56 PM    <DIR>          .
    08/05/2021  01:56 PM    <DIR>          ..
    08/05/2021  01:46 PM    <DIR>          certs
    08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
    08/05/2021  01:46 PM    <DIR>          overrides
    08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
    08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
    08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]
        

עכשיו יש לכם בסיס שממנו תוכלו להגדיר, לפרוס ולנהל את Apigee hybrid באשכול Kubernetes. לאחר מכן, תיצרו את חשבונות השירות ופרטי הכניסה ב-Google Cloud שנדרשים להגדרת רכיבי זמן ריצה היברידיים.

1 2 3 4 (הבא) שלב 5: הגדרת חשבונות שירות 6 7 8 9