本文件 AWS CLI 僅適用於 的第 1 版。如需與 第 2 版相關的文件 AWS CLI,請參閱 第 2 版使用者指南 。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 Linux 上安裝,更新和卸載 AWS CLI 版本 1
您可以使用pip
套件管理員或隨附的安裝程式,在大多數 Linux 發行版上安裝 AWS Command Line Interface (AWS CLI) 版本 1 及其相依性。
雖然awscli
套裝軟體可在其他套裝程式管理員 (例如apt
和) 的儲存庫中使用yum
,但這些套件並不由其產生、管理或支援 AWS。我們建議您僅 AWS CLI 從官方 AWS
發佈點安裝,如本指南所述。
章節
必要條件
您必須安裝 Python 3.8 版或更新版本。如需安裝說明,請參閱 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 及更舊版本 |
使用隨附的安裝程式在 Linux 上安裝和解除安裝 AWS CLI 版本 1
在 Linux 或 macOS 上,您可以使用 Bundled Installer 來安裝 AWS CLI第 1 版。Bundled Installer 包含所有的依存項目,並可於離線使用。
注意
Bundled Installer 無法安裝到包含空格的路徑。
使用隨附的安裝程式安裝 AWS CLI 版本 1 sudo
以下步驟使您可以在任何 Linux 或 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。
使用隨附的安裝程式安裝 AWS CLI 版本 1
-
使用下列其中一種方法下載 AWS CLI 版本 1 隨附的安裝程式。
-
使用
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-
導致以下網址 https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
從套件中解壓縮檔案。如果您沒有
unzip
來擷取檔案,請使用 Linux 發行版本內建的套件管理工具來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會安裝 AWS CLI at,
/usr/local/aws
並在/usr/local/bin
目錄中建立符號連結aws
。使用-b
選項來建立符號連結,可減少在使用者的$PATH
變數中指定安裝目錄的需要。這應該可讓所有使用者 AWS CLI 透過aws
從任何目錄輸入來呼叫。$
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
-
以下列其中一種方式下載 AWS CLI 版本 1 隨附的安裝程式。
-
使用
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-
導致以下網址 https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip1.16.312
.zip
-
-
從套件中使用
unzip
解壓縮檔案。如果您沒有unzip
,請使用 Linux 發行版本內建的套件管理工具來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會安裝 AWS CLI at,
/usr/local/aws
並在/usr/local/bin
目錄中建立符號連結aws
。最後一個命令會使用-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 錯誤。
卸載 AWS CLI 版本 1 捆綁的安裝程序
-
如果您 AWS CLI 使用隨附的安裝程式安裝,請依照下列指示進行。Bundled Installer 不會在安裝目錄之外的位置存放資料 (選用符號連結除外),所以解除安裝十分簡單,就是直接刪除這兩個項目。
$
sudo rm -rf /usr/local/aws
$
sudo rm -rf /usr/local/bin/aws
-
(選擇性) 移除資
.aws
料夾中的共用資訊 AWS SDK和 AWS CLI 設定資訊。警告
這些組態和認證設定會在所有 AWS SDKs和 AWS CLI. 如果您移除此資料夾,則系統上仍存在的任何資料夾 AWS SDKs都無法存取這些資料夾。
.aws
文件夾的默認位置在不同平台之間有所不同,默認情況下文件夾位於~/.aws/
。 如果您的使用者具有此目錄的寫入權限,則不需要使用sudo
。$
sudo rm -r
~/.aws/
使用 pip 安裝和卸載 AWS CLI 版本 1
安裝 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
-
請確保包含
pip
的目錄是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
-
-
若要確認
pip
或pip3
已正確安裝,請執行下列命令。$
pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
使用 pip 安裝並更新 AWS CLI 版本 1
-
使用
pip
或pip3
命令來安裝或更新 AWS CLI。如果您使用 Python 第 3 版,建議您使用pip3
命令。交--user
換器pip
會安裝 AWS CLI 到~/.local/bin
。對於最新版本的 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 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
如果發生錯誤,請參閱 排解 AWS CLI 錯誤。
卸載使 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 -r
~/.aws/
使用快速安裝和卸載 AWS CLI 版本 1
安裝扣
如果您尚未安snap
裝,則可以使用規範 Snapcraft 提供的說明進行安裝。執行snap
version
以查看您的 Linux 版本是否已包含snap
。
使用快照安裝和更新 AWS CLI 版本 1
-
針對 AWS CLI 版本 1 執行下列
snap install
命令。$
snap install aws-cli --channel=v1/stable --classic
根據您的權限,您可能需要將其添加
sudo
到命令中。$
sudo snap install aws-cli --channel=v1/stable --classic
-
確認 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 用快照
-
如果您使用安裝了 AWS CLI 版本 1
snap
,則還必須使用snap
.$
snap remove aws-cli
您可能需要重新啟動命令提示字元視窗或電腦,才能移除所有檔案。
-
(選擇性) 移除資
.aws
料夾中的共用資訊 AWS SDK和 AWS CLI 設定資訊。警告
這些組態和認證設定會在所有 AWS SDKs和 AWS CLI. 如果您移除此資料夾,則系統上仍存在的任何資料夾 AWS SDKs都無法存取這些資料夾。
.aws
文件夾的默認位置在不同平台之間有所不同,默認情況下文件夾位於~/.aws/
。 如果您具有此目錄的寫入權限,則不需要使用sudo
。$
sudo rm -r
~/.aws/
將 AWS CLI 版本 1 可執行文件添加到命令行路徑
使用pip
或安裝之後snap
,您可能需要將可aws
執行檔新增至作業系統的PATH
環境變數。
您可以通過運行以下命令來驗證pip
安裝了哪個文件夾。 AWS CLI
$
which aws
/home/
username
/.local/bin/aws
您可以將此參考為 ~/.local/bin/
,因為在 Linux 中 /home/username
對應至 ~
。
如果您忽略 --user
參數並因此沒有以使用者模式進行安裝,可執行檔可能位於 Python 安裝的 bin
資料夾中。如果您不知道 Python 的安裝位置,請執行此命令。
$
which python
/usr/local/bin/python
輸出可能是符號連結的路徑,而非實際可執行檔。執行 ls
-al
來查看其指向的路徑。
$
ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
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 安裝和解除安裝錯誤疑難
如果您在安裝或解除安裝後遇到問題 AWS CLI,請參閱排解 AWS CLI 錯誤疑難排解步驟。如需最相關的故障診斷步驟,請參閱 命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同 和 解除安裝後,aws --version"" 指令會傳回一個版本 AWS CLI。