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

שלב 2: התקנה והגדרה ב-GKE

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

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

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

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

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

‫Mac 64 bit:

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

‫Linux 64 bit:

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

Mac 32 bit:

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

‫Linux‏ 32 ביט:

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

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

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

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

חשוב לוודא שאתם בספריית הבסיס (הספרייה שבה נמצאת הספרייה apigeectl).
יוצרים תיקייה חדשה בשם 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 service-accounts
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
```

יצירת חשבונות שירות

‫Apigee hybrid משתמש בחשבונות שירות של Google Cloud כדי לאפשר לרכיבים היברידיים לתקשר באמצעות קריאות מורשות ל-API. בשלב הזה משתמשים בכלי של Apigee hybrid לשורת הפקודה כדי ליצור קבוצה של חשבונות שירות. הכלי גם מוריד בשבילכם את המפתחות הפרטיים של חשבון השירות. לאחר מכן צריך להוסיף את המפתחות האלה לקובץ ההגדרות של אשכול Apigee Hybrid.

מידע נוסף

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

רכיב^*	תפקיד	תיאור
`apigee-cassandra`	אדמין של אובייקט אחסון	מאפשר גיבוי של Cassandra ל-Google Cloud Storage, כפי שמתואר במאמר גיבוי ושחזור.
`apigee-logger`	בעל הרשאת כתיבה של יומנים	מאפשר איסוף נתוני רישום ביומן, כפי שמתואר בקטע רישום ביומן. נדרש רק להתקנות של אשכולות שאינם GKE.
`apigee-mart`	אין תפקיד	מאפשר אימות של שירות MART. לחשבון השירות הזה לא צריך להיות תפקיד משויך. לכן, כשיוצרים את חשבון השירות הזה, לא מקצים לו תפקיד.
`apigee-metrics`	בעל הרשאת כתיבה של מדדי מעקב	מאפשר איסוף נתונים של מדדים, כפי שמתואר במאמר בנושא איסוף מדדים
`apigee-org-admin`	אדמין של ארגון Apigee	מאפשרת לשלוח קריאה ל-getSyncAuthorization API ול-setSyncAuthorization API. אי אפשר ליצור את חשבון השירות הזה באמצעות הכלי `create-service-account`.
`apigee-synchronizer`	Apigee Synchronizer Manager	מאפשרת למסנכרן להוריד חבילות של שרתי proxy ונתוני תצורת סביבה. היא גם מאפשרת את הפעולה של תכונת המעקב.
`apigee-udca`	Apigee Analytics Agent	מאפשר העברה של נתוני מעקב, ניתוח וסטטוס פריסה למישור הניהול.
‫^* השם הזה משמש כשם הקובץ של המפתח של חשבון השירות שהורדתם.

יוצרים את המפתחות:

חשוב לוודא שאתם נמצאים בספרייה base_directory/hybrid-files.
מריצים את הפקודה הבאה מתוך הספרייה hybrid-files. הפקודה הזו יוצרת חשבון שירות לרכיב apigee-metrics וממקמת את המפתח שהורד בספרייה ./service-accounts.
```
./tools/create-service-account apigee-metrics ./service-accounts
```
כשמופיעה ההודעה הבאה, מזינים y:
```
[INFO]: gcloud configured project ID is project_id.
 Press: y to proceed with creating service account in project: project_id
 Press: n to abort.
```
אם זו הפעם הראשונה שנוצרת SA עם השם המדויק שהוקצה על ידי הכלי, הכלי פשוט יוצר אותה ואין צורך לבצע פעולות נוספות.

אם מוצגת לכם ההודעה וההנחיה הבאות, מזינים y כדי ליצור מפתחות חדשים:
```
[INFO]: Service account apigee-metrics@project_id.iam.gserviceaccount.com already exists.
...
 [INFO]: The service account might have keys associated with it. It is recommended to use existing keys.
 Press: y to generate new keys.(this does not de-activate existing keys)
 Press: n to skip generating new keys.
 
