Esempi di CodeArtifact che utilizzano AWS CLI - AWS Command Line Interface
Operazioni

Esempi di CodeArtifact che utilizzano AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con CodeArtifact.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare associate-external-connection.

AWS CLI

Come aggiungere una connessione esterna a un repository

Nell’esempio seguente, associate-external-connection aggiunge una connessione esterna a npmjs.com a un repository denominato test-repo.

aws codeartifact associate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

Per ulteriori informazioni, consulta Aggiungere una connessione esterna nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare copy-package-versions.

AWS CLI

Come copiare versioni di pacchetti da un repository all’altro

Nell’esempio seguente, copy-package-versions sposta le versioni 4.0.0 e 5.0.0 di un pacchetto denominato test-package da my-repo a test-repo.

aws codeartifact copy-package-versions \
    --domain test-domain \
    --source-repository my-repo \
    --destination-repository test-repo \
    --format npm \
    --package test-package \
    --versions '["4.0.0", "5.0.0"]'

Output:

{
    "format": "npm",
    "package": "test-package",
    "versions": [
        {
        "version": "5.0.0",
        "revision": "REVISION-1-SAMPLE-6C81EFF7DA55CC",
        "status": "Published"
        },
        {
        "version": "4.0.0",
        "revision": "REVISION-2-SAMPLE-55C752BEE772FC",
        "status": "Published"
        }
    ]
}

Per ulteriori informazioni, consulta Copia dei pacchetti tra repository nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta CopyPackageVersions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-domain.

AWS CLI

Come creare un dominio

Nell’esempio seguente, create-domain crea un dominio denominato test-domain.

aws codeartifact create-domain \
    --domain test-domain

Output:

{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Per ulteriori informazioni, consulta Creare un dominio nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta CreateDomain in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-repository.

AWS CLI

Come creare un repository

Nell’esempio seguente, create-repository crea un repository denominato test-repo all’interno di un dominio denominato test-domain.

aws codeartifact create-repository \
    --domain test-domain \
    --domain-owner 111122223333 \
    --repository test-repo \
    --description "This is a test repository."

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}

Per ulteriori informazioni, consulta Creare un dominio nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta CreateRepository in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-domain-permissions-policy.

AWS CLI

Come eliminare il documento della policy di autorizzazioni da un dominio

Nell’esempio seguente, delete-domain-permissions-policy elimina la policy di autorizzazione da un dominio denominato test-domain.

aws codeartifact delete-domain-permissions-policy \
    --domain test-domain

Output:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Delete a domain policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare delete-domain.

AWS CLI

Come eliminare un dominio

Nell’esempio seguente, delete-domain elimina un dominio denominato test-domain.

aws codeartifact delete-domain \
    --domain test-domain

Output:

{
    "domain": {
        "name": "test-domain",
        "owner": "417498243647",
        "arn": "arn:aws:codeartifact:us-west-2:417498243647:domain/test-domain",
        "status": "Deleted",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:417498243647:key/c9fe2447-0795-4fda-afbe-8464574ae162",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Per ulteriori informazioni, consulta Eliminazione di un dominio nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta DeleteDomain in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-package-versions.

AWS CLI

Come eliminare versioni di pacchetti

Nell’esempio seguente, delete-package-versions elimina la versione 4.0.0 di un pacchetto denominato test-package.

aws codeartifact delete-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0

Output:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Deleted"
        }
    },
    "failedVersions": {}
}

Per ulteriori informazioni, consulta Delete a package version nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare delete-repository-permissions-policy.

AWS CLI

Come eliminare una policy di autorizzazioni da un repository

Nell’esempio seguente, delete-repository-permissions-policy elimina la policy di autorizzazione da un repository denominato test-repo.

aws codeartifact delete-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo

Output:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}

Per ulteriori informazioni, consulta Eliminazione di una policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare delete-repository.

AWS CLI

