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

# 搭配 CodeArtifact 設定和使用 pip
<a name="python-configure-pip"></a>

[pip](https://pypi.org/project/pip/) 是 Python 套件的套件安裝程式。若要使用 pip 從 CodeArtifact 儲存庫安裝 Python 套件，您必須先使用 CodeArtifact 儲存庫資訊和登入資料來設定 pip 用戶端。

pip 只能用於安裝 Python 套件。若要發佈 Python 套件，您可以使用[雙工](https://pypi.org/project/twine/)。如需詳細資訊，請參閱[使用 CodeArtifact 設定和使用雙身](python-configure-twine.md)。

## 使用 `login`命令設定 pip
<a name="python-configure-pip-login"></a>

首先，設定您的 AWS 登入資料以與 搭配使用 AWS CLI，如中所述[CodeArtifact 入門](getting-started.md)。然後，使用 CodeArtifact `login`命令來擷取憑證並使用它們`pip`進行設定。

**注意**  
如果您在擁有的網域中存取儲存庫，則不需要包含 `--domain-owner`。如需詳細資訊，請參閱[跨帳戶網域](domain-overview.md#domain-overview-cross-account)。

若要設定 pip，請執行下列命令。

```
aws codeartifact login --tool pip --domain my_domain --domain-owner 111122223333 --repository my_repo
```

 `login` 使用您的 AWS 登入資料從 CodeArtifact 擷取授權字符。`login` 命令會編輯 `~/.config/pip/pip.conf`以`index-url`將 設定為 `--repository`選項指定的儲存庫，`pip`以將 設定為與 CodeArtifact 搭配使用。

呼叫 後的預設授權期間`login`為 12 小時，`login`必須呼叫 以定期重新整理字符。如需使用 `login`命令建立的授權字符的詳細資訊，請參閱 [使用 `login`命令建立的字符](tokens-authentication.md#auth-token-login)。

## 設定不含登入命令的 pip
<a name="python-configure-without-pip"></a>

 如果您無法使用 `login`命令來設定 `pip`，您可以使用 `pip config`。

1. 使用 AWS CLI 擷取新的授權字符。
**注意**  
如果您在擁有的網域中存取儲存庫，則不需要包含 `--domain-owner`。如需詳細資訊，請參閱[跨帳戶網域](domain-overview.md#domain-overview-cross-account)。

   ```
   CODEARTIFACT_AUTH_TOKEN=`aws codeartifact get-authorization-token --domain my_domain --domain-owner 111122223333 --query authorizationToken --output text`
   ```

1. 使用 `pip config` 設定 CodeArtifact 登錄 URL 和登入資料。下列命令只會更新目前的環境組態檔案。若要更新整個系統的組態檔案，請將 取代`site`為 `global`。

   ```
   pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/
   ```
**注意**  
若要使用雙堆疊端點，請使用 `codeartifact.region.on.aws`端點。

**重要**  
登錄 URL 必須以正斜線 (/) 結尾。否則，您無法連線到儲存庫。

**範例 pip 組態檔案**

以下是設定 CodeArtifact 登錄 URL 和登入資料後`pip.conf`的檔案範例。

```
[global]
index-url = https://aws:eyJ2ZX...@my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/pypi/my_repo/simple/
```

## 執行 pip
<a name="python-run-pip"></a>

若要執行`pip`命令，您必須`pip`使用 CodeArtifact 設定 。如需詳細資訊，請參閱下列文件。

1. 請依照 [使用 AWS CodeArtifact 設定](get-set-up-for-codeartifact.md)區段中的步驟來設定 AWS 您的帳戶、工具和許可。

1. `twine` 請依照中的步驟進行設定[使用 CodeArtifact 設定和使用雙身](python-configure-twine.md)。

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

```
pip install requests
```

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

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