יצירת אשכול היברידי של Google Distributed Cloud במכונות וירטואליות ב-Compute Engine באמצעות Terraform

הקצאת מכונות וירטואליות (VM) של Compute Engine באמצעות Terraform מאפשרת לכם להעריך את Google Distributed Cloud במצב זמינות גבוהה (HA) בלי חומרה פיזית. במדריך הזה תשתמשו בסקריפטים של Terraform כדי להגדיר רשת של מכונות וירטואליות מדומות, לפרוס אשכול היברידי לדוגמה ולאמת את ההתקנה.

הפריסה הזו מיועדת למטרות הערכה בלבד. אל תריצו את Google Distributed Cloud במכונות וירטואליות של Compute Engine בסביבת הייצור. כדי לפרוס את Google Distributed Cloud בסביבת ייצור, פועלים לפי השלבים שמפורטים במאמר יצירת אשכולות בסיסיים.

אם אתם מעדיפים לבדוק את Google Distributed Cloud באמצעות Google Cloud CLI במקום Terraform, קראו את המאמר התנסות ב-Google Distributed Cloud במכונות וירטואליות של Compute Engine.

לפני שמתחילים

הפריסה דורשת את המשאבים הבאים:

הגדרת הרשת של המכונה הווירטואלית ב-Compute Engine

בקטע הזה משתמשים בסקריפטים של Terraform מהמאגר anthos-samples. הסקריפטים מגדירים את Compute Engine עם המשאבים הבאים:

  • שש מכונות וירטואליות לפריסת האשכול ההיברידי:
    • מכונה וירטואלית אחת של אדמין שמשמשת לפריסת האשכול ההיברידי במכונות האחרות.
    • שלוש מכונות וירטואליות לשלושת הצמתים של מישור הבקרה שנדרשים כדי להריץ את מישור הבקרה של האשכול ההיברידי.
    • שתי מכונות וירטואליות לשני צומתי העובדים שנדרשים כדי להריץ עומסי עבודה באשכול ההיברידי.
  • רשת שכבת-על של VxLAN בין כל הצמתים כדי לדמות קישוריות L2.
  • גישת SSH לצמתים של מישור הבקרה והעובדים מה-VM של האדמין.

תשתית Bare Metal ב- Google Cloud באמצעות מכונות וירטואליות של Compute Engine

כדי לשנות את מספר הצמתים באשכול, מוסיפים שמות חדשים של צמתים למשתנה instance_count ב-Terraform:

###################################################################################
# The recommended instance count for High Availability (HA) is 3 for Control plane
# and 2 for Worker nodes.
###################################################################################
variable "instance_count" {
  description = "Number of instances to provision per layer (Control plane and Worker nodes) of the cluster"
  type        = map(any)
  default = {
    "controlplane" : 3
    "worker" : 2
  }
}

  1. מורידים את הסקריפטים של Terraform לדוגמה anthos-bm-gcp-terraform:

    git clone https://github.com/GoogleCloudPlatform/anthos-samples
    cd anthos-samples/anthos-bm-gcp-terraform
    
  2. מעדכנים את הקובץ terraform.tfvars.sample כך שיכלול משתנים שספציפיים לסביבה שלכם:

    project_id       = "PROJECT_ID"
    region           = "GOOGLE_CLOUD_REGION"
    zone             = "GOOGLE_CLOUD_ZONE"
    credentials_file = "PATH_TO_GOOGLE_CLOUD_SERVICE_ACCOUNT_KEY_FILE"
    
  3. משנים את השם של הקובץ terraform.tfvars.sample לשם ברירת המחדל שמשמש את Terraform לקובץ המשתנים:

    mv terraform.tfvars.sample terraform.tfvars
    
  4. מאתחלים את ספריית הדוגמה בתור ספריית העבודה ב-Terraform. כך מגדירים את ההגדרות הנדרשות לניהול המצב של Terraform, בדומה ל-git init:

    terraform init
    
  5. יוצרים תוכנית ביצוע ב-Terraform. בשלב הזה מתבצעת השוואה בין מצב המשאבים, אימות הסקריפטים ויצירת תוכנית ביצוע:

    terraform plan
    
  6. מחילים את השינויים שמתוארים בסקריפט של Terraform. בשלב הזה, התוכנית מופעלת אצל הספק שצוין (במקרה הזה Google Cloud) כדי להגיע למצב היעד של המשאבים:

    terraform apply  # when prompted to confirm the Terraform plan, type 'Yes' and enter
    

פריסת האשכול ההיברידי

