為什麼要從來源建置？快速步驟步驟 1：設定所有要求步驟 2：設定 AWS CLI 來源安裝步驟 3：建置 AWS CLI 步驟 4：安裝 AWS CLI 步驟 5：驗證 AWS CLI 安裝工作流程範例故障診斷 AWS CLI 安裝和解除安裝錯誤後續步驟

從來源建置和安裝 AWS CLI

本主題將描述如何在支援的作業系統上從來源安裝或更新 AWS Command Line Interface (AWS CLI)。

如需 AWS CLI 最新版本的詳細資訊，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

重要

AWS CLI 第 1 版及第 2 版會使用相同的 aws 命令名稱。如果已安裝 AWS CLI 第 1 版，請參閱第 2 AWS CLI 版的遷移指南。

為什麼要從來源建置？

AWS CLI 可作為大多數平台和環境的預先建置安裝程式以及 Docker 映像檔。

這些安裝程式通常涵蓋大多數的使用案例。從來源安裝的說明是為了幫助我們的安裝程式未涵蓋的使用案例。部分使用案例如下：

預先建置的安裝程式不支援您的環境。例如，預先建置的安裝程式不支援 ARM 32 位元。
預先建置的安裝程式具有您環境缺少的相依性。例如，Alpine Linux 使用 musl，但是現有的安裝程式需要 glibc，造成預先建置的安裝程式無法立即運作。
預先建置的安裝程式需要您的環境限制存取的資源。例如，強化安全性的系統可能不會授予共用記憶體的權限。這是凍結的 aws 安裝程式所需的。
預先建置的安裝程式通常是套件管理工具中維護程式的封鎖程式，通常建議程式碼和套件在建置過程中取得完全控制權限。從來源建置讓分發維護程式能以更簡化的流程持續更新 AWS CLI。啟用維護程式可在客戶從 brew、yum 和 apt 等第三方套件管理工具安裝時，提供客戶更新的 AWS CLI 版本。
修補 AWS CLI 功能的客戶需要從來源建置和安裝 AWS CLI。對於希望在將對來源的變更送到 AWS CLI GitHub 儲存庫之前，先行測試的社群成員，這一點尤其重要。

快速步驟

注意

所有程式碼範例都是假設從來源目錄的根目錄執行。

如果要從來源建置和安裝 AWS CLI，請遵循本節的步驟。AWS CLI 利用 GNU 自動工具從來源安裝。在最簡單的情況下，AWS CLI 可以從來源安裝，從 AWS CLI GitHub 儲存庫的根目錄執行預設範例命令。

為您的環境設定所有需求。這包括能執行 GNU 自動工具產生的檔案和安裝 Python 3.8 或更新版本。
在您的終端中，導航到 AWS CLI 來源資料夾的頂層並執行 ./configure 命令。此命令會檢查系統中是否有所有必要的相依性，並根據偵測到和指定的組態產生 Makefile 用於建置和安裝 AWS CLI。
Linux and macOS
下列 ./configure 命令範例會設定 AWS CLI 使用預設設定的建置組態。
```
$ ./configure
```
Windows PowerShell
執行任何呼叫 MSYS2 的命令之前，您必須保留現有的工作目錄：
```
PS C:\> $env:CHERE_INVOKING = 'yes'
```
然後使用下列 ./configure 命令範例，使用 Python 可執行檔的本機路徑設定 AWS CLI 的建置組態，安裝到 C:\Program Files\AWSCLI，然後下載所有相依性。
```
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
```
如需詳細資訊、可用的組態選項和預設設定資訊，請參閱步驟 2：設定 AWS CLI 來源安裝一節。
執行 make 命令。此命令會根據您的組態設定建置 AWS CLI。

下列 make 命令範例會使用您現有的 ./configure 設定，以預設選項建置。
Linux and macOS
```
$ make
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make" 
```
如需詳細資訊和可用的建置選項，請參閱步驟 3：建置 AWS CLI 一節。
執行 make install 命令。此命令會將您的建置 AWS CLI 安裝到系統上配置的位置。

