Configura e usa pip conCodeArtifact

pipè l'installatore di pacchetti per i pacchetti Python. Per usare pip per installare pacchetti Python dal tuoCodeArtifactrepository, devi prima configurare il client pip con il tuoCodeArtifactinformazioni e credenziali del repository.

pip può essere usato solo per installare pacchetti Python. Per pubblicare pacchetti Python, puoi usarespago. Per ulteriori informazioni, consulta Configura e usa twine conCodeArtifact.

Configura pip conlogincomando

Innanzitutto, configura il tuoAWScredenziali da utilizzare conAWS CLI, come descritto inNozioni di base su CodeArtifact. Quindi, usa ilCodeArtifact logincomando per recuperare le credenziali e configurarepipcon loro.

Nota

Se accedi a un repository in un dominio di tua proprietà, non è necessario includerlo--domain-owner. Per ulteriori informazioni, consulta Domini con più account.

Per configurare pip, esegui il seguente comando.

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

loginrecupera un token di autorizzazione daCodeArtifactusando il tuoAWScredenziali. Leloginil comando configureràpipda usare conCodeArtifactmodificando~/.config/pip/pip.confper impostare ilindex-urlal repository specificato da--repositoryopzione.

Il periodo di autorizzazione predefinito dopo la chiamataloginè di 12 ore elogindeve essere chiamato per aggiornare periodicamente il token. Per ulteriori informazioni sul token di autorizzazione creato conlogincomando, vedereToken creati con il comando login.

Configura pip senza il comando di login

Se non è possibile utilizzare illogincomando da configurarepip, puoi usarepip config.

1. Usa ilAWS CLIper recuperare un nuovo token di autorizzazione.

   Nota

   Se si accede a un repository in un dominio di propria proprietà, non è necessario includere--domain-owner. Per ulteriori informazioni, consulta Domini con più account.

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

2. Usarepip configper impostare ilCodeArtifactURL e credenziali del registro. Il comando seguente aggiornerà solo il file di configurazione dell'ambiente corrente. Per aggiornare il file di configurazione a livello di sistema, sostituiscisiteconglobal.

   pip config set site.index-url https://aws:$CODEARTIFACT_AUTH_TOKEN@my_domain-111122223333.d.codeartifact.region.amazonaws.com/pypi/my_repo/simple/

Importante

L'URL del registro deve terminare con una barra (/). In caso contrario, non è possibile connettersi al repository.

Esempio di file di configurazione pip

Di seguito è riportato un esempio dipip.conffile dopo aver impostato ilCodeArtifactURL e credenziali del registro.

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

Esegui pip

Correrepipcomandi, è necessario configurarepipconCodeArtifact. Per ulteriori informazioni, consulta la seguente documentazione:

1. Segui i passaggi indicati nelConfigurazione con AWS CodeArtifactsezione per configurare il tuoAWSaccount, strumenti e autorizzazioni.

2. Configuraretwineseguendo la procedura descritta inConfigura e usa twine conCodeArtifact.

Supponendo che un pacchetto sia presente nel tuo repository o in uno dei suoi repository originali, puoi installarlo conpip install. Ad esempio, utilizzare il comando seguente per installare ilrequestspacchetto.

pip install requests

Usa il-iopzione per tornare temporaneamente all'installazione dei pacchetti dahttps://pypi.orginvece del tuoCodeArtifactdeposito.

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