Creazione di un repository

Poiché tutti i pacchetti CodeArtifact sono archiviati in repository, per CodeArtifact utilizzarli è necessario crearne uno. È possibile creare un repository utilizzando la CodeArtifact console, il AWS Command Line Interface (AWS CLI) o. AWS CloudFormation Ogni repository è associato all' AWS account che usi al momento della creazione. È possibile disporre di più repository, che vengono creati e raggruppati in domini. Quando si crea un repository, questo non contiene alcun pacchetto. I repository sono poliglotti, il che significa che un singolo repository può contenere pacchetti di qualsiasi tipo supportato.

Per informazioni sui limiti CodeArtifact del servizio, ad esempio il numero massimo di repository consentiti in un singolo dominio, consulta. Quote in AWS CodeArtifact Se raggiungi il numero massimo di repository consentiti, puoi eliminare i repository per fare spazio ad altri.

A un repository possono essere associati uno o più CodeArtifact repository come repository upstream. Ciò consente a un client di gestione dei pacchetti di accedere ai pacchetti contenuti in più di un repository utilizzando un singolo endpoint URL. Per ulteriori informazioni, consulta Lavorare con i repository upstream in CodeArtifact.

Per ulteriori informazioni sulla gestione degli CodeArtifact archivi con CloudFormation, vedere. Creare CodeArtifact risorse con AWS CloudFormation

Nota

Dopo aver creato un repository, non è possibile modificarne il nome, l' AWS account associato o il dominio.

Crea un repository (console)

1. Apri la AWS CodeArtifact console all'indirizzo https://console.aws.amazon.com/codesuite/codeartifact/home.

2. Nel riquadro di navigazione, scegli Repository, quindi scegli Crea repository.

3. Per Nome archivio, inserisci un nome per il tuo repository.

4. (Facoltativo) In Descrizione del repository, inserisci una descrizione facoltativa per il tuo repository.

5. (Facoltativo) In Publish upstream repositories, aggiungi repository intermedi che collegano i tuoi repository alle autorità di gestione dei pacchetti come Maven Central o npmjs.com.

6. Seleziona Successivo.

7. In Account AWS, scegli Questo account AWS se hai effettuato l'accesso all'account proprietario del dominio. Scegli Altro account AWS se il dominio è di proprietà di un altro account AWS.

8. In Dominio, scegli il dominio in cui verrà creato il repository.

   Se non ci sono domini nell'account, devi crearne uno. Inserisci il nome del nuovo dominio in Nome dominio.

   Espandere Additional configuration (Configurazione aggiuntiva).

   È necessario utilizzare una AWS KMS key (chiave KMS) per crittografare tutte le risorse del dominio. Puoi utilizzare una Chiave gestita da AWS o una chiave KMS che gestisci:

   Importante

   CodeArtifact supporta solo chiavi KMS simmetriche. Non puoi utilizzare una chiave KMS asimmetrica per crittografare i tuoi domini. CodeArtifact Per informazioni su come determinare se una chiave KMS è simmetrica o asimmetrica, consulta Identificazione di chiavi KMS simmetriche e asimmetriche.

   • Scegli AWS managed key se desideri utilizzare la chiave predefinita Chiave gestita da AWS.

   • Scegli la chiave gestita dal cliente se desideri utilizzare una chiave KMS da te gestita. Per utilizzare una chiave KMS che gestisci, in ARN della chiave gestita dal cliente, cerca e scegli la chiave KMS.

   Per ulteriori informazioni, consulta la sezione Chiavi gestite da AWSe la chiave gestita dal cliente nella Guida per gli AWS Key Management Service sviluppatori.

9. Seleziona Successivo.

10. In Rivedi e crea, esamina ciò CodeArtifact che stai creando per te.

    • Il flusso del pacchetto mostra come sono collegati il dominio e i repository.

    • Passaggio 1: Crea repository mostra i dettagli sul repository e sui repository upstream opzionali che verranno creati.

    • Passaggio 2: Seleziona il dominio mostra i dettagli su. my_domain

    Quando sei pronto, scegli Crea repository.

Crea un archivio ()AWS CLI

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

Output di esempio:

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

Un nuovo repository non contiene pacchetti. Ogni repository è associato all' AWS account con cui sei autenticato al momento della creazione del repository.

Crea un repository con tag

Per creare un repository con tag, aggiungi il --tags parametro al tuo create-domain comando.

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

Crea un repository con un repository upstream

È possibile specificare uno o più repository upstream quando si crea un repository.

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

Output di esempio:

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

Nota

Per creare un repository con un repository upstream, è necessario disporre dell'autorizzazione per l'AssociateWithDownstreamRepositoryazione sul repository upstream.

Per aggiungere un upstream a un repository dopo che è stato creato, consulta e. Aggiungi o rimuovi repository upstream (console) Aggiungi o rimuovi i repository upstream ()AWS CLI