Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 pip 和安裝 Python 套件
<a name="packages-python-pip"></a>

若要`pip`搭配 CodeCatalyst 使用 ，您必須`pip`連線至套件儲存庫，並提供個人存取字符以進行身分驗證。您可以在 CodeCatalyst 主控台中檢視`pip`連線至套件儲存庫的指示。驗證並`pip`連線至 CodeCatalyst 後，您可以執行`pip`命令。

**Contents**
+ [使用 pip 從 CodeCatalyst 安裝 Python 套件](#pip-install)
+ [透過 CodeCatalyst 從 PyPI 取用 Python 套件](#pip-install-pypi)
+ [pip 命令支援](#pip-command-support)
  + [支援與儲存庫互動的命令](#supported-pip-commands-that-interact-with-a-repository)
  + [支援的用戶端命令](#supported-pip-client-side-commands)

## 使用 pip 從 CodeCatalyst 安裝 Python 套件
<a name="pip-install"></a>

下列指示說明如何`pip`設定 從 CodeCatalyst 套件儲存庫或其中一個上游儲存庫安裝 Python 套件。

**設定和使用 從 CodeCatalyst 套件儲存庫`pip`安裝 Python 套件**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 在專案的概觀頁面上，選擇**套件**。

1. 從套件儲存庫清單中選擇套件儲存庫。

1. 選擇**連線至儲存庫**。

1. 在**連線至儲存庫**對話方塊中，從套件管理員用戶端清單中選擇 **pip**。

1. 您需要個人存取字符 (PAT) 來驗證 CodeCatalyst 的 pip。如果您已經有，則可以使用它。如果沒有，您可以在這裡建立一個。

   1. 選擇**建立權杖**。

   1. 選擇**複製**以複製您的 PAT。
**警告**  
關閉對話方塊後，您將無法再次查看或複製 PAT。

1. 使用 `pip config`命令來設定 CodeCatalyst 登錄 URL 和登入資料。取代下列值。
**注意**  
如果從主控台指示複製，則應為您更新下列值，且不應變更。
   + 將*使用者名稱*取代為您的 CodeCatalyst 使用者名稱。
   + 將 *PAT* 取代為您的 CodeCatalyst PAT。
   + 將 *space\$1name* 取代為您的 CodeCatalyst 空間名稱。
   + 將 *proj\$1name* 取代為您的 CodeCatalyst 專案名稱。
   + 將 *repo\$1name* 取代為您的 CodeCatalyst 套件儲存庫名稱。

   ```
   pip config set global.index-url https://username:PAT@https://packages.region.codecatalyst.aws/pypi/space_name/proj_name/repo_name/simple/
   ```

1. 假設您的儲存庫或其中一個上游儲存庫中有套件，您可以使用 安裝套件`pip install`。例如，使用下列命令來安裝 `requests`套件。

   ```
   pip install requests
   ```

   使用 `-i`選項暫時還原為從 [https://pypi.org](https://pypi.org) 安裝套件，而非 CodeCatalyst 套件儲存庫。

   ```
   pip install -i https://pypi.org/simple requests
   ```

## 透過 CodeCatalyst 從 PyPI 取用 Python 套件
<a name="pip-install-pypi"></a>

您可以透過 CodeCatalyst 儲存庫從 Python [套件索引 (PyPI)](https://www.pypi.org/) 使用 Python 套件，方法是使用上游連線至 **PyPI** 的儲存庫。從 **PyPI** 取用的套件會擷取並儲存在 CodeCatalyst 儲存庫中。

**從 PyPI 取用套件**

1. 如果您尚未設定，請依照中的步驟，使用 CodeCatalyst 套件儲存庫設定 pip[使用 pip 從 CodeCatalyst 安裝 Python 套件](#pip-install)。

1. 請確定您的儲存庫已新增 **PyPI** 做為上游來源。您可以依照 中的指示[新增上游儲存庫](packages-upstream-repositories-add.md)並選擇 **PyPI** **儲存庫，來檢查要新增哪些上游來源，或新增 PyPI ** 做為上游來源。

如需從上游儲存庫請求套件的詳細資訊，請參閱 [使用上游儲存庫請求套件版本](packages-upstream-repositories-request.md)。

## pip 命令支援
<a name="pip-command-support"></a>

下列各節摘要說明 CodeCatalyst 儲存庫支援的 pip 命令，以及不支援的特定命令。

**Topics**
+ [支援與儲存庫互動的命令](#supported-pip-commands-that-interact-with-a-repository)
+ [支援的用戶端命令](#supported-pip-client-side-commands)

### 支援與儲存庫互動的命令
<a name="supported-pip-commands-that-interact-with-a-repository"></a>

本節列出 `pip` 命令，其中`pip`用戶端會對其設定的登錄提出一或多個請求。已驗證這些命令在針對 CodeCatalyst 套件儲存庫調用時可正常運作。


****  

| 命令 | Description | 
| --- | --- | 
|   [安裝](https://pip.pypa.io/en/stable/reference/pip_install/)   |  安裝套件。  | 
|   [下載](https://pip.pypa.io/en/stable/reference/pip_download/)   |  下載套件。  | 

CodeCatalyst 不會實作 `pip search`。如果您已`pip`設定 CodeCatalyst 套件儲存庫，執行 `pip search`會搜尋並顯示來自 [PyPI](https://pypi.org/) 的套件。

### 支援的用戶端命令
<a name="supported-pip-client-side-commands"></a>

這些命令不需要與儲存庫進行任何直接互動，因此 CodeCatalyst 不需要執行任何動作來支援儲存庫。


****  

| 命令 | Description | 
| --- | --- | 
|   [解除安裝](https://pip.pypa.io/en/stable/reference/pip_uninstall/)   |  解除安裝套件。  | 
|   [凍結](https://pip.pypa.io/en/stable/reference/pip_freeze/)   |  以要求格式輸出已安裝的套件。  | 
|   [清單](https://pip.pypa.io/en/stable/reference/pip_list/)   |  列出已安裝的套件。  | 
|   [sh](https://pip.pypa.io/en/stable/reference/pip_show/)ow   |  顯示已安裝套件的相關資訊。  | 
|   [檢查](https://pip.pypa.io/en/stable/reference/pip_check/)   |  確認已安裝的套件具有相容的相依性。  | 
|   [組態](https://pip.pypa.io/en/stable/reference/pip_config/)   |  管理本機和全域組態。  | 
|   [滾輪](https://pip.pypa.io/en/stable/reference/pip_wheel/)   |  根據您的需求建置車輪。  | 
|   [雜湊](https://pip.pypa.io/en/stable/reference/pip_hash/)   |  套件封存的運算雜湊。  | 
|   [完成](https://pip.pypa.io/en/stable/user_guide/#command-completion)   |  協助完成命令。  | 
|   [debug](https://pip.pypa.io/en/stable/reference/pip_debug/)   |  顯示適用於偵錯的資訊。  | 
|  說明  |  顯示 命令的說明。  |