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 CodeArtifact
In diesem Tutorial für die ersten Schritte erstellen CodeArtifact Sie Folgendes:
+ Eine Domain namens`my-domain`.
+ Ein Repository namens`my-repo`, das enthalten ist in`my-domain`.
+ Ein Repository mit dem Namen`npm-store`, das enthalten ist in`my-domain`. Das `npm-store` hat eine externe Verbindung zum öffentlichen NPM-Repository. Diese Verbindung wird verwendet, um ein npm-Paket in das Repository aufzunehmen. `my-repo`
Bevor Sie mit diesem Tutorial beginnen, empfehlen wir Ihnen, es zu lesen. CodeArtifact [AWS CodeArtifact Konzepte](codeartifact-concepts.md)
**Anmerkung**
In diesem Tutorial müssen Sie Ressourcen erstellen, die möglicherweise Kosten für Ihr AWS -Konto verursachen. Weitere Informationen finden Sie unter [CodeArtifact Preise](https://aws.amazon.com/codeartifact/pricing/).
**Topics**
+ [Voraussetzungen](#getting-started-prerequisites)
+ [Erste Schritte mit der Konsole](getting-started-console.md)
+ [Erste Schritte mit dem AWS CLI](getting-started-cli.md)
## Voraussetzungen
Sie können dieses Tutorial mit dem AWS-Managementkonsole oder dem AWS Command Line Interface (AWS CLI) abschließen. Um dem Tutorial folgen zu können, müssen Sie zunächst die folgenden Voraussetzungen erfüllen:
+ Führen Sie die Schritte unter [Einrichtung mit AWS CodeArtifact](get-set-up-for-codeartifact.md) aus.
+ Installieren Sie die npm-CLI. Weitere Informationen finden Sie unter [Node.js und npm herunterladen und installieren in der npm-Dokumentation](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
# Erste Schritte mit der Konsole
Führen Sie die folgenden Schritte aus, um mit der CodeArtifact AWS-Managementkonsole Verwendung von zu beginnen. In diesem Handbuch wird der `npm` Paketmanager verwendet. Wenn Sie einen anderen Paketmanager verwenden, müssen Sie einige der folgenden Schritte ändern.
1. Melden Sie sich bei [https://console.aws.amazon.com/codesuite/codeartifact/start](https://console.aws.amazon.com/codesuite/codeartifact/start) an AWS-Managementkonsole und öffnen Sie die AWS CodeArtifact Konsole. Weitere Informationen finden Sie unter [Einrichtung mit AWS CodeArtifact](get-set-up-for-codeartifact.md).
1. Wählen Sie **Repository erstellen** aus.
1. Geben Sie im Feld **Repository-Name den Wert ein**. **my-repo**
1. (Optional) Geben Sie unter **Repository-Beschreibung** eine optionale Beschreibung für Ihr Repository ein.
1. Wählen Sie **unter Öffentliche Upstream-Repositorys** die Option **npm-store** aus, um ein mit **npmjs** verbundenes Repository zu erstellen, das Ihrem Repository vorgeschaltet ist. `my-repo`
CodeArtifact weist diesem Repository den Namen `npm-store` für Sie zu. Alle Pakete, die im Upstream-Repository verfügbar sind, `npm-store` sind auch für das entsprechende Downstream-Repository verfügbar. `my-repo`
1. Wählen Sie **Weiter**.
1. Wählen Sie unter **AWS-Konto** die Option **Dieses AWS-Konto** aus.
1. Geben Sie im Feld **Domainname** den Wert ein**my-domain**.
1. Erweitern Sie **Additional configuration (Zusätzliche Konfiguration)**.
1. Sie müssen einen AWS KMS key (KMS-Schlüssel) verwenden, um alle Ressourcen in Ihrer Domain zu verschlüsseln. Sie können einen Von AWS verwalteter Schlüssel oder einen KMS-Schlüssel verwenden, den Sie verwalten:
+ Wählen Sie **AWS-verwalteten Schlüssel**, wenn Sie den Standard verwenden möchten Von AWS verwalteter Schlüssel.
+ Wählen Sie **Vom Kunden verwalteter Schlüssel**, wenn Sie einen von Ihnen verwalteten KMS-Schlüssel verwenden möchten. Um einen KMS-Schlüssel zu verwenden, den Sie verwalten, suchen Sie unter **ARN für vom Kunden verwalteten Schlüssel** nach dem KMS-Schlüssel und wählen Sie ihn aus.
Weitere Informationen finden Sie unter [Von AWS verwalteter Schlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)und vom [Kunden verwalteter Schlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) im *AWS Key Management Service Entwicklerhandbuch*.
1. Wählen Sie **Weiter**.
1. **Prüfen Sie unter Überprüfen und erstellen**, CodeArtifact was für Sie erstellt wurde.
+ **Der Paketfluss** zeigt `my-domain``my-repo`, wie, und `npm-store` zusammenhängen.
+ **Schritt 1: Repository erstellen** zeigt Details zu `my-repo` und`npm-store`.
+ **Schritt 2: Domain auswählen** zeigt Details zu`my-domain`.
Wenn Sie bereit sind, wählen Sie **Repository erstellen**.
1. **Wählen Sie auf der Seite **my-repo** die Option **Verbindungsanweisungen anzeigen** und dann npm aus.**
1. Verwenden Sie den AWS CLI , um den unter **Konfigurieren Sie Ihren NPM-Client** mit diesem `login` Befehl angezeigten Befehl auszuführen. AWS CLI CodeArtifact
```
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
```
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).
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. Kehren Sie zur CodeArtifact Konsole zurück. Wenn Ihr **my-repo-Repository** geöffnet ist, aktualisieren Sie die Seite. **Andernfalls wählen Sie im Navigationsbereich **Repositories** und dann my-repo aus.**
Unter **Pakete** sollten Sie die NPM-Bibliothek oder das Paket sehen, das Sie installiert haben. Sie können den Namen des Pakets wählen, um dessen Version und Status anzuzeigen. Sie können die neueste Version auswählen, um Paketdetails wie Abhängigkeiten, Ressourcen und mehr anzuzeigen.
**Anmerkung**
Es kann zu einer Verzögerung zwischen der Installation des Pakets und der Aufnahme in Ihr Repository kommen.
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. Wählen Sie im Navigationsbereich **Repositories** aus.
1. Wählen Sie **npm-store**, wählen Sie **Löschen** und folgen Sie dann den Schritten zum Löschen des Repositorys.
1. Wählen Sie **my-repo**, wählen Sie **Löschen** und folgen Sie dann den Schritten zum Löschen des Repositorys.
1. **Wählen Sie im Navigationsbereich Domains aus.**
1. Wählen Sie **my-domain** und anschließend **Delete** aus, und folgen Sie dann den Schritten zum Löschen der Domain.
# Erste Schritte mit dem AWS CLI
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
}
}
```