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\_name}} 取代為您的 CodeCatalyst 空間名稱。
   + 將 {{proj\_name}} 取代為您的 CodeCatalyst 專案名稱。
   + 將 {{repo\_name}} 取代為您的 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/)  | 顯示適用於偵錯的資訊。 | 
| 說明 | 顯示 命令的說明。 |