```

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

./tools/create-service-account apigee-synchronizer ./service-accounts
./tools/create-service-account apigee-udca ./service-accounts
./tools/create-service-account apigee-mart ./service-accounts
./tools/create-service-account apigee-cassandra ./service-accounts
./tools/create-service-account apigee-logger ./service-accounts

מוודאים שמפתחות חשבון השירות נוצרו. באחריותכם לאחסן את המפתחות הפרטיים האלה בצורה מאובטחת. שמות הקבצים של המפתחות מתחילים בשם של הפרויקט בענן ב-Google Cloud. לדוגמה:
```
ls ./service-accounts
gcp-project-id-apigee-cassandra.json
gcp-project-id-apigee-logger.json
gcp-project-id-apigee-mart.json
gcp-project-id-apigee-metrics.json
gcp-project-id-apigee-synchronizer.json
gcp-project-id-apigee-udca.json
```

יצירת אישורי TLS

אתם נדרשים לספק אישורי TLS עבור שערים של MART ושל זמן ריצה ב-Apigee hybrid. פרטי הכניסה שמשמשים לשער MART חייבים להיות מאושרים על ידי רשות אישורים (CA). לצורך המדריך למתחילים הזה (התקנת ניסיון שאינה בסביבת ייצור), שער זמן הריצה יכול לקבל פרטי כניסה בחתימה עצמית.

בשלב הזה, יוצרים את קובצי פרטי הכניסה של TLS ומוסיפים אותם לספרייה base_directory/hybrid-files/certs. בשלב 3: הגדרת האשכול, מוסיפים את נתיבי הקבצים לקובץ ההגדרות של האשכול.

יצירת פרטי כניסה ל-TLS עבור שער זמן הריצה

שער הכניסה של סביבת זמן הריצה (השער שמטפל בתעבורת נתונים של proxy ל-API) דורש זוג מפתחות/אישור TLS. להתקנה של המדריך למתחילים הזה, אפשר להשתמש בפרטי כניסה עם חתימה עצמית. בשלבים הבאים, נעשה שימוש ב-openssl כדי ליצור את פרטי הכניסה.

חשוב לוודא שאתם נמצאים בספרייה base_directory/hybrid-files.
מריצים את הפקודה הבאה מתוך הספרייה hybrid-files:
```
openssl req  -nodes -new -x509 -keyout ./certs/keystore.key -out \
    ./certs/keystore.pem -subj '/CN=mydomain.net' -days 3650
```
הפקודה הזו יוצרת זוג מפתחות/אישור עם חתימה עצמית שאפשר להשתמש בו להתקנה מהירה. הערך של CN mydomain.net יכול להיות כל ערך שרוצים עבור פרטי הכניסה בחתימה עצמית.
כדי לוודא שהקבצים נמצאים בספרייה ./certs, מריצים את הפקודה הבאה:
```
ls ./certs
  keystore.pem
  keystore.key
```
‫keystore.pem הוא קובץ אישור ה-TLS בחתימה עצמית ו-keystore.key הוא קובץ המפתח.

יצירת פרטי כניסה של TLS לשער MART

כמו שצוין בקטע לפני שמתחילים, חובה להשתמש בצמד מפתח/אישור TLS מורשה להגדרת שער MART. אם עדיין לא עשיתם זאת, עליכם להשיג או ליצור את פרטי הכניסה האלה עכשיו.

משיגים או יוצרים צמד של אישור ומפתח TLS שאושרו על ידי רשות אישורים. בהמשך מופיע לדוגמה תהליך להשגת פרטי הכניסה האלה באמצעות רשות האישורים Let's Encrypt. חשוב לדעת שהשם הנפוץ (CN) של האישור צריך להיות שם DNS תקין. במאמר הזה מופיעים שלבים לדוגמה.
מעתיקים את פרטי הכניסה לספרייה base_directory/hybrid-files/certs.
בסיום, אמורים להיות לכם שני זוגות של קובצי פרטי כניסה בספרייה ./certs. לדוגמה:
```
ls ./certs
  fullchain.pem
  privkey.key
  keystore.pem
  keystore.key
```
‫fullchain.pem הוא קובץ אישור ה-TLS המורשה ו-privkey.key הוא קובץ המפתח המורשה.

סיכום

עכשיו יש לכם בסיס שממנו תוכלו להגדיר, לפרוס ולנהל את Apigee hybrid באשכול Kubernetes. בשלב הבא, תיצרו קובץ שישמש את Kubernetes כדי לפרוס את רכיבי זמן הריצה ההיברידיים באשכול.

1 2 (NEXT) Step 3: Configure the cluster 4