שלב 4: התקנת apigeectl

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

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

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

כך מקבלים את apigeectl:

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

    ‫Mac 64 bit:

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_64.tar.gz

    ‫Linux 64 bit:

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_64.tar.gz

    ‫Mac 32 bit:

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_32.tar.gz

    ‫Linux 32 bit:

    curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_32.tar.gz
  2. יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנה של Apigee Hybrid.

  3. מחלצים את התוכן של קובץ ה-gzip שהורדתם לתיקיית הבסיס שיצרתם באמצעות הפקודה הבאה:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.

  5. ברירת המחדל היא שהתוכן של קובץ ה-tar יורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.5.0-d591b23_linux_64. משנים את השם של הספרייה ל-apigeectl באמצעות הפקודה הבאה:

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

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

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

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

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

  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

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

1 2 3 4 (NEXT) Step 5: Set up service accounts 6 7 8 9