Come eliminare un repository

Nell’esempio seguente, delete-repository elimina un repository denominato test-repo in un dominio denominato test-domain.

aws codeartifact delete-repository \
    --domain test-domain \
    --repository test-repo

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository",
        "upstreams": [],
        "externalConnections": []
    }
}

Per ulteriori informazioni, consulta Delete a repository nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta DeleteRepository in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-domain.

AWS CLI

Come ottenere informazioni su un dominio

Nell’esempio seguente, describe-domain restituisce un oggetto DomainDescription per un dominio denominato test-domain.

aws codeartifact describe-domain \
    --domain test-domain

Output:

{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 2,
        "assetSizeBytes": 0,
        "s3BucketArn": "arn:aws:s3:::assets-111122223333-us-west-2"
    }
}

Per ulteriori informazioni, consulta Panoramica del dominio nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta DescribeDomain in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-repository.

AWS CLI

Come ottenere informazioni su un repository

Nell’esempio seguente, describe-repository restituisce un oggetto RepositoryDescription per un repository denominato test-repo.

aws codeartifact describe-repository \
    --domain test-domain \
    --repository test-repo

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}

Per ulteriori informazioni, consulta Creare un dominio nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta DescribeRepository in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare disassociate-external-connection.

AWS CLI

Come rimuovere una connessione esterna da un repository

Nell’esempio seguente, disassociate-external-connection rimuove una connessione esterna a npmjs.com da un repository denominato test-repo.

aws codeartifact disassociate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": []
    }
}

Per ulteriori informazioni, consulta Remove an external connection nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare dispose-package-versions.

AWS CLI

Come eliminare gli asset di una versione del pacchetto e impostarne lo stato su Rimosso.

Nell’esempio seguente dispose-package-versions elimina gli asset della versione 4.0.0 di test-package e ne imposta lo stato su Rimosso.

aws codeartifact dispose-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0

Output:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Disposed"
        }
    },
    "failedVersions": {}
}

Per ulteriori informazioni, consulta Working with packages in CodeArtifact nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-authorization-token.

AWS CLI

Come ottenere un token di autorizzazione

Nell’esempio seguente, get-authorization-token recupera un token di autorizzazione CodeArtifact.

aws codeartifact get-authorization-token \
    --domain test-domain \
    --query authorizationToken \
    --output text

Output:

This command will return the authorization token. You can store the output in an environment variable when calling the command.

Per ulteriori informazioni, consulta Configure pip without the login command nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-domain-permissions-policy.

AWS CLI

Come ottenere il documento della policy di autorizzazioni per un dominio

Nell’esempio seguente, get-domain-permissions-policy ottiene la policy di autorizzazione associata a un dominio denominato test-domain.

aws codeartifact get-domain-permissions-policy \
    --domain test-domain

Output:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Read a domain policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-package-version-asset.

AWS CLI

Come ottenere un asset da una versione del pacchetto

Nell’esempio seguente, get-package-version-asset recupera l’asset package.tgz per la versione 4.0.0 di un pacchetto npm denominato test-package.

aws codeartifact get-package-version-asset \
    --domain test-domain \
    --repository test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0 \
    --asset 'package.tgz' \
    outfileName

Output:

The output for this command will also store the raw asset in the file provided in place of outfileName.

{
    "assetName": "package.tgz",
    "packageVersion": "4.0.0",
    "packageVersionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}

Per ulteriori informazioni, consulta List package version assets nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-package-version-readme.

AWS CLI

Come ottenere il file readme di una versione del pacchetto

Nell’esempio seguente, get-package-version-readme recupera l’asset del file Readme per la versione 4.0.0 di un pacchetto npm denominato test-package.

aws codeartifact get-package-version-readme \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Output:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "readme": "<div align=\"center\">\n   <a href=\https://github.com/test-package/testpack\"> ... more content ... \n",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}