以下 make install 命令範例安裝您的建置 AWS CLI 並使用預設命令設定在配置的位置建立 symlink。
Linux and macOS
```
$ make install
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make install" 
```
安裝之後，請使用下列命令，將路徑新增至 AWS CLI：
```
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
```
如需詳細資訊和可用的安裝選項，請參閱步驟 4：安裝 AWS CLI 一節。
使用以下命令，確認 AWS CLI 已成功安裝：
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
如需安裝錯誤的故障診斷步驟，請參閱故障診斷 AWS CLI 安裝和解除安裝錯誤一節。

步驟 1：設定所有要求

要從來源建置 AWS CLI，您需要事先完成以下內容：

注意

所有程式碼範例都是假設從來源目錄的根目錄執行。

延伸 AWS CLI GitHub 儲存庫或下載來源 tarball 來下載 AWS CLI 來源。說明如下：

從 GitHub 延伸和複製 AWS CLI 儲存庫。如需詳細資訊，請參閱 GitHub 文件中的《延伸儲存庫》。

在 https://awscli.amazonaws.com/awscli.tar.gz 下載最新來源 tarball，並使用下列命令擷取內容：


$ curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscli.tar.gz"
$ tar -xzf awscli.tar.gz

注意

要下載特定版本，請使用以下連結格式：https://awscli.amazonaws.com/awscli-versionnumber.tar.gz

例如，如需版本 2.10.0，則連結將如下：https://awscli.amazonaws.com/awscli-2.10.0.tar.gz

來源版本從 AWS CLI 的 2.10.0 版開始提供。

(可選) 完成下列步驟，驗證所下載 zip 檔案的完整性：

您可以依循下列步驟使用 GnuPG 工具來驗證簽章。

AWS CLI 安裝程式套件 .zip 檔案是使用 PGP 簽章進行密碼編譯方式簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。
使用您的套件管理工具下載並安裝 gpg 命令。如需有關 GnuPG 的詳細資訊，請參閱 GnuPG 網站。

若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。

以下公開金鑰詳細資訊僅供參考。


Key ID:           A6310ACC4672
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2026-07-07
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

使用以下命令導入 AWS CLI 公開金鑰，將 public-key-file-name 換為您建立的公開金鑰檔名。


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

針對您在 https://awscli.amazonaws.com/awscli.tar.gz.sig 下載的套件，下載 AWS CLI 簽章檔案。它會有與其對應的 tarball 檔案具有相同的路徑和名稱，但具有副檔名 .sig。將它儲存在與 tarball 檔案相同的路徑下。或使用下列命令區塊：
```
$ curl awscliv2.sig https://awscli.amazonaws.com/ -o awscli.tar.gz.sig
```

驗證簽章，並將下載的 .sig 和 .zip 檔案名稱以參數形式傳遞給 gpg 命令。


$ gpg --verify awscliv2.sig awscli.tar.gz

輸出應看起來如下列內容。


gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

重要

輸出中的警告是預期的，並不表示有問題。這是因為個人 PGP 金鑰 (如果有) 和 AWS CLI PGP 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「信任網路」。

顯示較多

顯示較少

您有一個環境可以執行 GNU 自動工具產生的檔案，例如 configure 和 Makefile。這些檔案在 POSIX 平台上廣泛可攜。
Linux and macOS

如果您的環境尚未安裝 Autotools，或者您需要更新它們，請遵循 GNU 文件中我如何安裝 Autotools (以使用者身分)？或基本安裝中的安裝說明。

Windows PowerShell
警告
如果您處於 Windows 環境中，建議您使用預先建置的安裝程式。如需預先建置安裝程式的安裝說明，請參閱安裝或更新至 AWS CLI 的最新版本

由於 Windows 不附帶符合 POSIX 的 Shell，因此您需要安裝其他軟體才能從來源安裝 AWS CLI。MSYS2 提供了一系列工具和程式庫來幫助建置和安裝 Windows 軟體，尤其是對於 Autotools 使用的 POSIX 架構指令碼。
安裝 MSYS2。如需有關安裝和使用 MSYS2 的資訊，請參閱 MSYS2 文件中的安裝和使用說明。

使用以下命令開啟 MSYS2 終端並安裝 Autotools。

