

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte mit dem AWS CLI
<a name="getting-started-cli"></a>

 Führen Sie die folgenden Schritte aus, um mit der CodeArtifact Verwendung von AWS Command Line Interface (AWS CLI) zu beginnen. Weitere Informationen finden Sie unter [Installieren oder aktualisieren Sie und konfigurieren Sie dann das AWS CLI](get-set-up-install-cli.md). In diesem Handbuch wird der `npm` Paketmanager verwendet. Wenn Sie einen anderen Paketmanager verwenden, müssen Sie einige der folgenden Schritte ändern.

1.  Verwenden Sie den AWS CLI , um den **create-domain** Befehl auszuführen. 

   ```
   aws codeartifact create-domain --domain my-domain
   ```

    In der Ausgabe werden Daten im JSON-Format mit Details zu Ihrer neuen Domain angezeigt. 

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

   Wenn Sie den Fehler erhalten`Could not connect to the endpoint URL`, stellen Sie sicher, dass Ihre konfiguriert AWS CLI ist und dass Ihr **Standardregionsname auf dieselbe Region** gesetzt ist, in der Sie Ihr Repository erstellt haben. Weitere Informationen finden Sie unter [Konfiguration der AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

1.  Verwenden Sie den **create-repository** Befehl, um ein Repository in Ihrer Domain zu erstellen.

   ```
   aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
   ```

    In der Ausgabe werden Daten im JSON-Format mit Details zu Ihrem neuen Repository angezeigt. 

   ```
   {
       "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. Verwenden Sie den **create-repository** Befehl, um ein Upstream-Repository für Ihr Repository zu erstellen. `my-repo`

   ```
   aws codeartifact create-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
   ```

    In der Ausgabe werden Daten im JSON-Format mit Details zu Ihrem neuen Repository angezeigt.

   ```
   {
       "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.  Verwenden Sie den **associate-external-connection** Befehl, um Ihrem Repository eine externe Verbindung zum öffentlichen NPM-Repository hinzuzufügen. `npm-store` 

   ```
   aws codeartifact associate-external-connection --domain my-domain --domain-owner 111122223333 --repository npm-store --external-connection "public:npmjs"
   ```

    In der Ausgabe werden Daten im JSON-Format mit Details zum Repository und seiner neuen externen Verbindung angezeigt.

   ```
   {
       "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"
               }
           ]
       }
   }
   ```

    Weitere Informationen finden Sie unter [Ein CodeArtifact Repository mit einem öffentlichen Repository Connect](external-connection.md). 

1.  Verwenden Sie den **update-repository** Befehl, um das `npm-store` Repository dem Repository als Upstream-Repository zuzuordnen. `my-repo` 

   ```
   aws codeartifact update-repository --repository my-repo --domain my-domain --domain-owner 111122223333 --upstreams repositoryName=npm-store
   ```

    In der Ausgabe werden Daten im JSON-Format mit Details zu Ihrem aktualisierten Repository angezeigt, einschließlich des neuen Upstream-Repositorys.

   ```
   {
       "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": []
       }
   }
   ```

    Weitere Informationen finden Sie unter [Fügen Sie Upstream-Repositorys hinzu oder entfernen Sie sie ()AWS CLI](repo-upstream-add.md#repo-upstream-add-cli). 

1. Verwenden Sie den **login** Befehl, um Ihren npm-Paketmanager mit Ihrem Repository zu konfigurieren. `my-repo` 

   ```
   aws codeartifact login --tool npm --repository my-repo --domain my-domain --domain-owner 111122223333
   ```

   Sie sollten eine Ausgabe erhalten, die bestätigt, dass Ihre Anmeldung erfolgreich war.

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

    Weitere Informationen finden Sie unter [Konfigurieren und verwenden Sie npm mit CodeArtifact](npm-auth.md). 

1.  Verwenden Sie die npm-CLI, um ein npm-Paket zu installieren. Verwenden Sie beispielsweise den folgenden Befehl, um das beliebte npm-Paket `lodash` zu installieren. 

   ```
   npm install lodash
   ```

1.  Verwenden Sie den **list-packages** Befehl, um das Paket anzuzeigen, das Sie gerade in Ihrem `my-repo` Repository installiert haben. 
**Anmerkung**  
Zwischen dem Abschluss des `npm install` Installationsbefehls und dem Zeitpunkt, an dem das Paket in Ihrem Repository sichtbar ist, kann es zu einer Verzögerung kommen. Einzelheiten zur typischen Latenz beim Abrufen von Paketen aus öffentlichen Repositorien finden Sie unter. [Latenz bei externen Verbindungen](external-connection-requesting-packages.md#external-connection-latency) 

   ```
   aws codeartifact list-packages --domain my-domain --repository my-repo
   ```

    JSON-formatierte Daten werden in der Ausgabe mit dem Format und dem Namen des Pakets angezeigt, das Sie installiert haben. 

   ```
   {
       "packages": [
           {
               "format": "npm",
               "package": "lodash"
           }
       ]
   }
   ```

   Sie haben jetzt drei Ressourcen: CodeArtifact 
   +  Die Domain`my-domain`. 
   +  Das Repository`my-repo`, das in enthalten ist`my-domain`. Für dieses Repository steht ein npm-Paket zur Verfügung. 
   +  Das Repository`npm-store`, das in `my-domain` enthalten ist. Dieses Repository hat eine externe Verbindung zum öffentlichen NPM-Repository und ist dem Repository als Upstream-Repository zugeordnet. `my-repo` 

1. Um weitere AWS Gebühren zu vermeiden, löschen Sie die Ressourcen, die Sie in diesem Tutorial verwendet haben: 
**Anmerkung**  
 Eine Domain, die Repositorys enthält, kann nicht gelöscht werden. Deshalb müssen Sie `npm-store` zuerst `my-repo` und löschen`my-domain`. 

   1.  Verwenden Sie den **delete-repository** Befehl, um das `npm-store` Repository zu löschen. 

      ```
      aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository my-repo
      ```

       In der Ausgabe werden Daten im JSON-Format mit Details zum gelöschten Repository angezeigt. 

      ```
      {
          "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.  Verwenden Sie den **delete-repository** Befehl, um das Repository zu löschen. `npm-store` 

      ```
      aws codeartifact delete-repository --domain my-domain --domain-owner 111122223333 --repository npm-store
      ```

       In der Ausgabe werden Daten im JSON-Format mit Details zum gelöschten Repository angezeigt.

      ```
      {
          "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. Verwenden Sie den **delete-domain** Befehl, um das Repository zu löschen. `my-domain` 

      ```
      aws codeartifact delete-domain --domain my-domain --domain-owner 111122223333
      ```

       In der Ausgabe werden Daten im JSON-Format mit Details zur gelöschten Domain angezeigt.

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