Erste Schritte mit der AWS CLI

Führen Sie für den Einstieg in folgende Schritte aus: CodeArtifact Verwendung von Verwendung vonAWS Command Line Interface(AWS CLI) enthalten. Weitere Informationen finden Sie unter Installieren oder aktualisieren Sie und konfigurieren Sie dann das AWS CLI. Dieses Handbuch verwendetnpmPaketmanager, wenn Sie einen anderen Paketmanager verwenden, müssen Sie einige der folgenden Schritte ändern.

Verwenden Sie die AWS CLI zum Ausführen des create-domain-Befehls.
```
aws codeartifact create-domain --domain my-domain
```
Daten im JSON-Format werden in der Ausgabe mit Details zu Ihrer neuen Domäne 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 die folgende Fehlermeldung erhaltenCould not connect to the endpoint URL, stellen Sie sicher, dass IhrAWS CLIist konfiguriert und dass deinStandardmäßiger Regionsnameauf die gleiche Region eingestellt ist, in der Sie Ihr Repository erstellt haben, sieheConfiguring the AWS Command Line Interface.

Verwenden dercreate-repositoryBefehl, um ein Repository in Ihrer Domain zu erstellen.


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

Daten im JSON-Format werden in der Ausgabe 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": []
    }
}

Verwenden dercreate-repositoryBefehl zum Erstellen eines Upstream-Repositorys für Ihrmy-repoRepository.


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

Daten im JSON-Format werden in der Ausgabe 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": []
    }
}

Verwenden derassociate-external-connectionBefehl zum Hinzufügen einer externen Verbindung zum öffentlichen Repository von npm zu Ihremnpm-storeRepository.


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

Daten im JSON-Format werden in der Ausgabe 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.

Verwenden derupdate-repositoryBefehl zum Zuordnen desnpm-store-Repository als Upstream-Repository für diemy-repoRepository.


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

Daten im JSON-Format werden in der Ausgabe 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.

Verwenden derloginBefehl, um Ihren npm-Paketmanager mit Ihrem zu konfigurierenmy-repoRepository.


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

Die Ausgabe sollte bestätigt werden, 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.

Verwenden Sie die npm CLI, um ein npm-Paket zu installieren. Zum Beispiel, um das beliebte npm-Paket zu installierenlodashVerwenden Sie den folgenden -Befehl.
```
npm install lodash
```
Verwenden derlist-packagesBefehl, um das Paket anzuzeigen, das Sie gerade in Ihrem installiert habenmy-repoRepository.

Anmerkung
Es kann eine Verzögerung geben zwischen dem Zeitpunkt, an dem dernpm installinstall-Befehl wird abgeschlossen und wenn das Paket in Ihrem Projektarchiv sichtbar ist. Einzelheiten zur typischen Latenz beim Abrufen von Paketen aus öffentlichen Repositorys finden Sie unterLatenz.
```
aws codeartifact list-packages --domain my-domain --repository my-repo
```
Daten im JSON-Format werden in der Ausgabe mit dem Format und dem Namen des von Ihnen installierten Pakets angezeigt.
```
{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
    ]
}
```
Sie haben jetzt drei CodeArtifact -Ressourcen:
- Die Domainmy-domain.
- Das Repositorymy-repodas ist enthalten inmy-domain. Für dieses Projektarchiv steht ein npm-Paket zur Verfügung.
- Das Repositorynpm-storedas ist enthalten inmy-domain. Dieses Repository hat eine externe Verbindung zum öffentlichen npm-Repository und ist als Upstream-Repository mit demmy-repoRepository.

So vermeiden Sie weiterAWSGebühren, löschen Sie die Ressourcen, die Sie in diesem Tutorial verwendet haben:

Anmerkung

Sie können eine Domain, die Repositorys enthält, nicht löschen, daher müssen Sie sie löschenmy-repoundnpm-storebevor du löschstmy-domain.

Verwenden derdelete-repositoryBefehl, um dienpm-storeRepository.


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

Daten im JSON-Format werden in der Ausgabe 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": []
    }
}

Verwenden derdelete-repositoryBefehl, um dienpm-storeRepository.


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

Daten im JSON-Format werden in der Ausgabe 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"
            }
        ]
    }
}

Verwenden derdelete-domainBefehl, um diemy-domainRepository.


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

Daten im JSON-Format werden in der Ausgabe mit Details zur gelöschten Domäne 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
    }
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Erste Schritte mit der Konsole

Arbeiten mit Repositorien