本教學課程說明如何準備本機電腦,以便進行 Python 開發作業,包括開發在 Cloud de Confiance by S3NS上執行的 Python 應用程式。
如果您已設定開發環境,請參閱「Python 和 Cloud de Confiance」,概略瞭解如何在 Cloud de Confiance上執行 Python 應用程式。
目標
- 安裝與 Cloud de Confiance相容的支援 Python 版本。
- 使用
venv隔離依附元件。 - 安裝編輯器 (選用)。
- 安裝 Google Cloud CLI (選用)。
- 安裝 Python 適用的 Cloud 用戶端程式庫 (選用)。
- 安裝其他實用工具。
- 設定驗證機制 (選用)。
安裝 Python
Python 的安裝方式會因作業系統而異。請按照開發環境中執行的作業系統 (macOS、Windows 或 Linux) 指南操作。
macOS
macOS 預設包含 Python 版本,並用於自身用途。為避免干擾 macOS,建議您建立獨立的開發環境,並為 Cloud de Confiance安裝支援的 Python 版本。如要安裝 Python,請使用 homebrew。
如要使用 Homebrew 安裝 Python 套件,您需要編譯器,可以透過安裝 Xcode 的指令列工具取得。
xcode-select --install請按照 Homebrew 首頁上的操作說明安裝 Homebrew,然後使用 Homebrew 安裝 Python,如下所示:
brew install pyenv pyenv install PYTHON_VERSIONPython 版本號碼的格式應為
x.y。例如:pyenv install 3.12安裝完成後,請確認 Python 3 可做為
python和python3使用,且pip也已安裝。執行下列指令,確認 Python 是否可用:
python3 --version輸出內容會顯示版本。您可以前往 Homebrew Python Formulae 頁面瞭解 Python Homebrew,然後檢查版本。
如要確認
pip3是否可用,請執行下列指令:pip3 --version如果已安裝,輸出內容會顯示
pip3版本。如要進一步瞭解最新版pip3,請參閱「pip版本資訊」。如果上述指令未顯示
pip3版本,請確認pip3是否已正確安裝。如果已安裝pip3,但無法運作,請使用下列指令升級至最新版本:python -m pip install --upgrade pipHomebrew 會安裝平台可用的最新 Python 版本。輸出內容中的版本號碼可能與最新官方 Python 版本不同。
Windows
如要在 Windows 環境中安裝 Python,請前往 Python 網站,下載所需 Python 版本的安裝程式。詳情請參閱 Cloud de Confiance支援的 Python 版本。
如要存取您的 Python 版本,請使用 Windows 適用的 Python 啟動器。
如要啟動安裝的 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。
如要在 Linux 環境中安裝 Python,請安裝適用於您發行版本的套件。Debian 和 Ubuntu 的套件為 python3、python3-dev、python3-venv 和 python3-pip,
請使用下列指令安裝這些套件:
sudo apt update sudo apt install python3 python3-dev python3-venv python3-pip安裝完成後,請確認您已安裝
pip:pip3 --version如要瞭解最新版
pip,請參閱 pip 版本資訊。
使用 venv 隔離依附元件
venv
是建立獨立 Python 環境的工具。這些獨立環境可以有不同版本的 Python 套件,因此您可以將某個專案的依附元件與其他專案的依附元件隔開。建議您用 Python 在本機開發時,一律分別使用各專案的虛擬環境。
使用
venv指令,建立整個 Python 安裝作業的虛擬副本。本教學課程會在名為env的資料夾中建立虛擬副本,但您可以為資料夾指定任何名稱。macOS
cd your-project python -m venv envWindows
cd your-project py -m venv envLinux
cd your-project python3 -m venv env啟用虛擬環境,將殼層設為使用 Python 的
venv路徑:macOS
source env/bin/activateWindows
.\env\Scripts\activateLinux
source env/bin/activate現在您可以安裝套件,而不影響其他專案或全域 Python 安裝:
pip install google-cloud-storage如果要中止使用虛擬環境並返回全域 Python,您可以直接停用:
deactivate
如要進一步瞭解 venv,請參閱 venv 文件。
安裝編輯器
您需要編輯器,才能開發 Python 應用程式。以下列出幾個較為熱門的編輯器 (順序不代表熱門程度):
- Microsoft 的 Visual Studio Code
- Jon Skinner 的 Sublime Text
- JetBrains 的 PyCharm
安裝 Python 適用的 Cloud 用戶端程式庫
Python 開發人員可透過 Python 適用的 Cloud 用戶端程式庫,與 Datastore 和 Cloud Storage 等 Cloud de Confiance 服務整合。如要安裝個別 API 的套件 (如 Cloud Storage),請使用類似以下的指令:
pip install --upgrade google-cloud-storage
安裝 gcloud CLI
gcloud CLI 是 Cloud de Confiance的一組指令列工具。其中包含 gcloud 和 bq,可讓您透過指令列存取 Compute Engine、Cloud Storage、BigQuery 和其他產品與服務。您可以利用這些工具進行互動操作,或是在自動化指令碼中執行這些工具。
設定驗證方法
如要使用用戶端程式庫,您必須先設定驗證機制。
為使用者帳戶建立本機驗證憑證:
gcloud auth application-default login
如果傳回驗證錯誤,請確認您已 使用聯合身分登入 gcloud CLI。
詳情請參閱「進行驗證以使用用戶端程式庫」一文。
(選用) 觀測能力
Google Cloud Observability 包含觀測能力服務,可協助您瞭解 Python 應用程式的行為、健康狀態和效能。詳情請參閱「適用於 Python 的 Google Cloud Observability」。
後續步驟
進一步瞭解 Cloud de Confiance上的 Python。
瞭解 Google 的驗證方式。