Per ulteriori informazioni, consulta View package version readme file nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-repository-endpoint.

AWS CLI

Come ottenere l’endpoint URL di un repository

Nell’esempio seguente, get-repository-endpoint restituisce l’endpoint npm per il repository test-repo.

aws codeartifact get-repository-endpoint \
    --domain test-domain \
    --repository test-repo \
    --format npm

Output:

{
    "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/"
}

Per ulteriori informazioni, consulta Connessione a un repository nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare get-repository-permissions-policy.

AWS CLI

Come ottenere il documento della policy di autorizzazioni per un repository

Nell’esempio seguente, get-repository-permissions-policy ottiene la policy di autorizzazione associata a un repository denominato test-repo.

aws codeartifact get-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo

Output:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}

Per ulteriori informazioni, consulta Read a policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare list-domains.

AWS CLI

Come elencare i domini

Nell’esempio seguente, list-domains restituisce un riepilogo di tutti i domini di proprietà dell’account AWS che effettua la chiamata.

aws codeartifact list-domains

Output:

{
    "domains": [
        {
            "name": "my-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        },
        {
            "name": "test-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        }
    ]
}

Per ulteriori informazioni, consulta Working with domains in CodeArtifact nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta ListDomains in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-package-version-assets.

AWS CLI

Come visualizzare gli asset di una versione del pacchetto

Nell’esempio seguente, list-package-version-assets recupera gli asset per la versione 4.0.0 di un pacchetto npm denominato test-package.

aws codeartifact list-package-version-assets \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Output:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "assets": [
        {
            "name": "package.tgz",
            "size": 316680,
            "hashes": {
                "MD5": "60078ec6d9e76b89fb55c860832742b2",
                "SHA-1": "b44a9b6297bcb698f1c51a3545a2b3b368d59c52",
                "SHA-256": "d2aa8c6afc3c8591765785a37d1c5acae482a8eb3ab9729ed28922692454f2e2",
                "SHA-512": "3e585d15c8a594e20d7de57b362ea81754c011acb2641a19f1b72c8531ea39825896bab344ae616a0a5a824cb9a381df0b3cddd534645cf305aba70a93dac698"
            }
        }
    ]
}

Per ulteriori informazioni, consulta List package version assets nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare list-package-version-dependencies.

AWS CLI

Come visualizzare le dipendenze di una versione del pacchetto

Nell’esempio seguente, list-package-version-dependencies recupera le dipendenze per la versione 4.0.0 di un pacchetto npm denominato test-package.

aws codeartifact list-package-version-dependencies \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Output:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "dependencies": [
        {
            "namespace": "testns",
            "package": "testdep1",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        },
        {
            "namespace": "testns",
            "package": "testdep2",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        }
    ]
}

Per ulteriori informazioni, consulta View and update package version details and dependencies nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare list-package-versions.

AWS CLI

Come elencare le versioni di un pacchetto

Nell’esempio seguente, list-package-versions restituisce un elenco di versioni del pacchetto denominato kind-of.

aws codeartifact list-package-versions \
    --package kind-of \
    --domain test-domain \
    --repository test-repo \
    --format npm

Output:

{
    "defaultDisplayVersion": "1.0.1",
    "format": "npm",
    "package": "kind-of",
    "versions": [
        {
            "version": "1.0.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
            "status": "Published"
        },
        {
            "version": "1.0.0",
            "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
            "status": "Published"
        },
        {
            "version": "0.1.2",
            "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
            "status": "Published"
        },
        {
            "version": "0.1.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"",
            "status": "Published"
        },
        {
            "version": "0.1.0",
            "revision": "REVISION-SAMPLE-4-AF669139B772FC",
            "status": "Published"
        }
    ]
}

Per ulteriori informazioni, consulta List package versions nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta ListPackageVersions in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-packages.

AWS CLI

Come elencare i pacchetti in un repository

