שלב 1: יצירת אשכול GKE

בשלב הזה מוסבר איך להגדיר את סביבת המעטפת וליצור אשכול GKE בפרויקט Google Cloud Platform‏ (GCP).

הגדרת מעטפת הטרמינל

הכלי gcloud מספק את ממשק שורת הפקודה הראשי ל-GCP, והכלי kubectl מספק את ממשק שורת הפקודה הראשי להרצת פקודות מול אשכולות Kubernetes.

  1. חשוב לוודא שgcloud ו-kubectl מותקנים במעטפת המקומית. הכלי gcloud מספק את ממשק שורת הפקודה הראשי ל-GCP, והכלי kubectl מספק את ממשק שורת הפקודה הראשי להרצת פקודות מול אשכולות Kubernetes.

    gcloud -h
kubectl -h
  2. אם כלי השירות האלה לא מותקנים, צריך להתקין אותם:
    1. מתקינים את Cloud SDK,‏ שכולל את כלי שורת הפקודה gcloud.
    2. אחרי שמתקינים את Cloud SDK, מתקינים את כלי שורת הפקודה kubectl באמצעות הפקודה הבאה:
      3. gcloud components install kubectl
  3. משתמשים בכלי gcloud כדי להגדיר שתי הגדרות ברירת מחדל: הפרויקט ואזור ה-Compute שמוגדרים כברירת מחדל. הגדרת ההגדרות האלה מקלה על הרצת פקודות gcloud, כי כשמשתמשים ב-gcloud צריך לציין את הפרויקט ואת אזור המחשוב שבהם רוצים לעבוד.

    כדי להציג את ההגדרות הנוכחיות: 

    gcloud config list

    אם פרויקט או אזור מחשוב לא מופיעים ברשימה, צריך להוסיף אותם באמצעות הפקודות שמוצגות בהמשך. אם מתוך הפלט של הרשימה עולה שצריך לשנות את ההגדרות הנוכחיות כדי שישקפו את הפרויקט ואת אזור (או אזור משנה) החישוב, אפשר להשתמש גם בפקודות הבאות: 

    gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone

    כאשר project-id הוא שם הפרויקט ב-GCP,‏ compute-region הוא שם אזור החישוב ב-GCP ו-compute-zone הוא שם אזור הזמינות ב-GCP. לדוגמה: compute/region us-central1. רשימה של אזורים ותחומים לחישוב זמינה במאמר אזורים ותחומים זמינים.

יצירת אשכול GKE

בשלב הזה תיצרו אשכול Kubernetes בפרויקט GCP (הפרויקט שהגדרתם באמצעות הפקודה gcloud config).

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

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

כאשר cluster-name הוא השם שבחרתם לאשכול.

יצירת האשכול יכולה להימשך כמה דקות. אם הפעולה תצליח, יוצג פלט דומה לזה שבהמשך, עם סטטוס של RUNNING: 

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.14.10-gke.27   35.222.54.89  n1-standard-4  1.14.10-gke.27          RUNNING

הגדרת ההקשר הנוכחי

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

מוודאים שההקשר הנוכחי gcloud מוגדר לאשכול שיצרתם.

  1. קודם כל, צריך לרשום את ההקשרים כדי לקבוע מהו ההקשר הנוכחי. בדוגמה הבאה, ההקשר הנוכחי הוא gke_hybrid-project_us-central1-a_apigee-hybrid. השם כולל את השם של פרויקט ב-GCP‏ (hybrid-project), אזור או אזור משנה (us-central1-a) ושם של אשכול (apigee-hybrid): 
    kubectl config get-contexts
CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
*         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
          gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster
  2. אם צריך, מגדירים את ההקשר הנוכחי לאשכול שיצרתם (האשכול שבו אתם מתכוונים להתקין את Apigee hybrid). בהנחה שזו הפלטה הקודמת get-contexts, אם שם האשכול שיצרתם הוא apigee-cluster באזור us-west1, תעברו להקשר gke_apigee-project_us-west1-a_apigee-cluster באופן הבא: 
    kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster

    כאשר gke_apigee-project_us-west1-a_apigee-cluster הוא שם ההקשר שאליו רוצים לעבור.

  3. בודקים את ההקשר הנוכחי כדי לוודא שהוא מוגדר לאשכול הרצוי. לדוגמה: 
    kubectl config current-context
 gke_apigee-project_us-west1-a_apigee-cluster

הענקת פרטי כניסה לאשכול

פרטי הכניסה של האשכול מאפשרים לכם לגשת למאגרי התוכן שפועלים באשכול. מאחזרים את פרטי הכניסה ומקצים לעצמכם את התפקיד cluster-admin:

  1. מאחזרים את פרטי הכניסה: 
    gcloud container clusters get-credentials cluster-name

    כאשר cluster-name הוא שם האשכול שיצרתם (האשכול שבו אתם מתכוונים להתקין את Apigee Hybrid).

  2. מגדירים את קישור התפקיד באשכול. מריצים את הפקודה הבאה בדיוק כמו שהיא מוצגת: 
    kubectl create clusterrolebinding cluster-admin-binding \
--clusterrole cluster-admin --user $(gcloud config get-value account)

סיכום

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

1 (הבא) שלב 2: התקנת apigeectl 3 4