本文件僅適用於 AWS CLI 的第 1 版。如需 AWS CLI 第 2 版的相關文件,請參閲第 2 版使用者指南。
在 Linux 上安裝、更新和解除安裝 AWS CLI 第 1 版
您可以使用 pip
套件管理器或隨附的安裝程式,在大多數 Linux 發行版上安裝 AWS Command Line Interface (AWS CLI) 第 1 版及其相依性。
雖然 awscli
套件在儲存區中可供其他套件管理程式使用,例如 apt
和 yum
,但這些套件不會或由 AWS 產生、管理或支援。建議您僅從官方 AWS 發佈點安裝 AWS CLI,如本指南中所述。
先決條件
您必須安裝 Python 3.6 版或更新版本。如需安裝說明,請參閱 Python《入門指南》中的下載 Python
Python 軟體基金會
若要將舊版 Python 與 AWS CLI 第 1 版搭配使用,您需要安裝舊版的 AWS CLI 第 1 版。若要檢視 AWS CLI 第 1 版 Python 版本支援對照表,請參閱 Python 版本要求。
使用 Bundled Installer 在 Linux 上安裝和解除安裝 AWS CLI 第 1 版
在 Linux 或 macOS 上,您可以使用 Bundled Installer 來安裝 AWS CLI 第 1 版。Bundled Installer 包含所有的依存項目,並可於離線使用。
Bundled Installer 無法安裝到包含空格的路徑。
主題
透過 sudo
使用 Bundled Installer 安裝 AWS CLI 第 1 版
下列步驟可讓您從任何 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
請依照命令列的這些步驟,使用 Bundled Installer 來安裝 AWS CLI 第 1 版。
使用 Bundled Installer 安裝 AWS CLI 第 1 版
-
使用下列其中一種方法下載 AWS CLI 第 1 版的 Bundled Installer。
-
使用
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-exe-linux-aarch64-2.0.30.zip
,因此使用以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-2.0.30.zip
-
-
從套件中解壓縮檔案。如果您沒有
unzip
來擷取檔案,請使用 Linux 發行版本內建的套件管理工具來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會將 AWS CLI 安裝到
/usr/local/aws
,並在/usr/local/bin
目錄中建立符號連結aws
。使用-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.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13
如果發生錯誤,請參閱 故障診斷 AWS CLI 錯誤。
不透過 sudo
使用 Bundled Installer 安裝 AWS CLI 第 1 版
如果您沒有 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 版的 Bundled Installer。
-
使用
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-exe-linux-aarch64-2.0.30.zip
,因此使用以下 URL:https://s3.amazonaws.com/aws-cli/awscli-bundle-2.0.30.zip
-
-
從套件中使用
unzip
解壓縮檔案。如果您沒有unzip
,請使用 Linux 發行版本內建的套件管理工具來安裝它。$
unzip awscli-bundle.zip
-
執行安裝程式。安裝程式會將 AWS CLI 安裝到
/usr/local/aws
,並在/usr/local/bin
目錄中建立符號連結aws
。最後一個命令會使用-b
參數來指定安裝程式放置aws
符號連結檔案的資料夾。您必須具有指定資料夾的寫入權限。$
./awscli-bundle/install -b ~/bin/aws
這會將 AWS CLI 安裝到預設位置 (
~/.local/lib/aws
) 並在~/bin/aws
中建立符號連結 (symlink)。請確保~/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.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13
如果發生錯誤,請參閱 故障診斷 AWS CLI 錯誤。
解除安裝 AWS CLI 第 1 版 Bundled Installer
-
如果您已使用 Bundled Installer 安裝 AWS CLI,請按下列說明操作。Bundled Installer 不會在安裝目錄之外的位置存放資料 (選用符號連結除外),所以解除安裝十分簡單,就是直接刪除這兩個項目。
$
sudo rm -rf /usr/local/aws
$
sudo rm /usr/local/bin/aws
-
(選用) 移除
.aws
資料夾中的共享 AWS SDK 和 AWS CLI 設定資訊。警告 這些組態和憑據設定在所有 AWS SDK 和 AWS CLI 之間共用。如果您移除此資料夾,則您的系統中仍然存在的任何 AWS SDK 將無法存取它們。
.aws
資料夾的預設位置在平台之間各不相同,預設情況下,資料夾位於~/.aws/
。如果您的使用者帳戶具有此資料夾的寫入許可,您不需要使用sudo
。$
sudo rm
~/.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 19.2.3 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.22.23 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13
如果發生錯誤,請參閱 故障診斷 AWS CLI 錯誤。
新增 AWS CLI 第 1 版可執行檔到您的命令列路徑
在使用 pip
進行安裝後,您可能需要將 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
使用 Pip 解除安裝 AWS CLI
-
如果您已使用
pip
或pip3
安裝 AWS CLI,您需要透過執行下列其中一個命令,解除安裝使用相同套件管理工具的 AWS CLI。$
pip uninstall awscli
$
pip3 uninstall awscli
-
(選用) 移除
.aws
資料夾中的共享 AWS SDK 和 AWS CLI 設定資訊。警告 這些組態和憑據設定在所有 AWS SDK 和 AWS CLI 之間共用。如果您移除此資料夾,則您的系統中仍然存在的任何 AWS SDK 將無法存取它們。
.aws
資料夾的預設位置在平台之間各不相同,預設情況下,資料夾位於~/.aws/
。如果您的使用者帳戶具有此資料夾的寫入許可,您不需要使用sudo
。$
sudo rm
~/.aws/