Nell’esempio seguente, list-packages elenca i pacchetti in un repository denominato test-repo in un dominio denominato test-domain.

aws codeartifact list-packages \
    --domain test-domain \
    --repository test-repo

Output:

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

Per ulteriori informazioni, consulta Elenco dei nomi dei pacchetti nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta ListPackages in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-repositories-in-domain.

AWS CLI

Come elencare i repository in un dominio

Nell’esempio seguente, list-repositories-in-domain restituisce un riepilogo di tutti i repository nel dominio test-domain.

aws codeartifact list-repositories-in-domain \
    --domain test-domain

Output:

{
    "repositories": [
        {
            "name": "test-repo",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
            "description": "This is a test repository."
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}

Per ulteriori informazioni, consulta List repositories nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare list-repositories.

AWS CLI

Come elencare i repository

Nell’esempio seguente, list-repositories restituisce un riepilogo di tutti i repository di proprietà dell’account AWS che effettua la chiamata.

aws codeartifact list-repositories

Output:

{
    "repositories": [
        {
            "name": "npm-store",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
            "description": "Provides npm artifacts from npm, Inc."
        },
        {
            "name": "target-repo",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo",
            "description": "test target repo"
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}

Per ulteriori informazioni, consulta List repositories nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta ListRepositories in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare login.

AWS CLI

Come configurare l’autenticazione al repository con il comando di accesso

Nell’esempio seguente, login configura lo strumento di gestione di pacchetti npm con un repository denominato test-repo in un dominio chiamato test-domain.

aws codeartifact login \
    --domain test-domain \
    --repository test-repo \
    --tool npm

Output:

Successfully configured npm to use AWS CodeArtifact repository https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/
Login expires in 12 hours at 2020-11-12 01:53:16-05:00

Per ulteriori informazioni, consulta Getting started with the AWS CLI nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta Login in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare put-domain-permissions-policy.

AWS CLI

Come associare una policy di autorizzazioni a un dominio

Nell’esempio seguente, put-domain-permissions-policy associa una policy di autorizzazione definita nel file policy.json a un dominio denominato test-domain.

aws codeartifact put-domain-permissions-policy \
    --domain test-domain \
    --policy-document file://PATH/TO/policy.json

Output:

{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}

Per ulteriori informazioni, consulta Set a domain policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare put-repository-permissions-policy.

AWS CLI

Come associare una policy di autorizzazioni a un repository

Nell’esempio seguente, put-repository-permissions-policy associa una policy di autorizzazione definita nel file policy.json a un repository denominato test-repo.

aws codeartifact put-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo \
    --policy-document file://PATH/TO/policy.json

Output:

{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}

Per ulteriori informazioni, consulta Set a policy nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare update-package-versions-status.

AWS CLI

Come aggiornare lo stato della versione del pacchetto

Nell’esempio seguente, update-package-versions-status aggiorna lo stato della versione 4.0.0 del pacchetto test-package su Archiviato.

aws codeartifact update-package-versions-status \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0 \
    --target-status Archived

Output:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Archived"
        }
    },
    "failedVersions": {}
}

Per ulteriori informazioni, consulta Update package version status nella Guida per l’utente di AWS CodeArtifact.

L’esempio di codice seguente mostra come utilizzare update-repository.

AWS CLI

Come aggiornare un repository

Nell’esempio seguente, update-repository aggiorna la descrizione di un repository denominato test-repo in un dominio denominato test-domain impostandola su “this is an updated description” (questa è una descrizione aggiornata).

aws codeartifact update-repository \
    --domain test-domain \
    --repository test-repo \
    --description "this is an updated description"

Output:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "this is an updated description",
        "upstreams": [],
        "externalConnections": []
    }
}

Per ulteriori informazioni, consulta View or modify a repository configuration nella Guida per l’utente di AWS CodeArtifact.

  • Per informazioni dettagliate sull’API, consulta UpdateRepository in AWS CLI Command Reference.