設定適用於 Azure 的本機 Python 開發環境

上一篇文章:Azure 開發流程

若要使用 Azure 開發 Python 應用程式,您必須先設定本機開發環境。 設定包括建立 Azure 帳戶、安裝 Azure 開發的工具,以及將這些工具連線到您的 Azure 帳戶。

在 Azure 上進行開發需要 Python 3.7 或更高版本。 若要確認工作站上的 Python 版本,請在主控台視窗中輸入 macOS/Linux 或 py --version Windows 的命令 python3 --version

建立 Azure 帳戶

若要使用 Azure 開發 Python 應用程式,您需要 Azure 帳戶。 您的 Azure 帳戶是您用來登入 Azure 的認證,以及您用來建立 Azure 資源的認證。

如果您使用 Azure 工作,請洽詢貴公司的雲端系統管理員,以取得用來登入 Azure 的認證。

否則,您可以 免費建立 Azure 帳戶 ,並免費接收 12 個月的熱門服務,以及 200 美元點數來探索 Azure 30 天。

使用 Azure 入口網站

取得認證之後,您可以在 登入Azure 入口網站https://portal.azure.com 。 Azure 入口網站通常是開始使用 Azure 的最簡單方式,特別是當您不熟悉 Azure 和雲端開發時。 在Azure 入口網站中,您可以執行各種管理工作,例如建立和刪除資源。

如果您已經體驗過 Azure 和雲端開發,您可能會開始使用工具,例如Visual Studio Code和 Azure CLI。 Python 開發人員中心的文章示範如何使用 Azure 入口網站、Visual Studio Code 和 Azure CLI。

使用 Visual Studio Code

開發 Azure 時,您可以使用任何編輯器或 IDE 來撰寫 Python 程式碼。 不過,您可能想要考慮針對 Azure 和 Python 開發使用Visual Studio Code。 Visual Studio Code提供許多 Azure 和 Python 的延伸模組和自訂,讓您的開發週期和從本機環境部署至 Azure 變得更容易。

針對使用 Visual Studio Code 的 Python 開發,請安裝:

  • Python 延伸模組。 此延伸模組包含 IntelliSense (Pylance) 、Linting、偵錯 (多執行緒、遠端) 、Jupyter Notebook、程式碼格式設定、重構、單元測試等。

  • Azure Tools 擴充功能套件。 擴充套件包含擴充功能,可讓您在一個方便的套件中使用Azure App 服務、Azure Functions、Azure 儲存體、Azure Cosmos DB 和 Azure 虛擬機器。 Azure 擴充功能可讓您輕鬆地探索 Azure 並與其互動。

若要從Visual Studio Code安裝擴充功能:

  1. Ctrl+Shift+X 以開啟 [ 延伸模組] 視窗。
  2. 搜尋 Azure Tools 擴充功能。
  3. 選取 [安裝] 按鈕。

Visual Studio Code的螢幕擷取畫面,其中顯示搜尋 Azure 工具延伸模組套件的擴充功能面板。

若要深入瞭解如何在 Visual Studio Code 中安裝擴充功能,請參閱 Visual Studio Code 網站上的擴充功能 Marketplace檔。

安裝 Azure Tools 擴充功能之後,請使用您的 Azure 帳戶登入。 在左側面板中,您會看到 Azure 圖示。 選取此圖示,隨即會出現 Azure 服務的控制台。 選擇 [登入 Azure...] 以完成驗證程式。

Visual Studio Code螢幕擷取畫面,其中顯示如何將 Azure 工具登入 Azure。

注意

如果您看到 「找不到名稱為 [訂用帳戶識別碼] 的訂用帳戶」錯誤,這可能是因為您位於 Proxy 後方,所以無法連線到 Azure API。 請使用您終端機中的Proxy 資訊來設定 HTTP_PROXYHTTPS_PROXY 環境變數:

# Windows
set HTTPS_PROXY=https://username:password@proxy:8080
set HTTP_PROXY=http://username:password@proxy:8080
# macOS/Linux
export HTTPS_PROXY=https://username:password@proxy:8080
export HTTP_PROXY=http://username:password@proxy:8080

使用 Azure CLI

除了Azure 入口網站和Visual Studio Code之外,Azure 也提供Azure CLI命令列工具來建立和管理 Azure 資源。 Azure CLI 提供效率、可重複性,以及編寫週期性工作腳本的能力的優點。 在實務上,大部分開發人員都會使用 Azure 入口網站 和 Azure CLI。

Azure CLI 是透過 macOS 上的 homebrew 安裝。 如果您的系統上沒有可用的 homebrew,請在繼續之前安裝 homebrew

brew update && brew install azure-cli

此命令會先更新您的 brew 存放庫資訊,然後安裝 Azure CLI。

安裝之後,從 Azure CLI 登入您的 Azure 帳戶,方法是在工作站的終端機視窗中輸入 命令 az login

az login

Azure CLI 會開啟您的預設瀏覽器,以完成登入程式。

設定 Python 虛擬環境

建立適用于 Azure 的 Python 應用程式時,建議為每個應用程式建立 虛擬環境 。 虛擬環境是特定 Python 版本的獨立目錄,加上該應用程式所需的其他套件。

若要建立虛擬環境,請遵循下列步驟。

  1. 開啟終端機或命令提示字元。

  2. 為您的專案建立資料夾。

  3. 建立虛擬環境:

    # py -3 uses the global python interpreter. You can also use python3 -m venv .venv.
    py -3 -m venv .venv
    

    此命令會執行 Python venv 模組,並在名為 「.venv」 的資料夾中建立虛擬環境。 一般而言, .gitignore 檔案有 「.venv」 專案,因此虛擬環境不會使用您的程式碼簽入簽入。

  4. 啟用虛擬環境:

    source .venv/Scripts/activate
    

一旦您啟用該環境 (Visual Studio Code 自動加以啟用),在執行 pip install 就只會將程式庫安裝到該環境中。 在虛擬環境中執行的 Python 程式碼會使用安裝到該虛擬環境的特定套件版本。 使用不同的虛擬環境可讓不同的應用程式使用不同的套件版本,有時是必要的。 若要深入瞭解虛擬環境,請參閱 Python 檔中的 虛擬環境和套件

例如,如果您的 需求 位於 requirements.txt 檔案中,則在啟用的虛擬環境中,您可以使用下列專案加以安裝:

pip install -r requirements.txt

下一步