安裝命 AWS Encryption SDK 令行界面

本主題說明如何安裝 AWS 加密 CLI。有關詳細信息，請參閱上的aws-encryption-sdk-cli存儲庫 GitHub 和閱讀文檔。

安裝必要項目

加 AWS 密 CLI 建置在 適用於 Python 的 AWS Encryption SDK. 若要安裝 AWS 加密 CLI，您需要 Python 和 pip Python 套件管理工具。所有支援的平台皆有提供 Python 與 pip。

安裝加 AWS 密 CLI 之前，請先安裝下列必要條件，

Python

AWS 加密 CLI 版本 4.2.0 及更高版本需要 Python 3.8 或更高版本。

舊版的 AWS 加密 CLI 支援 Python 2.7 和 3.4 及更新版本，但我們建議您使用最新版本的 AWS 加密 CLI。

大多數 Linux 和 macOS 安裝都包含 Python，但您需要升級到 3.6 或更新版本。我們建議您使用最新版本的 Python。在視窗上，您必須安裝 Python; 默認情況下不會安裝它。若要下載並安裝 Python，請參閱下載。

若要判斷 Python 是否已安裝完畢，請於命令列輸入下列內容。

python

若要查看 Python 版本，請使用 -V (大寫 V) 參數。

python -V

在視窗上，安裝 Python 之後，將Python.exe檔案的路徑新增至路徑環境變數的值。

在預設情況下，Python 會安裝在 $home 子目錄的所有使用者目錄或使用者描述檔目錄中 (%userprofile% 或 AppData\Local\Programs\Python)。若要找出系統中的 Python.exe 檔案，請查看下列登錄機碼。您可以使 PowerShell 用搜索註冊表。

PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath

pip

pip 為 Python 套件管理工具。若要安裝加 AWS 密 CLI 及其相依性，您需要 pip 8.1 或更新版本。如需安裝或升級的說明pip，請參閱pip文件中的安裝。

在 Linux 安裝上，8.1 之pip前的版本無法建置 AWS 加密 CLI 所需的加密程式庫。如果您選擇不更新pip版本，則可以單獨安裝構建工具。如需詳細資訊，請參閱在 Linux 上建置密碼編譯。

AWS Command Line Interface

只有在 AWS Command Line Interface (AWS CLI) 搭配 AWS 加密 CLI 使用 AWS KMS keys 時，才需要 AWS Key Management Service (AWS KMS)。如果您使用不同的主要金鑰提供者， AWS CLI 則不需要。

若要 AWS KMS keys 與 AWS 加密 CLI 搭配使用，您需要安裝並設定 AWS CLI. 此組態可讓您用來驗證的認證 AWS KMS 供加 AWS 密 CLI 使用。

安裝和更新加 AWS 密 CLI

安裝最新版本的 AWS 加密 CLI。當您使用安裝pip加 AWS 密 CLI 時，它會自動安裝 CLI 所需的程式庫，包括 Python 密碼編譯程式庫和. 適用於 Python 的 AWS Encryption SDKAWS SDK for Python (Boto3)

注意

早於 4.0.0 的 AWS 加密 CLI 版本處於此end-of-support階段。

您可以從 2.1 版安全地更新。 x 和更新版本的 AWS 加密 CLI 的最新版本，無需任何代碼或數據更改。但是，2.1 版中引入了新的安全功能。 x 不向後相容。要從 1.7 版本更新。 x 或更早版本，您必須先更新到最新的 1。 x 版本的 AWS 加密 CLI。如需詳細資訊，請參閱 遷移您的AWS Encryption SDK。

新的安全功能最初在 AWS 加密 CLI 版本 1.7 中發布。 X 和 2.0。 x. 但是， AWS 加密 CLI 版本 1.8。 x 取代了 1.7 版本。 x 和 AWS 加密 CLI 碼 2.1. x 取代了 2.0。 x. 如需詳細資訊，請參閱的aws-encryption-sdk-cli儲存庫中的相關安全性建議 GitHub。

安裝最新版本的 AWS 加密 CLI

pip install aws-encryption-sdk-cli

升級至最新版本的 AWS 加密 CLI

pip install --upgrade aws-encryption-sdk-cli

查找加 AWS 密 CLI 的版本號和 AWS Encryption SDK

aws-encryption-cli --version

輸出會列出兩個程式庫的版本號碼。

aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0

升級至最新版本的 AWS 加密 CLI

pip install --upgrade aws-encryption-sdk-cli

安裝加 AWS 密 CLI 也會安裝最新版本的 AWS SDK for Python (Boto3)(如果尚未安裝)。如果安裝了 Boto3，安裝程序會驗證 Boto3 版本並在需要時更新它。

若要尋找您已安裝的 Boto3 版本

pip show boto3

要更新到最新版本的肉毒桿菌 3

pip install --upgrade boto3

若要安裝目前正在開發中的 AWS 加密 CLI 版本，請參閱上的aws-encryption-sdk-cli存放庫 GitHub。

如需使用 pip 安裝與升級 Python 套件的詳細資訊，請參閱 pip 文件。