אחרי שההרצה של Terraform מסתיימת, אפשר לפרוס את האשכול ההיברידי.

  1. משתמשים ב-SSH כדי להתחבר למארח הניהול:

    gcloud compute ssh tfadmin@cluster1-abm-ws0-001 --project=PROJECT_ID --zone=GOOGLE_CLOUD_ZONE
    

    אפשר להתעלם מההודעות על עדכון המכונה הווירטואלית ולהשלים את המדריך. אם אתם מתכננים להשאיר את המכונות הווירטואליות כסביבת בדיקה, יכול להיות שתרצו לעדכן את מערכת ההפעלה או לשדרג לגרסה הבאה, כמו שמתואר ב מסמכי התיעוד של Ubuntu.

  2. מריצים את בלוק הקוד הבא כדי ליצור את אשכול cluster1 ההיברידי במכונות הווירטואליות שהוגדרו ב-Compute Engine:

    sudo ./run_initialization_checks.sh && \
    sudo bmctl create config -c cluster1 && \
    sudo cp ~/cluster1.yaml bmctl-workspace/cluster1 && \
    sudo bmctl create cluster -c cluster1
    

הרצת הפקודה bmctl מתחילה את ההגדרה של אשכול היברידי חדש. הפעולות האלה כוללות בדיקות מקדימות בצמתים, יצירת אשכולות של אדמינים ומשתמשים וגם רישום האשכול ב- Google Cloud באמצעות Connect Agent. תהליך ההגדרה כולו יכול להימשך עד 15 דקות. בזמן יצירת האשכול, הפלט הבא יוצג:

    Created config: bmctl-workspace/cluster1/cluster1.yaml
    Creating bootstrap cluster... OK
    Installing dependency components... OK
    Waiting for preflight check job to finish... OK
    - Validation Category: machines and network
            - [PASSED] 10.200.0.3
            - [PASSED] 10.200.0.4
            - [PASSED] 10.200.0.5
            - [PASSED] 10.200.0.6
            - [PASSED] 10.200.0.7
            - [PASSED] gcp
            - [PASSED] node-network
    Flushing logs... OK
    Applying resources for new cluster
    Waiting for cluster to become ready OK
    Writing kubeconfig file
    kubeconfig of created cluster is at bmctl-workspace/cluster1/cluster1-kubeconfig, please run
    kubectl --kubeconfig bmctl-workspace/cluster1/cluster1-kubeconfig get nodes
    to get cluster node status.
    Please restrict access to this file as it contains authentication credentials of your cluster.
    Waiting for node pools to become ready OK
    Moving admin cluster resources to the created admin cluster
    Flushing logs... OK
    Deleting bootstrap cluster... OK

אימות האשכול ואינטראקציה איתו

קובץ ה-kubeconfig של האשכול נמצא במכונת האדמין בספרייה bmctl-workspace. כדי לאמת את הפריסה, מבצעים את השלבים הבאים.

  1. אם התנתקתם מהמארח של האדמין, אתם יכולים להשתמש ב-SSH כדי להתחבר למארח:

    # You can copy the command from the output of the Terraform execution above
    gcloud compute ssh tfadmin@cluster1-abm-ws0-001 --project=PROJECT_ID --zone=GOOGLE_CLOUD_ZONE
    
  2. מגדירים את משתנה הסביבה KUBECONFIG עם הנתיב לקובץ התצורה של האשכול כדי להריץ פקודות kubectl באשכול:

    export CLUSTER_ID=cluster1
    export KUBECONFIG=$HOME/bmctl-workspace/$CLUSTER_ID/$CLUSTER_ID-kubeconfig
    kubectl get nodes
    

    הצמתים של האשכול אמורים להופיע, בדומה לפלט הבא:

    NAME          STATUS   ROLES    AGE   VERSION
    cluster1-abm-cp1-001   Ready    master   17m   v1.18.6-gke.6600
    cluster1-abm-cp2-001   Ready    master   16m   v1.18.6-gke.6600
    cluster1-abm-cp3-001   Ready    master   16m   v1.18.6-gke.6600
    cluster1-abm-w1-001    Ready    <none>   14m   v1.18.6-gke.6600
    cluster1-abm-w2-001    Ready    <none>   14m   v1.18.6-gke.6600
    

התחברות לאשכול ממסוף Google Cloud

כדי לצפות בעומסי העבודה במסוף Google Cloud , צריך להתחבר לאשכול.

להוראות ולמידע נוסף על התחברות לאשכול, קראו את המאמר עבודה עם אשכולות ממסוף Google Cloud .

הסרת המשאבים

יש שתי דרכים לנקות את הגדרת האשכול.

המסוף

Terraform

  • צריך לבטל את הרישום של האשכול לפני שמוחקים את כל המשאבים שנוצרו על ידי Terraform.
# Use SSH to connect to the admin host
gcloud compute ssh tfadmin@cluster1-abm-ws0-001 --project=PROJECT_ID --zone=GOOGLE_CLOUD_ZONE

# Reset the cluster
export CLUSTER_ID=cluster1
export KUBECONFIG=$HOME/bmctl-workspace/$CLUSTER_ID/$CLUSTER_ID-kubeconfig
sudo bmctl reset --cluster $CLUSTER_ID

# log out of the admin host
exit
  • משתמשים ב-Terraform כדי למחוק את כל המשאבים.
terraform destroy --auto-approve