הגדרה של סביבת פיתוח ב-Python

במדריך הזה מוסבר איך להכין את המחשב המקומי לפיתוח ב-Python, כולל פיתוח אפליקציות Python שפועלות ב- Google Cloud.

אם כבר הגדרתם סביבת פיתוח, ב-Python ו- Google Cloud מוסבר איך להריץ אפליקציות Python ב- Google Cloud.

טיפ: אם רוצים להתחיל לעבוד במהירות, אפשר להשתמש ב-Cloud Shell Editor. זו סביבת פיתוח משולבת שתומכת במחזור הפיתוח המלא של אפליקציות Google Kubernetes Engine ו-Cloud Run. העורך של Cloud Shell מבוסס על Code OSS ומגיע עם הכלים Google Cloud CLI ו-Cloud Code שכבר מותקנים בו.

מטרות

  • מתקינים גרסה נתמכת של Python שתואמת ל- Google Cloud.
  • כדי לבודד תלות, משתמשים ב-venv.
  • מתקינים עורך (אופציונלי).
  • מתקינים את Google Cloud CLI (אופציונלי).
  • מתקינים את ספריות הלקוח של Cloud לשימוש ב-Python (אופציונלי).
  • התקנה של כלים שימושיים אחרים.
  • מגדירים אימות (אופציונלי).

התקנת Python

הוראות ההתקנה של Python משתנות בהתאם למערכת ההפעלה. פועלים לפי המדריך למערכת ההפעלה שבה אתם משתמשים בסביבת הפיתוח: macOS,‏ Windows או Linux.

macOS

‫macOS כולל גרסה של Python כברירת מחדל ומשתמש בה למטרות שלו. כדי להימנע מהפרעה ל-macOS, מומלץ ליצור סביבת פיתוח נפרדת ולהתקין גרסה נתמכת של Python ל- Google Cloud. כדי להתקין את Python, משתמשים ב-homebrew.

  1. כדי להשתמש ב-Homebrew להתקנת חבילות Python, צריך קומפיילר. אפשר לקבל אותו על ידי התקנת כלי שורת הפקודה של Xcode.

    xcode-select --install
    
  2. כדי להתקין את Python באמצעות Homebrew, פועלים לפי ההוראות בדף הבית של Homebrew.

    brew install pyenv
    pyenv install PYTHON_VERSION
    

    מספר הגרסה של Python צריך להיות בפורמט x.y. לדוגמה:

    pyenv install 3.12
    
  3. אחרי שההתקנות מסתיימות, מוודאים ש-Python 3 זמין בתור python ו-python3, וגם ש-pip מותקן.

    כדי לוודא ש-Python זמין, מריצים את הפקודה הבאה:

    python3 --version
    

    הגרסה מוצגת בפלט. אפשר לקרוא על Python homebrew בדף Homebrew Python Formulae ואז לבדוק את הגרסה.

    כדי לוודא ש-pip3 זמין, מריצים את הפקודה הבאה:

    pip3 --version
    

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

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

    python -m pip install --upgrade pip
    

    ‫Homebrew מתקין את הגרסאות העדכניות ביותר של Python שזמינות בפלטפורמה שלכם. יכול להיות שמספרי הגרסאות בפלט יהיו שונים מהגרסאות הרשמיות האחרונות של Python.

Windows

  1. כדי להתקין את Python בסביבת Windows, מורידים את קובץ ההתקנה של גרסת Python הרצויה מהאתר של Python. מידע נוסף מופיע במאמר בנושא גרסאות Python שנתמכות ל- Google Cloud.

  2. כדי לגשת לגרסה של Python, משתמשים בPython launcher for Windows.

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

    py
    

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

    py -3
    

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

    py -m pip --version
    

    הפלט מציג את הגרסה מתוך C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages.

    אפשר לקרוא על הגרסה האחרונה של pip בהערות המוצר של pip.

Linux

רוב הפצות ה-Linux כוללות גרסאות עדכניות של Python.

  1. כדי להתקין את Python בסביבת Linux, צריך להתקין את החבילות המתאימות להפצה שלכם. ב-Debian וב-Ubuntu, החבילות האלה הן python3,‏ python3-dev,‏ python3-venv ו-python3-pip.

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

    sudo apt update
    sudo apt install python3 python3-dev python3-venv python3-pip
    
  2. אחרי שההתקנות מסתיימות, מוודאים שהתקנתם את pip:

    pip3 --version
    

    אפשר לקרוא על הגרסה האחרונה של pip בהערות המוצר של pip.

שימוש ב-venv כדי לבודד תלויות

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

  1. משתמשים בפקודה venv כדי ליצור עותק וירטואלי של כל התקנת Python. במדריך הזה נוצר עותק וירטואלי בתיקייה בשם env, אבל אפשר לציין שם אחר לתיקייה.

    macOS

    cd your-project
    python -m venv env
    

    Windows

    cd your-project
    py -m venv env
    

    Linux

    cd your-project
    python3 -m venv env
    
  2. מגדירים את המעטפת לשימוש בנתיבי venv עבור Python על ידי הפעלת הסביבה הווירטואלית:

    macOS

    source env/bin/activate
    

    Windows

    .\env\Scripts\activate
    

    Linux

    source env/bin/activate
    
  3. עכשיו אפשר להתקין חבילות בלי להשפיע על פרויקטים אחרים או על התקנת Python הגלובלית:

    pip install google-cloud-storage
    

    אם רוצים להפסיק להשתמש בסביבה הווירטואלית ולחזור ל-Python הגלובלי, אפשר להשבית אותה:

    deactivate
    

מידע נוסף על venv זמין במסמכי venv.

התקנת עורך

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

התקנת ספריות הלקוח של Cloud לשימוש ב-Python

ספריות הלקוח של Cloud לשימוש ב-Python מאפשרות למפתחי Python לשלב שירותים כמו Datastore ו-Cloud Storage. Google Cloud כדי להתקין את החבילה עבור API ספציפי כמו Cloud Storage, משתמשים בפקודה שדומה לפקודה הבאה:

pip install --upgrade google-cloud-storage

התקנת ה-CLI של gcloud

ה-CLI של gcloud הוא קבוצה של כלי שורת פקודה ל- Google Cloud. הוא מכיל את gcloud ואת bq, שבהם אפשר להשתמש כדי לגשת ל-Compute Engine, ל-Cloud Storage, ל-BigQuery ולמוצרים ושירותים אחרים משורת הפקודה. אפשר להפעיל את הכלים האלה באופן אינטראקטיבי או בסקריפטים אוטומטיים.

מגדירים אימות

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

אם אתם משתמשים במעטפת מקומית, אתם צריכים ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:

gcloud auth application-default login

אם אתם משתמשים ב-Cloud Shell, אין צורך לבצע את הפעולה הזו.

אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

מידע נוסף זמין במאמר אימות לצורך שימוש בספריות לקוח.

המאמרים הבאים