$ pacman -S autotools
注意
使用本指南中適用於 Windows 的設定、建置和安裝程式碼範例時，會假設使用預設的 MSYS2 安裝路徑 C:\msys64\usr\bin\bash。在 PowerShell 中呼叫 MSYS2 時，您將使用以下格式，並使用引號中的 bash 命令：
PS C:\> C:\msys64\usr\bin\bash -lc "command example"
下列命令範例會呼叫 ./configure 命令。
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
已安裝 Python 3.8 或更新版本的解譯器。所需的最低 Python 版本遵循與官方 AWS SDK 和工具的 Python 支援政策相同的時程。解譯器僅支援到終止支援日期之後的 6 個月。
(選擇性) 安裝 AWS CLI 所有的建置和執行時間 Python 程式庫相依性。如果缺少任何相依性以及不知道如何安裝，./configure 命令能提供您資訊。

您可以透過配置自動安裝和使用這些相依性，請參閱下載相依性獲得更多資訊。

步驟 2：設定 AWS CLI 來源安裝

建置和安裝 AWS CLI 的組態使用 configure 指令碼指定。如需所有組態選項的文件，請使用 --help 選項執行 configure 指令碼：

最重要的選項如下：

安裝位置
Python 解譯器
下載相依性
安裝類型

安裝位置

AWS CLI 的來源安裝使用兩個可設定的目錄來安裝 AWS CLI：

libdir - 將安裝 AWS CLI 的父目錄。AWS CLI 安裝的路徑是 <libdir-value>/aws-cli。Linux 和 macOS 的預設 libdir 值是 /usr/local/lib，讓預設安裝目錄成為 /usr/local/lib/aws-cli
bindir - 安裝 AWS CLI 可執行檔的目錄。預設位置為 /usr/local/bin。

下列 configure 選項可控制使用的目錄：

--prefix - 設定用於安裝的目錄字首。Linux 和 macOS 的預設值為 /usr/local。
--libdir - 設定 libdir 用於安裝 AWS CLI。預設值為 <prefix-value>/lib。如果 --libdir 和 --prefix 兩者都未指定，Linux 和 macOS 的預設值為 /usr/local/lib/。
--bindir - 設定 bindir 用於安裝 AWS CLI、aws 和 aws_completer 可執行檔。預設值為 <prefix-value>/bin。如果 bindir 和 --prefix 兩者都未指定，Linux 和 macOS 的預設值為 /usr/local/bin/。

Python 解譯器

注意

強烈建議您在 Windows 安裝時，指定 Python 解譯器。

./configure 指令碼會自動選取已安裝的 Python 3.8 或更新版本的解譯器，以便使用 AM_PATH_PYTHON Autoconf 巨集建置和執行 AWS CLI。

執行 configure 指令碼時，可以使用 PYTHON 環境變數明確設定要使用的 Python 解釋器：

下載相依性

根據預設要求，系統必須已安裝 AWS CLI 的所有建置和執行時間相依性。這包括任何 Python 程式庫的相依性。configure 指令碼執行時會檢查所有相依性，如果系統缺少任何 Python 相依性，configure 指令碼會發生錯誤。

您的系統缺少相依性時，會顯示以下的代碼範例錯誤：

Linux and macOS


$ ./configure 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

Windows PowerShell


PS C:\> C:\msys64\usr\bin\bash -lc "./configure" 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

若要自動安裝所需的 Python 相依性，請使用 --with-download-deps 選項。使用此標記時，建置程序會執行下列動作：

跳過 Python 程式庫的相依性檢查。
配置設定以下載所有必要的 Python 相依性，並在 make 建置時僅使用下載的相依性來建置 AWS CLI。

下面的配置命令範例使用 --with-download-deps 選項下載和使用 Python 相依性：

安裝類型

來源安裝程序支援下列安裝類型：

system-sandbox - (預設值) 建立隔離的 Python 虛擬環境、將 AWS CLI 安裝到虛擬環境中，並在虛擬環境中建立 aws 與 aws_completer 可執行檔的 symlink。這個安裝的 AWS CLI 會直接相依於其執行時間所選取的 Python 解譯器。

這是一種輕量型安裝機制，可以在系統上安裝 AWS CLI，並在虛擬環境中進行沙盒安裝來遵循最佳 Python 實務。此安裝適用於希望從來源安裝 AWS CLI，以與安裝之 Python 相結合的最順暢方式安裝的客戶。
portable-exe - 凍結 AWS CLI 為獨立的可執行檔，該執行檔可分發至類似架構的環境。這與用於產生 AWS CLI 官方預先建置可執行檔的過程相同。portable-exe 凍結在 configure 步驟中選擇的 Python 解譯器副本，以用於 AWS CLI 的執行時間。這讓它可移動到可能沒有 Python 解譯器的其他機器。

