Erstellen eines -Repositorys

Da alle Pakete in Repositorys gespeichert CodeArtifact sind, müssen Sie zur Verwendung CodeArtifact eines erstellen. Sie können ein Repository mithilfe der CodeArtifact Konsole, der Taste AWS Command Line Interface (AWS CLI) oder AWS CloudFormation erstellen. Jedes Repository ist dem AWS Konto zugeordnet, das Sie bei der Erstellung verwenden. Sie können mehrere Repositorys haben, und diese werden erstellt und in Domänen gruppiert. Wenn Sie ein Repository erstellen, enthält es keine Pakete. Repositorys sind polyglot, was bedeutet, dass ein einzelnes Repository Pakete aller unterstützten Typen enthalten kann.

Hinweise zu CodeArtifact Dienstbeschränkungen, wie z. B. der maximal zulässigen Anzahl von Repositorys in einer einzelnen Domäne, finden Sie unter. Kontingente in AWS CodeArtifact Wenn Sie die maximale Anzahl erlaubter Repositorys erreicht haben, können Sie Repositorys löschen, um Platz für weitere zu schaffen.

Einem Repository können ein oder mehrere CodeArtifact Repositorys als Upstream-Repositorys zugeordnet sein. Auf diese Weise kann ein Paketmanager-Client über einen einzigen URL-Endpunkt auf die Pakete zugreifen, die in mehr als einem Repository enthalten sind. Weitere Informationen finden Sie unter Arbeiten mit Upstream-Repositorys in CodeArtifact.

Weitere Hinweise zur Verwaltung von CodeArtifact Repositorys mit finden Sie CloudFormation unter CodeArtifact Ressourcen erstellen mit AWS CloudFormation.

Anmerkung

Nachdem Sie ein Repository erstellt haben, können Sie seinen Namen, sein zugeordnetes AWS Konto oder seine Domäne nicht mehr ändern.

Erstellen Sie ein Repository (Konsole)

1. Öffnen Sie die AWS CodeArtifact Konsole unter https://console.aws.amazon.com/codesuite/codeartifact/home.

2. Wählen Sie im Navigationsbereich Repositories und dann Create repository aus.

3. Geben Sie unter Repository-Name einen Namen für Ihr Repository ein.

4. (Optional) Geben Sie unter Repository-Beschreibung eine optionale Beschreibung für Ihr Repository ein.

5. (Optional) Fügen Sie unter Upstream-Repositorys veröffentlichen Zwischenrepositorys hinzu, die Ihre Repositorys mit Paketbehörden wie Maven Central oder npmjs.com verbinden.

6. Wählen Sie Weiter aus.

7. Wählen Sie im AWS-Konto die Option Dieses AWS-Konto aus, wenn Sie bei dem Konto angemeldet sind, dem die Domain gehört. Wählen Sie Anderes AWS-Konto, wenn ein anderes AWS-Konto die Domain besitzt.

8. Wählen Sie unter Domain die Domain aus, in der das Repository erstellt werden soll.

   Wenn das Konto keine Domänen enthält, müssen Sie eine erstellen. Geben Sie den Namen für die neue Domain im Feld Domainname ein.

   Erweitern Sie Additional configuration (Zusätzliche Konfiguration).

   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:

   Wichtig

   CodeArtifact unterstützt nur symmetrische KMS-Schlüssel. Sie können keinen asymmetrischen KMS-Schlüssel verwenden, um Ihre Domänen zu verschlüsseln. CodeArtifact Wie Sie feststellen, ob ein KMS-Schlüssel symmetrisch oder asymmetrisch ist, erfahren Sie unter Erkennen symmetrischer und asymmetrischer KMS-Schlüssel.

   • 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 verwaltete SchlüsselVom Kunden verwalteter Schlüssel im AWS Key Management Service Entwicklerhandbuch.

9. Wählen Sie Weiter aus.

10. Prüfen Sie unter Überprüfen und erstellen, CodeArtifact was für Sie erstellt wurde.

    • Der Paketfluss zeigt, wie Ihre Domain und Ihre Repositorys miteinander verbunden sind.

    • Schritt 1: Repository erstellen zeigt Details zum Repository und zu optionalen Upstream-Repositorys, die erstellt werden.

    • Schritt 2: Domain auswählen zeigt Details zumy_domain.

    Wenn Sie bereit sind, wählen Sie Repository erstellen.

Erstellen Sie ein Repository (AWS CLI)

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 --description "My new repository"

Beispielausgabe:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": "[]",
        "externalConnections"" "[]"
    }
}

Ein neues Repository enthält keine Pakete. Jedes Repository ist dem AWS Konto zugeordnet, mit dem Sie bei der Erstellung des Repositorys authentifiziert wurden.

Erstellen Sie ein Repository mit Tags

Um ein Repository mit Tags zu erstellen, fügen Sie den --tags Parameter zu Ihrem create-domain Befehl hinzu.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo --tags key=k1,value=v1 key=k2,value=v2

Erstellen Sie ein Repository mit einem Upstream-Repository

Sie können ein oder mehrere Upstream-Repositorys angeben, wenn Sie ein Repository erstellen.

aws codeartifact create-repository --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --upstreams repositoryName=my-upstream-repo --repository-description "My new repository"

Beispielausgabe:

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:region-id:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": [
            {
                "repositoryName": "my-upstream-repo"
            }
        ],
        "externalConnections"" "[]"
    }
}

Anmerkung

Um ein Repository mit einem Upstream-Repository zu erstellen, benötigen Sie die Erlaubnis für die AssociateWithDownstreamRepository Aktion im Upstream-Repository.

Informationen zum Hinzufügen eines Upstream-Objekts zu einem Repository, nachdem es erstellt wurde, finden Sie unter Upstream-Repositorys hinzufügen oder entfernen (Konsole) undFügen Sie Upstream-Repositorys hinzu oder entfernen Sie sie ()AWS CLI.