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à.
# Guida introduttiva con CodeArtifact
In questo tutorial introduttivo, creerai quanto segue: CodeArtifact
+ Un dominio chiamato`my-domain`.
+ Un repository chiamato `my-repo` così è contenuto in`my-domain`.
+ Un repository chiamato `npm-store` così è contenuto in. `my-domain` `npm-store`Ha una connessione esterna al repository pubblico di npm. Questa connessione viene utilizzata per inserire un pacchetto npm nel repository. `my-repo`
Prima di iniziare questo tutorial, ti consigliamo di esaminarlo. CodeArtifact [AWS CodeArtifact concetti](codeartifact-concepts.md)
**Nota**
Questo tutorial richiede la creazione di risorse che potrebbero comportare addebiti sull’account AWS . Per ulteriori informazioni, consulta [Prezzi di CodeArtifact ](https://aws.amazon.com/codeartifact/pricing/).
**Topics**
+ [Prerequisiti](#getting-started-prerequisites)
+ [Nozioni di base utilizzando la console](getting-started-console.md)
+ [Iniziare a usare il AWS CLI](getting-started-cli.md)
## Prerequisiti
Puoi completare questo tutorial usando il Console di gestione AWS o il AWS Command Line Interface (AWS CLI). Per seguire il tutorial, devi prima completare i seguenti prerequisiti:
+ Completa le fasi descritte in [Configurazione con AWS CodeArtifact](get-set-up-for-codeartifact.md).
+ Installa la CLI di npm. Per ulteriori informazioni, vedere [Download e installazione di Node.js e npm nella documentazione di npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
# Nozioni di base utilizzando la console
Esegui i passaggi seguenti per iniziare a CodeArtifact utilizzare. Console di gestione AWS Questa guida utilizza il gestore di `npm` pacchetti, se utilizzi un gestore di pacchetti diverso, dovrai modificare alcuni dei seguenti passaggi.
1. Accedi Console di gestione AWS e apri la AWS CodeArtifact console su [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start). Per ulteriori informazioni, consulta [Configurazione con AWS CodeArtifact](get-set-up-for-codeartifact.md).
1. Scegli **Create repository (Crea repository)**.
1. **Nel nome del repository, inserisci.** **my-repo**
1. (Facoltativo) In **Descrizione del repository**, inserite una descrizione facoltativa per il repository.
1. **Nei **repository upstream pubblici, seleziona npm-store per creare un repository** **connesso a npmjs** che sia a monte del tuo repository.** `my-repo`
CodeArtifact `npm-store`assegna il nome a questo repository per te. Tutti i pacchetti disponibili nel repository upstream `npm-store` sono disponibili anche nel repository downstream,. `my-repo`
1. Scegli **Next (Successivo)**.
1. In **Account AWS**, scegli **Questo account AWS**.
1. In **Nome di dominio**, inserisci**my-domain**.
1. Espandere **Additional configuration (Configurazione aggiuntiva)**.
1. È necessario utilizzare una AWS KMS key (chiave KMS) per crittografare tutte le risorse del dominio. Puoi utilizzare una Chiave gestita da AWS o una chiave KMS che gestisci:
+ Scegli la **chiave gestita AWS** se desideri utilizzare la chiave predefinita Chiave gestita da AWS.
+ Scegli la **chiave gestita dal cliente** se desideri utilizzare una chiave KMS da te gestita. Per utilizzare una chiave KMS che gestisci, in **ARN della chiave gestita dal cliente**, cerca e scegli la chiave KMS.
*Per ulteriori informazioni, consulta la sezione [Chiave gestita da AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)[Customer managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) nella Developer Guide.AWS Key Management Service *
1. Scegli **Next (Successivo)**.
1. In **Rivedi e crea**, esamina ciò CodeArtifact che stai creando per te.
+ **Il Package Flow** mostra come `my-domain``my-repo`, e `npm-store` sono correlati.
+ **Passaggio 1: Crea un repository** mostra i dettagli su `my-repo` e`npm-store`.
+ **Passaggio 2: Seleziona il dominio** che mostra i dettagli su`my-domain`.
Quando sei pronto, scegli **Crea repository.**
1. **Nella pagina **my-repo**, scegli **Visualizza istruzioni di connessione**, quindi scegli npm.**
1. Usa AWS CLI per eseguire il `login` comando mostrato in **Configura il tuo client npm** usando questo comando. AWS CLI CodeArtifact
```
aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333
```
Dovresti ricevere un output di conferma che il tuo accesso è riuscito.
```
Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
Login expires in 12 hours at 2020-10-08 02:45:33-04:00
```
Se ricevi l'errore`Could not connect to the endpoint URL`, assicurati che AWS CLI sia configurato e che il **nome della regione predefinito** sia impostato sulla stessa regione in cui hai creato il repository, vedi [Configurazione dell'interfaccia a riga di comando AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).
Per ulteriori informazioni, consulta [Configura e usa npm con CodeArtifact](npm-auth.md)
1. Usa la CLI npm per installare un pacchetto npm. Ad esempio, per installare il popolare pacchetto npm`lodash`, usa il seguente comando.
```
npm install lodash
```
1. Ritorna alla CodeArtifact console. Se il tuo repository **my-repo** è aperto, aggiorna la pagina. **Altrimenti, nel pannello di navigazione, scegli **Repositories**, quindi scegli my-repo.**
In **Pacchetti**, dovresti vedere la libreria o il pacchetto npm che hai installato. Puoi scegliere il nome del pacchetto per visualizzarne la versione e lo stato. Puoi scegliere la versione più recente per visualizzare i dettagli del pacchetto come dipendenze, risorse e altro.
**Nota**
Potrebbe esserci un ritardo tra il momento in cui installi il pacchetto e il momento in cui viene inserito nel tuo repository.
1. Per evitare ulteriori AWS addebiti, elimina le risorse che hai utilizzato durante questo tutorial:
**Nota**
Non è possibile eliminare un dominio che contiene repository, quindi è necessario eliminare `my-repo` e `npm-store` prima di eliminare`my-domain`.
1. Dal riquadro di navigazione, scegli **Repository**.
1. Scegli **npm-store**, scegli **Elimina**, quindi segui i passaggi per eliminare il repository.
1. Scegli **my-repo**, scegli **Elimina, quindi segui i passaggi per eliminare** il repository.
1. **Dal pannello di navigazione, scegli Domini.**
1. Scegli il **mio dominio**, scegli **Elimina**, quindi segui i passaggi per eliminare il dominio.
# Iniziare a usare il AWS CLI
Esegui i passaggi seguenti per iniziare a CodeArtifact utilizzare AWS Command Line Interface (AWS CLI). Per ulteriori informazioni, consulta [Installa o aggiorna e quindi configura il AWS CLI](get-set-up-install-cli.md). Questa guida utilizza il gestore di `npm` pacchetti, se utilizzi un gestore di pacchetti diverso, dovrai modificare alcuni dei seguenti passaggi.
1. Usa il AWS CLI per eseguire il **create-domain** comando.
```
aws codeartifact create-domain --domain my-domain
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo dominio.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Active",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```
Se ricevi l'errore`Could not connect to the endpoint URL`, assicurati che AWS CLI sia configurato e che il **nome della regione predefinito** sia impostato sulla stessa regione in cui hai creato il repository, vedi [Configurazione dell'interfaccia a riga di comando AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).
1. Usa il **create-repository** comando per creare un repository nel tuo dominio.
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo repository.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [],
"externalConnections": []
}
}
```
1. Usa il **create-repository** comando per creare un repository upstream per il tuo repository. `my-repo`
```
aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo repository.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": []
}
}
```
1. Usa il **associate-external-connection** comando per aggiungere una connessione esterna al repository pubblico npm al tuo repository. `npm-store`
```
aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul repository e sulla sua nuova connessione esterna.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
Per ulteriori informazioni, consulta [Connect un CodeArtifact repository a un repository pubblico](external-connection.md).
1. Utilizzate il **update-repository** comando per associare il `npm-store` repository come repository upstream al repository. `my-repo`
```
aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul repository aggiornato, incluso il nuovo repository upstream.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
Per ulteriori informazioni, consulta [Aggiungi o rimuovi i repository upstream ()AWS CLI](repo-upstream-add.md#repo-upstream-add-cli).
1. Usa il **login** comando per configurare il tuo gestore di pacchetti npm con il tuo repository. `my-repo`
```
aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333
```
Dovresti ricevere un output che conferma che il tuo accesso è riuscito.
```
Successfully configured npm to use AWS CodeArtifact repository https://my-domain-111122223333.d.codeartifact.us-east-2.amazonaws.com/npm/my-repo/
Login expires in 12 hours at 2020-10-08 02:45:33-04:00
```
Per ulteriori informazioni, consulta [Configura e usa npm con CodeArtifact](npm-auth.md).
1. Usa la CLI npm per installare un pacchetto npm. Ad esempio, per installare il popolare pacchetto npm`lodash`, usa il seguente comando.
```
npm install lodash
```
1. Usa il **list-packages** comando per visualizzare il pacchetto che hai appena installato nel tuo `my-repo` repository.
**Nota**
Potrebbe verificarsi un ritardo tra il completamento del comando di `npm install` installazione e il momento in cui il pacchetto è visibile nel repository. Per i dettagli sulla latenza tipica durante il recupero di pacchetti da archivi pubblici, consulta. [Latenza della connessione esterna](external-connection-requesting-packages.md#external-connection-latency)
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
I dati in formato JSON vengono visualizzati nell'output con il formato e il nome del pacchetto installato.
```
{
"packages": [
{
"format": "npm",
"package": "lodash"
}
]
}
```
Ora hai tre risorse: CodeArtifact
+ Il dominio`my-domain`.
+ Il repository `my-repo` contenuto in`my-domain`. Questo repository ha a disposizione un pacchetto npm.
+ Il repository in `npm-store` cui è contenuto. `my-domain` Questo repository ha una connessione esterna al repository pubblico npm ed è associato come repository upstream al repository. `my-repo`
1. Per evitare ulteriori AWS addebiti, elimina le risorse che hai utilizzato durante questo tutorial:
**Nota**
Non è possibile eliminare un dominio che contiene repository, quindi è necessario eliminare `my-repo` e `npm-store` prima di eliminare`my-domain`.
1. Usa il **delete-repository** comando per eliminare il `npm-store` repository.
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sull'archivio eliminato.
```
{
"repository": {
"name": "my-repo",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/my-repo",
"upstreams": [
{
"repositoryName": "npm-store"
}
],
"externalConnections": []
}
}
```
1. Usa il **delete-repository** comando per eliminare il repository. `npm-store`
```
aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sull'archivio eliminato.
```
{
"repository": {
"name": "npm-store",
"administratorAccount": "111122223333",
"domainName": "my-domain",
"domainOwner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
"upstreams": [],
"externalConnections": [
{
"externalConnectionName": "public:npmjs",
"packageFormat": "npm",
"status": "AVAILABLE"
}
]
}
}
```
1. Usa il **delete-domain** comando per eliminare il repository. `my-domain`
```
aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333
```
I dati in formato JSON vengono visualizzati nell'output con i dettagli sul dominio eliminato.
```
{
"domain": {
"name": "my-domain",
"owner": "111122223333",
"arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/my-domain",
"status": "Deleted",
"createdTime": "2020-10-07T15:36:35.194000-04:00",
"encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/your-kms-key",
"repositoryCount": 0,
"assetSizeBytes": 0
}
}
```