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à.

# Iniziare a usare il AWS CLI
<a name="getting-started-cli"></a>

 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
          }
      }
      ```