本文件 AWS CLI 僅適用於 的第 1 版。如需與 第 2 版相關的文件 AWS CLI,請參閱 第 2 版使用者指南 。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 macOS 上安裝、更新和解除安裝 AWS CLI 版本 1
您可以使用套件安裝程式或 ,在 macOS 上安裝 AWS Command Line Interface (AWS CLI) 第 1 版及其相依性pip
。
必要條件
在 macOS 上安裝第 1 AWS CLI 版之前,請確定您已安裝 Python 3.8 或更新版本。 macOS 如需安裝說明,請參閱 Python《入門指南》中的下載 Python
Python 版本支援矩陣
AWS CLI 版本 | 支援的 Python 版本 |
---|---|
1.32.0 至現行版本 | Python 3.8+ |
1.27.0 至 1.31.x | Python 3.7+ |
1.20.0 至 1.26.x | Python 3.6+ |
1.19.0 至 1.19.x | Python 2.7+、Python 3.6+ |
1.17 – 1.18.x | Python 2.7+、Python 3.4+ |
1.0 – 1.16.x | Python 2.6 及更舊版本、Python 3.3 及更舊版本 |
使用套件安裝程式在 macOS 上安裝、更新和解除安裝第 1 AWS CLI 版
在 Linux 或 macOS 上,您可以使用 Bundled Installer 來安裝 AWS Command Line Interface (AWS CLI) 第 1 版。Bundled Installer 包含所有的依存項目,並可於離線使用。
Bundled Installer 無法安裝到包含空格的路徑。
使用搭配 的套件安裝程式安裝 AWS CLI 版本 1 sudo
下列步驟可讓您在任何 macOS 建置上,從命令列安裝 AWS CLI 版本 1。
以下是您可以剪貼當成一組命令來執行的安裝命令的摘要。
對於最新版本的 AWS CLI,請使用下列命令區塊:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
對於 的特定版本 AWS CLI,請將連字號和版本號碼附加至檔案名稱。在此範例中,版本 的檔案名稱 1.16.312
awscli-bundle-1.16.312.zip
會產生下列命令:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
使用套件安裝程式安裝 AWS CLI 版本 1
-
以下列其中一種方式下載 第 1 AWS CLI 版套件安裝程式:
-
使用
curl
命令下載。若為最新版本的 AWS CLI,請使用下列命令區塊:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
若為特定版本的 AWS CLI,請在檔案名稱中附加連字號和版本號碼。在此範例中,版本 的檔案名稱
1.16.312
awscli-bundle-1.16.312.zip
會產生下列命令:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
使用直接連結下載。
如需 AWS CLI的最新版本:https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
對於 的特定版本 AWS CLI,請將連字號和版本號碼附加至檔案名稱。在此範例中,版本 的檔案名稱
1.16.312
awscli-bundle-1.16.312.zip
會導致下列 URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip
-
-
解壓縮 (解壓縮) 套件中的檔案。如果您沒有
unzip
,請使用 macOs 分佈的內建套件管理員來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會在 AWS CLI 上安裝 ,
/usr/local/aws
並在aws
/usr/local/bin
資料夾建立 符號連結。使用-b
選項來建立符號連結,可減少在使用者的$PATH
變數中指定安裝資料夾的需要。這應該可讓所有使用者aws
從任何目錄輸入 AWS CLI 來呼叫 。$
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
根據預設,安裝指令碼會在系統預設版本的 Python 下執行。如果您已安裝 Python 的替代版本,並想要使用它來安裝 AWS CLI,請透過 Python 可執行檔的絕對路徑,對該版本執行安裝指令碼,如下所示。
$
sudo
/usr/local/bin/python3.7
awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws -
確認 已正確 AWS CLI 安裝。
$
aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果發生錯誤,請參閱 對 的錯誤進行故障診斷 AWS CLI。
使用 套件安裝程式安裝 AWS CLI 版本 1,而不需要 sudo
如果您沒有sudo
許可,或只想 AWS CLI 為目前使用者安裝 ,您可以使用先前命令的修改版本。前兩個命令是相同的。
對於最新版本的 AWS CLI,請使用下列命令區塊:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
對於 的特定版本 AWS CLI,請將連字號和版本號碼附加至檔案名稱。在此範例中,版本 的檔案名稱 1.16.312
awscli-bundle-1.16.312.zip
會產生下列命令:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
為目前使用者安裝 AWS CLI 版本 1
-
使用下列其中一種方法下載第 1 AWS CLI 版套件安裝程式:
-
使用
curl
命令下載。若為最新版本的 AWS CLI,請使用下列命令區塊:
$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
若為特定版本的 AWS CLI,請在檔案名稱中附加連字號和版本號碼。在此範例中,版本 的檔案名稱
1.16.312
awscli-bundle-1.16.312.zip
會產生下列命令:$
curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-
1.16.312
.zip" -o "awscli-bundle.zip" -
使用直接連結下載。
如需 AWS CLI的最新版本:https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
對於 的特定版本 AWS CLI,請將連字號和版本號碼附加至檔案名稱。在此範例中,版本 的檔案名稱
1.16.312
會導致下列 URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zipawscli-bundle-1.16.312.zip
-
-
從套件中解壓縮檔案。如果您沒有
unzip
,請使用 Linux 發行版本內建的套件管理工具來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會在 AWS CLI 上安裝 ,
/usr/local/aws
並在aws
/usr/local/bin
目錄建立 符號連結。最後一個命令會使用-b
參數來指定安裝程式放置aws
符號連結檔案的資料夾。您必須具有指定目錄的寫入許可。$
./awscli-bundle/install -b ~/bin/aws
這會將 安裝 AWS CLI 到預設位置 (
~/.local/lib/aws
),並在 建立符號連結 (符號連結)~/bin/aws
。請確保~/bin
位於您的$PATH
環境變數,以讓符號連結能順利執行。$
echo $PATH | grep ~/bin
// See if $PATH contains ~/bin (output will be empty if it doesn't)$
export PATH=~/bin:$PATH
// Add ~/bin to $PATH if necessary -
請確定版本 AWS CLI 1 已安裝在 中的資料夾是
$PATH
變數的一部分。-
在您的使用者資料夾中尋找 Shell 的描述檔指令碼。如果您不確定您擁有哪個 Shell,請執行
echo $SHELL
。$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash –
.bash_profile
、.profile
或.bash_login
-
Zsh –
.zshrc
-
Tcsh –
.tcshrc
、.cshrc
或.login
-
-
在設定檔尾端新增匯出命令,類似於以下範例。
export PATH=
~/.local/bin
:$PATH這個命令會將此範例中的路徑
~/.local/bin
新增到目前現有PATH
變數的前端。 -
將描述檔重新載入到目前的工作階段,讓這些變更生效。
$
source ~/
.bash_profile
-
-
確認 已正確 AWS CLI 安裝。
$
aws --version
aws-cli/1.33.33 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果發生錯誤,請參閱 對 的錯誤進行故障診斷 AWS CLI。
解除安裝第 1 AWS CLI 版套件安裝程式
-
Bundled Installer 會將除了可選符號連結之外的所有內容放在安裝目錄中,因此若要解除安裝,您只需刪除這兩個項目即可。
$
sudo rm -rf /usr/local/aws
$
sudo rm /usr/local/bin/aws
-
(選用) 移除
.aws
資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。警告
這些組態和憑證設定會跨所有 AWS SDKs和 共用 AWS CLI。如果您移除此資料夾,則系統上仍存在的任何 AWS SDKs 無法存取這些資料夾。
資料夾的預設位置在平台之間
.aws
不同,預設情況下,資料夾位於~/.aws/
。 如果您的使用者擁有此目錄的寫入許可,則不需要使用sudo
。$
sudo rm
~/.aws/
使用 pip 安裝、更新和解除安裝 AWS CLI 版本 1
您也可以直接使用 pip
安裝 AWS CLI。
安裝 pip
如果尚未安裝 pip
,您可以使用 Python Packaging Authority 提供的指令碼來安裝。執行 pip --version
來查看您的 Linux 版本是否已包含 Python 和 pip
。如果您已安裝 Python 第 3 版以上的版本,我們建議您使用 pip3
命令。
-
使用
curl
命令下載安裝指令碼。以下命令使用-O
(大寫字母「O」) 參數,指定下載的檔案要存放在目前的資料夾中,並使用遠端主機上的相同名稱。$
curl -O https://bootstrap.pypa.io/get-pip.py
-
搭配
python
或python3
命令執行指令碼來下載並安裝最新版本的pip
及其他必要的支援套件。當您加入--user
參數,指令碼會將pip
安裝到路徑~/.local/bin
。$
python3 get-pip.py --user
AWS CLI 使用 pip 安裝和更新
-
使用
pip
或pip3
命令來安裝 AWS CLI。如果您使用 Python 第 3 版或更新版本,我們建議您使用pip3
命令。對於最新版本的 AWS CLI,請使用下列命令區塊:
$
pip3 install awscli --upgrade --user
對於 的特定版本 AWS CLI,在檔案名稱中附加兩個相等的符號
=
和版本編號。在此範例中,版本 的檔案名稱1.16.312
會是==1.16.312
產生下列命令:$
pip3 install awscli==
1.16.312
--upgrade --user注意
使用終端機適當的引用規則。若要使用
=
字元,您可能需要使用單引號或雙引號才能正確逸出。以下範例使用單引號進行轉義:$
pip3 install 'awscli==
1.16.312
' --upgrade --user -
確認 AWS CLI 是否正確安裝。
$
aws --version
aws-cli/1.33.33 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6
如果找不到此程式,請將它新增到命令列路徑。
將 AWS CLI 版本 1 可執行檔新增至您的 macOS 命令列路徑
在使用 pip
進行安裝後,您可能需要將 aws
程式新增到作業系統的 PATH
環境變數中。程式的位置取決於 Python 的安裝位置。
範例 AWS CLI 安裝位置 - macOS 搭配 Python 3.6 和 pip
(使用者模式)
~/Library/Python/
3.7
/bin
請以您的 Python 版本替代上述範例中的版本。
如果您不知道 Python 的安裝位置,請執行 which python
。
$
which python
/usr/local/bin/python
輸出可能是符號連結的路徑,而非實際的程式。執行 ls
-al
來查看其指向的路徑。
$
ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python
3.7
pip
將程式安裝到包含 Python 應用程式的相同資料夾中。將此資料夾新增至 PATH
變數。
修改 PATH
變數
-
在您的使用者目錄中尋找 Shell 的描述檔命令碼。如果您不確定您擁有哪個 Shell,請執行
echo $SHELL
。$
ls -a ~
. .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
-
Bash –
.bash_profile
、.profile
或.bash_login
-
Zsh –
.zshrc
-
Tcsh –
.tcshrc
、.cshrc
或.login
-
-
將匯出命令新增至您的描述檔指令碼。
export PATH=
~/.local/bin
:$PATH這個命令將路徑 (此範例中的
~/.local/bin
) 新增到目前的PATH
變數。 -
將更新過的設定檔載入到您目前工作階段。
$
source ~/
.bash_profile
AWS CLI 使用 pip 解除安裝
-
如果您使用 安裝 AWS CLI 版本 1
pip
,則也必須使用 解除安裝pip
。$
pip uninstall awscli
如果您使用的是 Python 2 或 3 版,則可能需要使用
pip2
或pip3
命令。使用aws --version
命令來判斷與您已安裝版本 1 相關聯的 Python AWS CLI 版本。$
pip3 uninstall awscli
您可能需要重新啟動命令提示字元視窗或電腦,才能移除所有檔案。
-
(選用) 移除
.aws
資料夾中的共用 AWS SDK和 AWS CLI 設定資訊。警告
這些組態和憑證設定會跨所有 AWS SDKs和 共用 AWS CLI。如果您移除此資料夾,則系統上仍存在的任何 AWS SDKs 無法存取這些資料夾。
資料夾的預設位置在平台之間
.aws
不同,預設情況下,資料夾位於~/.aws/
。 如果您的使用者擁有此目錄的寫入許可,則不需要使用sudo
。$
sudo rm
~/.aws/
安裝 AWS CLI 和解除安裝錯誤的疑難排解
如果您在安裝或解除安裝 之後遇到問題 AWS CLI,請參閱 對 的錯誤進行故障診斷 AWS CLI 以取得疑難排解步驟。如需最相關的故障診斷步驟,請參閱 命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同 和 "aws --version" 命令會在解除安裝 後傳回版本 AWS CLI。