שלב 4: התקנת apigeectl

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

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

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

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

  1. מאחסנים את מספר הגרסה האחרונה במשתנה באמצעות הפקודה הבאה: 
    export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
  2. כדי לוודא שהמשתנה אוכלס במספר גרסה, מריצים את הפקודה הבאה. אם רוצים להשתמש בגרסה אחרת, אפשר לשמור אותה במשתנה סביבה. 
    echo $VERSION
     
      1.4.0

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

    ‫Mac 64 bit:

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

    ‫Linux 64 bit:

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

    Mac 32 bit:

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

    ‫Linux‏ 32 ביט:

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

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

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

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

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

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

  9. יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה: 
    export APIGEECTL_HOME=$PWD
  10. כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה: 
    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 service-accounts
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