亚马逊 CodeCatalyst 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置 pip 并安装 Python 程序包
<a name="packages-python-pip"></a>

要`pip`与一起使用 CodeCatalyst，您必须`pip`连接到您的包存储库并提供用于身份验证的个人访问令牌。您可以在 CodeCatalyst 控制台中查看`pip`连接到软件包存储库的说明。在您进行身份验证并`pip`连接到后 CodeCatalyst，您可以运行`pip`命令。

**Contents**
+ [使用 pip 安装 Python 包 CodeCatalyst](#pip-install)
+ [通过 PyPI 消费 Python 包 CodeCatalyst](#pip-install-pypi)
+ [pip 命令支持](#pip-command-support)
  + [与存储库进行交互的受支持命令](#supported-pip-commands-that-interact-with-a-repository)
  + [支持的客户端命令](#supported-pip-client-side-commands)

## 使用 pip 安装 Python 包 CodeCatalyst
<a name="pip-install"></a>

以下说明说明`pip`如何配置为从您的 CodeCatalyst 包存储库或其上游存储库之一安装 Python 包。

**配置并使用 `pip 从包`存储库中安装 Python CodeCatalyst 包**

1. 在处打开 CodeCatalyst 控制台[https://codecatalyst.aws/](https://codecatalyst.aws/)。

1. 在项目的概述页面上，选择**程序包**。

1. 从程序包存储库列表中，选择您的程序包存储库。

1. 选择**连接到存储库**。

1. 在**连接到存储库**对话框中，从程序包管理器客户端列表中选择 **pip**。

1. 您将需要个人访问令牌 (PAT) 来对 pip 进行 CodeCatalyst身份验证。如果您已有一个 PAT，则可以使用它。如果没有 PAT，您可以在此处创建一个。

   1. 选择**创建令牌**。

   1. 选择**复制**以复制您的 PAT。
**警告**  
关闭此对话框后，您将无法再次查看或复制您的 PAT。

1. 使用`pip config`命令设置 CodeCatalyst 注册表 URL 和证书。替换以下值。
**注意**  
如果通过控制台指令进行复制，则以下值将进行更新且不应更改。
   + {{username}}替换为您的 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
   ```

## 通过 PyPI 消费 Python 包 CodeCatalyst
<a name="pip-install-pypi"></a>

您可以[通过 CodeCatalyst 存储库使用与 PyPI 的上游连接来使用 Py ](https://www.pypi.org/) thon 包索引 (PyPI) 中的 ** Py ** thon 包。从 ** PyPI 消耗的包**会被摄取并存储在您的 CodeCatalyst 存储库中。

**使用来自 PyPI 的程序包**

1. 如果您尚未配置 pip，请按照中的[使用 pip 安装 Python 包 CodeCatalyst](#pip-install)步骤使用您的 CodeCatalyst 软件包存储库配置 pip。

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 软件包存储库调用时可以正常运行。



| 命令 | 说明 | 
| --- | --- | 
|  [install](https://pip.pypa.io/en/stable/reference/pip_install/)  | 安装程序包。 | 
|  [download](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 不需要做任何事情来支持它们。



| 命令 | 说明 | 
| --- | --- | 
|  [uninstall](https://pip.pypa.io/en/stable/reference/pip_uninstall/)  | 卸载程序包。 | 
|  [freeze](https://pip.pypa.io/en/stable/reference/pip_freeze/)  | 按要求格式输出已安装的程序包。 | 
|  [list](https://pip.pypa.io/en/stable/reference/pip_list/)  | 列出已安装程序包。 | 
|  [show](https://pip.pypa.io/en/stable/reference/pip_show/)  | 显示有关已安装程序包的信息。 | 
|  [check](https://pip.pypa.io/en/stable/reference/pip_check/)  | 验证已安装的程序包是否具有兼容的依赖项。 | 
|  [config](https://pip.pypa.io/en/stable/reference/pip_config/)  | 管理本地和全局配置。 | 
|  [wheel](https://pip.pypa.io/en/stable/reference/pip_wheel/)  | 根据您的要求构建 wheel。 | 
|  [hash](https://pip.pypa.io/en/stable/reference/pip_hash/)  | 计算程序包存档的哈希值。 | 
|  [completion](https://pip.pypa.io/en/stable/user_guide/#command-completion)  | 协助完成命令。 | 
|  [debug](https://pip.pypa.io/en/stable/reference/pip_debug/)  | 显示对调试有用的信息。 | 
| help | 显示命令的帮助。 |