這種類型的構建很有用，因為您可以確保您的 AWS CLI 安裝不會與環境安裝的 Python 版本耦合，並且可以將建構分發到可能尚未安裝 Python 的其他系統。這可讓您控制所使用之 AWS CLI 可執行檔的相依性和安全性。

若要設定安裝類型，請使用 --with-install-type 選項並指定 portable-exe 或 system-sandbox 的值。

以下 ./configure 命令範例會指定 portable-exe 的值：

步驟 3：建置 AWS CLI

使用 make 命令以使用您的配置設定來建置 AWS CLI：

注意

使用 `make` 指令時，會在幕後完成下列步驟：

虛擬環境使用 Python venv 模組在建置目錄中建立。虛擬環境使用 Python 標準庫中提供的 pip 版本啟動。
複製 Python 程式庫的相依性。根據是否在 configure 命令中指定 --with-download-deps 標記，此步驟會執行下列其中一項作業：
- 指定 --with-download-deps 。Python 的相依性使用 pip 安裝。這包括 wheel、setuptools 以及所有 AWS CLI 執行時間相依性。如果您在建置 portable-exe，則 pyinstaller 已安裝。這些要求都在從 pip-compile 中產生的鎖定檔案中指定。
- 未指定 --with-download-deps。Python 解譯器站點套件中的 Python 庫以及任何指令碼 (例如 pyinstaller) 都將複製到用於建置的虛擬環境中。
直接在 AWS CLI 程式碼庫上執行 pip install 以離線、in-tree 建置和安裝 AWS CLI 到建置虛擬環境中。此安裝使用 pip 標記 --no-build-isolation、--use-feature=in-tree-build、--no-cache-dir 和 --no-index。
(選擇性) 如果在 configure 命令中將 --install-type 設為 portable-exe，請使用 pyinstaller 建置獨立的可執行檔。

顯示較多

顯示較少

步驟 4：安裝 AWS CLI

make install 命令會將您的建置 AWS CLI 安裝到系統上配置的位置。

make install 規則支援 DESTDIR 變數。如果有指定，此變數會在安裝 AWS CLI 時，將指定路徑的加到已設定的安裝路徑前面。預設不會為此變數設定任何值。

注意

`make install` 執行時，會在幕後完成以下步驟

將下列其中一項移至已設定的安裝目錄：
- 如果安裝類型為 system-sandbox，移動您建置的虛擬環境。
- 如果安裝類型為 portable-exe，移動您建置的獨立可執行檔。
在配置的 bin 目錄中為 aws 和 aws_completer 可執行檔建立 symlink。

顯示較多

顯示較少

步驟 5：驗證 AWS CLI 安裝

使用以下命令，確認 AWS CLI 已成功安裝：


$ aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off

如果找不到 aws 命令，您可能需要重新啟動終端，才能更新為新的 symlink。如果在安裝或解除安裝 AWS CLI 時發生其他錯誤，請參閱故障診斷的錯誤 AWS CLI 以瞭解常見的故障診斷步驟。

工作流程範例

本節提供一些從來源安裝的基本工作流程範例。

基本 Linux 和 macOS 安裝

下列範例為基本安裝工作流程，AWS CLI 安裝在 /usr/local/lib/aws-cli 的預設位置。


$ cd path/to/cli/respository/
$ ./configure
$ make
$ make install

自動化 Windows 安裝

注意

您必須以系統管理員身分執行 PowerShell，才能使用此工作流程。

MSYS2 可以在 CI 設定中以自動方式使用，請參閱 MSYS2 文件的在 CI 使用 MSYS2。

Downloaded Tarball

下載 awscli.tar.gz 檔案、解壓縮，並安裝 AWS CLI。使用下列命令時，請取代下列路徑：

C:\msys64\usr\bin\bash 取代為您的 MSYS2 路徑的位置。
.\awscli-2.x.x\ 取代為解壓縮後的 awscli.tar.gz 資料夾名稱。
PYTHON='C:\path\to\python.exe' 取代為您的本機 Python 路徑。

