Iniziare a usare il AWS CLI - CodeArtifact

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Iniziare a usare il AWS CLI

Esegui i passaggi seguenti per iniziare a CodeArtifact utilizzare AWS Command Line Interface (AWS CLI). Per ulteriori informazioni, consulta Installa o aggiorna e quindi configura il AWS CLI. Questa guida utilizza il gestore di npm pacchetti, se utilizzi un gestore di pacchetti diverso, dovrai modificare alcuni dei seguenti passaggi.

  1. Usa il AWS CLI per eseguire il create-domain comando. 

    aws codeartifact create-domain --domain my-domain

    I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo dominio. 

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

    Se ricevi l'erroreCould not connect to the endpoint URL, assicurati che AWS CLI sia configurato e che il nome della regione predefinito sia impostato sulla stessa regione in cui hai creato il repository, vedi Configurazione dell'interfaccia a riga di comando AWS.

  2. 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

    I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo repository. 

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

  3. Usa il create-repository comando per creare un repository upstream per il tuo repository. my-repo

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

    I dati in formato JSON vengono visualizzati nell'output con i dettagli sul nuovo repository.

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

  4. Usa il associate-external-connection comando per aggiungere una connessione esterna al repository pubblico npm al tuo repository. npm-store 

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

    I dati in formato JSON vengono visualizzati nell'output con i dettagli sul repository e sulla sua nuova connessione esterna.

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

    Per ulteriori informazioni, consulta Connect un CodeArtifact repository a un repository pubblico.

  5. Utilizzate il update-repository comando per associare il npm-store repository come repository upstream al repository. my-repo 

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

    I dati in formato JSON vengono visualizzati nell'output con i dettagli sul repository aggiornato, incluso il nuovo repository upstream.

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

    Per ulteriori informazioni, consulta Aggiungi o rimuovi i repository upstream ()AWS CLI.

  6. Usa il login comando per configurare il tuo gestore di pacchetti npm con il tuo repository. my-repo 

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

    Dovresti ricevere un output che conferma che il tuo accesso è riuscito.

    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

    Per ulteriori informazioni, consulta Configura e usa npm con CodeArtifact.

  7. Usa la CLI npm per installare un pacchetto npm. Ad esempio, per installare il popolare pacchetto npmlodash, usa il seguente comando. 

    npm install lodash

  8. Usa il list-packages comando per visualizzare il pacchetto che hai appena installato nel tuo my-repo repository.

    Nota

    Potrebbe verificarsi un ritardo tra il completamento del comando di npm install installazione e il momento in cui il pacchetto è visibile nel repository. Per i dettagli sulla latenza tipica durante il recupero di pacchetti da archivi pubblici, consulta. Latenza della connessione esterna 

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

    I dati in formato JSON vengono visualizzati nell'output con il formato e il nome del pacchetto installato. 

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

    Ora hai tre risorse: CodeArtifact

    • Il dominiomy-domain.

    • Il repository my-repo contenuto inmy-domain. Questo repository ha a disposizione un pacchetto npm.

    • Il repository in npm-store cui è contenuto. my-domain Questo repository ha una connessione esterna al repository pubblico npm ed è associato come repository upstream al repository. my-repo

  9. Per evitare ulteriori AWS addebiti, elimina le risorse che hai utilizzato durante questo tutorial:

    Nota

    Non è possibile eliminare un dominio che contiene repository, quindi è necessario eliminare my-repo e npm-store prima di eliminaremy-domain.

    1. Usa il delete-repository comando per eliminare il npm-store repository. 

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

      I dati in formato JSON vengono visualizzati nell'output con i dettagli sull'archivio eliminato. 

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

    2. Usa il delete-repository comando per eliminare il repository. npm-store 

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

      I dati in formato JSON vengono visualizzati nell'output con i dettagli sull'archivio eliminato.

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

    3. Usa il delete-domain comando per eliminare il repository. my-domain 

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

      I dati in formato JSON vengono visualizzati nell'output con i dettagli sul dominio eliminato.

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