Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Puoi usare Cargo per pubblicare e scaricare casse dai CodeArtifact repository o per recuperare casse da crates.io
Configura Cargo con CodeArtifact
Per utilizzare Cargo da cui installare e pubblicare casse AWS CodeArtifact, devi prima configurarle con le informazioni del tuo CodeArtifact repository. Segui i passaggi di una delle seguenti procedure per configurare Cargo con le informazioni e le credenziali dell'endpoint CodeArtifact del repository.
Configura Cargo utilizzando le istruzioni della console
Puoi utilizzare le istruzioni di configurazione nella console per connettere Cargo al tuo CodeArtifact repository. Le istruzioni della console forniscono una configurazione Cargo personalizzata per il tuo CodeArtifact repository. Puoi utilizzare questa configurazione personalizzata per configurare Cargo senza dover trovare e inserire le tue CodeArtifact informazioni.
-
Apri la AWS CodeArtifact console su https://console.aws.amazon.com/codesuite/codeartifact/home
. -
Nel pannello di navigazione, scegli Repository, quindi scegli un repository per connetterti a Cargo.
-
Scegli Visualizza le istruzioni di connessione.
-
Scegli il tuo sistema operativo.
-
Scegli Cargo.
-
Segui le istruzioni generate per connettere Cargo al tuo CodeArtifact repository.
Configura Cargo manualmente
Se non puoi o non vuoi usare le istruzioni di configurazione della console, puoi utilizzare le seguenti istruzioni per connettere Cargo al tuo CodeArtifact repository manualmente.
Per configurare Cargo con CodeArtifact, devi definire il tuo CodeArtifact repository come registro nella configurazione Cargo e fornire le credenziali.
Replace (Sostituisci)
my_registry
con il nome del tuo registro.Replace (Sostituisci)
my_domain
con il tuo nome di CodeArtifact dominio.Replace (Sostituisci)
111122223333
con l'ID dell' AWS account del proprietario del dominio. Se accedi a un repository in un dominio di tua proprietà, non è necessario--domain-owner
includerlo. Per ulteriori informazioni, consulta Domini con più account.Replace (Sostituisci)
my_repo
con il nome del tuo CodeArtifact repository.
Copia la configurazione per pubblicare e scaricare i pacchetti Cargo nel tuo repository e salvala nel ~/.cargo/config.toml
file per una configurazione a livello di sistema o .cargo/config.toml
per una configurazione a livello di progetto:
[registries.
my_registry
] index = "sparse+https://my_domain
-111122223333
.d.codeartifact.us-west-2
.amazonaws.com/cargo/my_repo
/" credential-provider = "cargo:token-from-stdout aws codeartifact get-authorization-token --domainmy_domain
--domain-owner111122223333
--regionus-west-2
--query authorizationToken --output text" [registry] default = "my_registry
" [source.crates-io] replace-with = "my_registry
"
La [registries.
sezione dell'esempio precedente definisce un registro con my_registry
]my_registry
index
e fornisce credential-provider
informazioni.
-
index
specifica l'indice URL del registro, che è l'endpoint del CodeArtifact repository che termina con un./
Ilsparse+
prefisso è obbligatorio per i registri che non sono repository Git.Nota
Per utilizzare un endpoint dualstack, usa l'endpoint.
codeartifact.
region
.on.aws -
credential-provider
specifica il fornitore di credenziali per il registro specificato. Secredential-provider
non è impostato,registry.global-credential-providers
verranno utilizzati i provider inclusi. Se impostatacredential-provider
sucargo:token-from-stdout
, il client Cargo recupererà automaticamente il nuovo token di autorizzazione durante la pubblicazione o il download dal CodeArtifact repository, pertanto non è necessario aggiornare manualmente il token di autorizzazione ogni 12 ore.
La [registry]
sezione definisce il registro predefinito utilizzato.
-
default
specifica il nome del registro definito in[registries.
, da utilizzare per impostazione predefinita durante la pubblicazione o il download dal CodeArtifact repository.my_registry
]
La [source.crates-io]
sezione definisce il registro predefinito utilizzato quando non ne viene specificato uno.
-
replace-with = "
sostituisce il registro pubblico, crates.io con il CodeArtifact repository definito in.my_registry
"[registries.
Questa configurazione è consigliata se è necessario richiedere pacchetti dalla connessione esterna come crates.io.my_registry
]Per ottenere tutti i vantaggi di CodeArtifact, come il controllo dell'origine dei pacchetti che previene gli attacchi legati alla confusione delle dipendenze, si consiglia di utilizzare la sostituzione del codice sorgente. Con la sostituzione dei sorgenti, invia tramite CodeArtifact proxy tutte le richieste alla connessione esterna e copia il pacchetto dalla connessione esterna al tuo repository. Senza la sostituzione del codice sorgente, il client Cargo recupererà direttamente il pacchetto in base alla configurazione nel
Cargo.toml
file del progetto. Se una dipendenza non è contrassegnata conregistry=
, il client Cargo la recupererà direttamente da crates.io senza comunicare con il vostro repository. CodeArtifactmy_registry
Nota
Se inizi a utilizzare la sostituzione del codice sorgente e poi aggiorni il file di configurazione per non utilizzare la sostituzione del codice sorgente, potresti riscontrare degli errori. Anche lo scenario opposto può causare errori. Pertanto, si consiglia di evitare di modificare la configurazione del progetto.
Installazione delle casse Cargo
Installa le casse Cargo da CodeArtifact
Puoi usare Cargo (cargo
) CLI per installare rapidamente una versione specifica di una cassa Cargo dal tuo CodeArtifact repository.
Per installare le casse Cargo da un repository con CodeArtifact cargo
In caso contrario, segui i passaggi indicati Configura e usa Cargo con CodeArtifact per configurare l'utilizzo del
cargo
CLI CodeArtifact repository con le credenziali appropriate.-
Usa il seguente comando per installare Cargo crates da: CodeArtifact
cargo add my_cargo_package@
1.0.0
Per ulteriori informazioni, consulta cargo add
in The Cargo Book.
Publishing Cargo crates su CodeArtifact
Utilizzare la procedura seguente per pubblicare le casse Cargo in un CodeArtifact repository utilizzando. cargo
CLI
In caso contrario, segui i passaggi indicati Configura e usa Cargo con CodeArtifact per configurare l'utilizzo del
cargo
CLI CodeArtifact repository con le credenziali appropriate.-
Usa il seguente comando per pubblicare le casse Cargo in un repository: CodeArtifact
cargo publish
Per ulteriori informazioni, vedete cargo publish
in The Cargo Book.