下列程式碼範例會使用 MSYS2 自動從 PowerShell 建置和安裝 AWS CLI，並指定要使用的 Python 本機安裝：


PS C:\> curl "https://awscli.amazonaws.com/awscli.tar.gz" -o "awscliv2.zip"  #  Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz #  Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ #  Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 source-sandbox/AMD64

GitHub Repository

下載 awscli.tar.gz 檔案、解壓縮，並安裝 AWS CLI。使用下列命令時，請取代下列路徑：

C:\msys64\usr\bin\bash 取代為您的 MSYS2 路徑的位置。
C:path\to\cli\repository\ 取代為從 GitHub 到複製 AWS CLI 儲存庫的路徑。如需詳細資訊，請參閱 GitHub 文件中的《延伸儲存庫》
PYTHON='C:\path\to\python.exe' 取代為您的本機 Python 路徑。

下列程式碼範例會使用 MSYS2 自動從 PowerShell 建置和安裝 AWS CLI，並指定要使用的 Python 本機安裝：


PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version

Alpine Linux 容器

以下的範例 Dockerfile，可用於在 Alpine Linux 容器取得 AWS CLI 的可運作安裝，作為 Alpine 預先建置二進位檔的替代方案。使用此範例時，請以您想要的 AWS CLI 版本編號取代 AWSCLI_VERSION：


FROM python:3.8-alpine AS builder

ENV AWSCLI_VERSION=2.10.1

RUN apk add --no-cache \
    curl \
    make \
    cmake \
    gcc \
    g++ \
    libc-dev \
    libffi-dev \
    openssl-dev \
    && curl https://awscli.amazonaws.com/awscli-${AWSCLI_VERSION}.tar.gz | tar -xz \
    && cd awscli-${AWSCLI_VERSION} \
    && ./configure --prefix=/opt/aws-cli/ --with-download-deps \
    && make \
    && make install

FROM python:3.8-alpine

RUN apk --no-cache add groff

COPY --from=builder /opt/aws-cli/ /opt/aws-cli/

ENTRYPOINT ["/opt/aws-cli/bin/aws"]

建置此映像檔，並從類似於 Amazon Linux 2 上建置的容器由 AWS CLI 叫用：


$ docker build --tag awscli-alpine .
$ docker run --rm -it awscli-alpine --version
aws-cli/2.2.1 Python/3.8.11 Linux/5.10.25-linuxkit source-sandbox/x86_64.alpine.3 prompt/off

此映像檔的最終大小比官方 AWS CLI Docker 映像檔更小。如需 Docker 映像檔的相關資訊，請參閱執行 AWS CLI 的官方 Amazon ECR Public 或 Docker 映像檔。

故障診斷 AWS CLI 安裝和解除安裝錯誤

如需安裝錯誤的故障診斷步驟，請參閱故障診斷的錯誤 AWS CLI 了解常見的故障診斷步驟。如需最相關的故障診斷步驟，請參閱命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同和解除安裝後，「aws --version」命令會傳回版本 AWS CLI。

對於故障診斷指南未涵蓋的任何問題，請在 GitHub 上的 AWS CLI 儲存庫中搜尋含有 source-distribution 標籤的問題。如果沒有任何問題涵蓋您的錯誤，請建立新問題以獲得 AWS CLI 維護者的幫助。

後續步驟

安裝 AWS CLI 後，您應該執行設定 AWS CLI。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

過去版本

Amazon ECR Public/Docker

從來源建置和安裝 AWS CLI

重要

主題

為什麼要從來源建置？

快速步驟

注意

步驟 1：設定所有要求

注意

注意

重要

警告

注意

步驟 2：設定 AWS CLI 來源安裝

最重要的選項如下：

安裝位置

Python 解譯器

注意

下載相依性

安裝類型

步驟 3：建置 AWS CLI

注意

使用 make 指令時，會在幕後完成下列步驟：

步驟 4：安裝 AWS CLI

注意

make install 執行時，會在幕後完成以下步驟

步驟 5：驗證 AWS CLI 安裝

工作流程範例

基本 Linux 和 macOS 安裝

自動化 Windows 安裝

注意

Alpine Linux 容器

故障診斷 AWS CLI 安裝和解除安裝錯誤

後續步驟

使用 `make` 指令時，會在幕後完成下列步驟：

`make install` 執行時，會在幕後完成以下步驟