‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שלב 4: התקנת apigeectl

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

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

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

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

Linux

מאחסנים את מספר הגרסה האחרונה במשתנה באמצעות הפקודה הבאה:

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

כדי לוודא שהמשתנה אוכלס במספר גרסה, מריצים את הפקודה הבאה. אם רוצים להשתמש בגרסה אחרת, אפשר לשמור אותה במשתנה סביבה.
```
echo $VERSION
```
```
  1.7.6
```

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

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

יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
מחלקים את התוכן של קובץ ה-gzip שהורד לתיקיית הבסיס שיצרתם באמצעות הפקודה הבאה:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.7.6-d591b23_linux_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:
```
mv apigeectl_1.7.6-d591b23_linux_64 apigeectl
```
עוברים לספרייה באמצעות הפקודה הבאה:
```
cd ./apigeectl
```
הספרייה הזו היא ספריית הבית apigeectl. זה המקום שבו נמצאת הפקודה להפעלה apigeectl.
כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
```
./apigeectl version
```
```
Version: 1.7.6
```
יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
```
export APIGEECTL_HOME=$PWD
```
כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
```
echo $APIGEECTL_HOME
```

Mac OS

מאחסנים את מספר הגרסה האחרונה במשתנה באמצעות הפקודה הבאה:

export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)

כדי לוודא שהמשתנה אוכלס במספר גרסה, מריצים את הפקודה הבאה. אם רוצים להשתמש בגרסה אחרת, אפשר לשמור אותה במשתנה סביבה.
```
echo $VERSION
```
```
  1.7.6
```

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

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

יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
מחלקים את התוכן של קובץ ה-gzip שהורד לתיקיית הבסיס שיצרתם באמצעות הפקודה הבאה:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
כברירת מחדל, התוכן של קובץ ה-tar מורחב לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: ./apigeectl_1.7.6-d591b23_mac_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:
```
mv apigeectl_1.7.6-d591b23_mac_64 apigeectl
```
עוברים לספרייה באמצעות הפקודה הבאה:
```
cd ./apigeectl
```
הספרייה הזו היא ספריית הבית apigeectl. זה המקום שבו נמצאת הפקודה להפעלה apigeectl.
כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
```
./apigeectl version
```
```
Version: 1.7.6
```
יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
```
export APIGEECTL_HOME=$PWD
```
כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
```
echo $APIGEECTL_HOME
```

Windows

מאחסנים את מספר הגרסה האחרונה במשתנה באמצעות הפקודה הבאה:

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

כדי לוודא שהמשתנה אוכלס במספר גרסה, מריצים את הפקודה הבאה. אם רוצים להשתמש בגרסה אחרת, אפשר לשמור אותה במשתנה סביבה.
```
echo %VERSION%
```
```
  1.7.6
```

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

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

יוצרים ספרייה במערכת שתשמש כספריית הבסיס להתקנת Apigee Hybrid.
כדי לחלץ את התוכן של קובץ ה-ZIP שהורדתם לספרייה הנוכחית, משתמשים בפקודה הבאה:
```
tar xvzf filename.zip -C path-to-base-directory
```
משנים את הספרייה לספריית הבסיס באמצעות הפקודה cd.
תוכן קובץ ה-tar מורחב כברירת מחדל לספרייה עם הגרסה והפלטפורמה בשם שלה. לדוגמה: .\apigeectl_1.7.6-d591b23_windows_64. משנים את שם הספרייה ל-apigeectl באמצעות הפקודה הבאה:
```
rename apigeectl_1.7.6-d591b23_windows_64 apigeectl
```
עוברים לספרייה באמצעות הפקודה הבאה:
```
cd .\apigeectl
```
הספרייה הזו היא ספריית הבית apigeectl. זה המקום שבו נמצאת הפקודה להפעלה apigeectl.
כדי לוודא את הגרסה של apigeectl, מריצים את הפקודה version:
```
./apigeectl version
```
```
Version: 1.7.6
```
יוצרים משתנה סביבה שיכיל את הנתיב של ספריית הבית באמצעות הפקודה הבאה:
```
set APIGEECTL_HOME=%CD%
```
כדי לוודא שהמשתנה מכיל את הנתיב הנכון, מריצים את הפקודה הבאה:
```
echo %APIGEECTL_HOME%
```

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

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

Linux

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

Mac OS

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

Windows

כדי לוודא שאתם נמצאים בספריית הבסיס (הספרייה שבה נמצאת הספרייה apigeectl), משתמשים בפקודה הבאה:
```
cd %APIGEECTL_HOME%\..
```
יוצרים תיקייה חדשה בשם hybrid-files באמצעות הפקודה הבאה. אפשר לתת לספרייה כל שם שרוצים, אבל במסמכים אנחנו משתמשים בשם hybrid-files באופן עקבי. בהמשך, תאחסנו בתיקייה הזו קובצי הגדרות, מפתחות של חשבונות שירות ואישורי TLS. התיקייה הזו מאפשרת לכם לשמור את קובצי ההגדרה בנפרד מהתקנת התוכנה apigeectl.
```
mkdir hybrid-files
```

מבנה הספריות הנוכחי נראה עכשיו כך:

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.7.6rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

משנים את הספרייה לתיקייה hybrid-files.
בתוך התיקייה hybrid-files, יוצרים את תיקיות המשנה הבאות כדי לארגן את הקבצים שייווצרו בהמשך:
```
mkdir overrides
mkdir certs
```
בתוך הספרייה hybrid-files, יוצרים את הקישורים הסימבוליים הבאים אל $APIGEECTL_HOME. הקישורים האלה מאפשרים להריץ את הפקודה apigeectl מתוך הספרייה hybrid-files, כמו בדוגמה הבאה:
הערה: כדי להריץ את הפקודה mklink, צריך הרשאות אדמין במחשב עם Windows. כדי לעשות את זה, מריצים את מסוף הפקודות כאדמין או משתמשים בפקודה runas. לדוגמה:
```
runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
```
```
mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
```

כדי לוודא שהקישורים הסמליים נוצרו בצורה נכונה, משתמשים בפקודה 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

שלב 4: התקנת apigeectl קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

Linux

Mac OS

Windows

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

Linux

Mac OS

Windows

שלב 4: התקנת apigeectl

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