התקנת Google Cloud CLI

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

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

תראו לי איך

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

  1. נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

התקנת גרסה 579.0.0 של ה-CLI של gcloud

Linux
  1. קודם מוודאים שיש תמיכה בגרסת Python שלכם. ב-Google Cloud CLI צריך להשתמש ב-Python 3.10 עד 3.14. חבילת x86_64 של Linux כוללת מתורגמן Python בחבילה, שיקבל עדיפות כברירת מחדל. במאמרי העזרה בנושא gcloud topic startup מוסבר איך בוחרים את רכיב התרגום ב-Python ואיך מגדירים אותו.
  2. מורידים אחת מהחבילות הבאות:
    פלטפורמה שם חבילה גודל סיכום ביקורת (checksum)‏ SHA256
    ‏Linux‏ 64 סיביות

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz ‫96.1MB bd0f7eab135cfe64ca28d4cf1c4af2b20da40c63966f05066a546de41775713e
    ‏Linux‏ 64 סיביות

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz ‫61.5MB 1908a3c9feade59310532d555c02530301ed23f5eca524a6ef4bb6fe55396160
    ‏Linux‏ 32 סיביות

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz ‫61.6MB 6a19488ae14a8211b9d2f677f22cc219df0b51ecb1e2558501e136597d445d3f

    כדי להוריד את קובץ הארכיון של Linux, מריצים את הפקודה הבאה: 

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

    מעיינים בטבלה שלמעלה ומחליפים את google-cloud-cli-linux-x86_64.tar.gz בשם החבילה *.tar.gz שרלוונטי להגדרה שלכם.

  3. כדי לחלץ את התוכן של הקובץ למערכת הקבצים, מריצים את הפקודה הבאה: 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     כדי להחליף התקנה קיימת, מוחקים את ספריית google-cloud-sdk הקיימת ומחלצים את קובץ הארכיון לאותו המיקום.
  4. מריצים את סקריפט ההתקנה מהרמה הבסיסית (root) של התיקייה שאליה חילצתם את הקבצים:
    ‫
    ./google-cloud-sdk/install.sh
     הסקריפט יבקש מכם לבצע את פעולות ההגדרה הבאות. כדי לאשר, עונים לשיחה Y כשמופיעה בקשה.
    • מוסיפים את ה-CLI של gcloud ל-PATH.
    • מפעילים את השלמת הפקודות.
    • מאשרים לשלוח נתוני שימוש אנונימיים כדי לעזור לשפר את ה-CLI של gcloud.
    אפשר גם לבצע את ההתקנה באופן לא אינטראקטיבי על ידי ציון דגלים. כדי לראות את הדגלים הזמינים, מריצים את הפקודה: 
    ./google-cloud-sdk/install.sh --help
  5. אופציונלי: אם עדכנתם את PATH בשלב הקודם, פותחים טרמינל חדש כדי שהשינויים ייכנסו לתוקף.
Debian/Ubuntu

תכולת החבילה

ה-CLI של gcloud זמין בפורמט של חבילה להתקנה במערכות Debian ו-Ubuntu. החבילה הזו כוללת רק את כלי שורת הפקודה gcloud,‏ gcloud alpha,‏ gcloud beta,‏ gsutil ו-bq. היא לא כוללת את הפקודה kubectl או את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות פקודות gcloud. את הרכיבים האלו תצטרכו להתקין בנפרד בהתאם לצורך.

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

לפני שמתקינים את ה-CLI של gcloud צריך לוודא שמערכת ההפעלה עומדת בדרישות הבאות:

  • מותקנת גרסת Ubuntu שלא הגיעה לסוף חיי המוצר או גרסה יציבה של Debian שלא הגיעה לסוף חיי המוצר.
  • החבילות שבה התעדכנו לאחרונה. כדי לעשות זאת עכשיו, מריצים את הפקודה הבאה: 
    sudo apt-get update
  • מותקנות בה הפקודות ca-certificates,‏ gnupg ו-curl. כדי להתקין את החבילות האלה, מריצים את הפקודה הבאה: 
    sudo apt-get install ca-certificates gnupg curl

התקנה

  1. מייבאים את Google Cloud המפתח הציבורי.

    • בגרסאות חדשות יותר (Debian 9 ואילך או Ubuntu 18.04 ואילך), מריצים את הפקודה הבאה:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • בגרסאות ישנות יותר של הפצות, מריצים את הפקודה הבאה: 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • אם היא לא תומכת בארגומנט --keyring, מריצים את הפקודה הבאה:

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • אם אתם לא מצליחים לקבל עדכונים בגלל שתוקף המפתח פג, עליכם לקבל את קובץ המפתח apt-get.gpg העדכני.

  2. מוסיפים את URI ההפצה של ה-CLI של gcloud בתור מקור של חבילה.
    • בגרסאות חדשות יותר (Debian 9 ואילך או Ubuntu 18.04 ואילך), מריצים את הפקודה הבאה: 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

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

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. עדכון והתקנת ה-CLI של gcloud:
    ‫
    sudo apt-get update && sudo apt-get install google-cloud-cli
     תוכלו לקרוא על עוד אפשרויות לפקודה apt-get, כמו השבתת הנחיות או הרצות בדיקה, במדריך המפורט של apt-get.

    טיפ לגבי Docker: כשמתקינים את ה-CLI של gcloud בקובץ אימג' של Docker, אפשר להשתמש בפקודת RUN יחידה:

    ‫
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    לגבי תמונות בסיס ישנות שלא תומכות בפקודה gpg --dearmor: 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. אופציונלי: התקנת רכיבים נוספים:
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-tools
    • google-cloud-cli-tests
    • kubectl

    לדוגמה, את הרכיב google-cloud-cli-app-engine-java אפשר להתקין כך: 

    sudo apt-get install google-cloud-cli-app-engine-java

שדרוג לאחור של גרסאות ה-CLI של gcloud

כדי לחזור לגרסה קודמת ספציפית של ה-CLI של gcloud שבה הפורמט של VERSION הוא 123.0.0, מריצים את הפקודה הבאה:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

עשר הגרסאות האחרונות תמיד זמינות במאגר. בגרסאות שלפני 371.0.0 שם החבילה הוא google-cloud-sdk.

Red Hat/Fedora/CentOS

תכולת החבילה

ה-CLI של gcloud זמין בפורמט של חבילה להתקנה במערכות של Red Hat Enterprise Linux 7,‏ 8,‏ 9 ו-10;‏ Fedora 41 ו-42; ו-CentOS 7 ו-8. החבילה הזו כוללת רק את הפקודות gcloud,‏ gcloud alpha,‏ gcloud beta,‏ gsutil ו-bq. היא לא כוללת את הפקודה kubectl או את התוספים של App Engine שנדרשים לפריסת אפליקציה באמצעות הפקודות gcloud שאותן אפשר להתקין בנפרד, כמו שמתואר בהמשך.

התקנה

  1. מעדכנים את DNF בפרטי המאגר של ה-CLI של gcloud.

    • הדוגמה הבאה מתייחסת להתקנות שתואמות ל-Red Hat Enterprise Linux 7,‏ 8 או 9, אבל חשוב לעדכן את ההגדרות לפי הצורך בהתאם להגדרה שלכם:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

    • לגבי התקנות שתואמות ל-RHEL 10, משתמשים בפקודה הבאה עם gpgkey המעודכן:

      sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1