Pubblicazione e utilizzo di pacchetti generici - CodeArtifact
Pubblicazione di un pacchetto genericoElenco delle risorse del pacchetto genericoScaricamento delle risorse del pacchetto generico

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

Pubblicazione e utilizzo di pacchetti generici

Per pubblicare una versione generica del pacchetto e le relative risorse, utilizzate il publish-package-version comando. È possibile elencare le risorse di un pacchetto generico utilizzando il list-package-version-asset comando e scaricarle utilizzandoget-package-version-asset. L'argomento seguente contiene step-by-step istruzioni per pubblicare pacchetti generici o scaricare risorse di pacchetti generici utilizzando questi comandi.

Pubblicazione di un pacchetto generico

Un pacchetto generico è costituito da un nome di pacchetto, uno spazio dei nomi, una versione e uno o più asset (o file). Questo argomento dimostra come pubblicare un pacchetto denominatomy-package, con lo spazio dei nomimy-ns, la versione 1.0.0 e contenente una risorsa denominata. asset.tar.gz

Prerequisiti:

Per pubblicare un pacchetto generico

  1. Utilizzate il comando seguente per generare l'hash SHA256 per ogni file che desiderate caricare in una versione del pacchetto e inserite il valore in una variabile di ambiente. Questo valore viene utilizzato come controllo di integrità per verificare che il contenuto del file non sia cambiato dopo l'invio originale.

    Linux
    export ASSET_SHA256=$(sha256sum asset.tar.gz | awk '{print $1;}')
    macOS
    export ASSET_SHA256=$(shasum -a 256 asset.tar.gz | awk '{print $1;}')
    Windows
    for /f "tokens=*" %G IN ('certUtil -hashfile asset.tar.gz SHA256 ^| findstr /v "hash"') DO SET "ASSET_SHA256=%G"

  2. Chiama publish-package-version per caricare la risorsa e creare una nuova versione del pacchetto.

    Nota

    Se il pacchetto contiene più di una risorsa, puoi chiamare publish-package-version una volta per ogni risorsa da caricare. --unfinishedIncludete l'argomento per ogni chiamata apublish-package-version, tranne quando caricate la risorsa finale. L'omissione --unfinished imposterà lo stato della versione del pacchetto su e impedirà il caricamento di risorse aggiuntive. Published

    In alternativa, includi --unfinished per ogni chiamata apublish-package-version, quindi imposta lo stato della versione del pacchetto sull'Publishedutilizzo del update-package-versions-status comando.

    Linux/macOS
    aws codeartifact publish-package-version --domain my_domain --repository my_repo \
      --format generic --namespace my-ns --package my-package --package-version 1.0.0 \
      --asset-content asset.tar.gz --asset-name asset.tar.gz \
      --asset-sha256 $ASSET_SHA256
    Windows
    aws codeartifact publish-package-version --domain my_domain --repository my_repo ^
      --format generic --namespace my-ns --package my-package --package-version 1.0.0 ^
      --asset-content asset.tar.gz --asset-name asset.tar.gz ^  
      --asset-sha256 %ASSET_SHA256%

    Di seguito è riportato l'output.

    {
    "format": "generic",
    "namespace": "my-ns",
    "package": "my-package",
    "version": "1.0.0",
    "versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
    "status": "Published",
    "asset": {
        "name": "asset.tar.gz",
        "size": 11,
        "hashes": {
            "MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
            "SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
            "SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
            "SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
        }
    }
}

Elenco delle risorse del pacchetto generico

Per elencare gli asset contenuti in un pacchetto generico, utilizzate il list-package-version-assets comando. Per ulteriori informazioni, consulta Elenca le risorse della versione del pacchetto.

L'esempio seguente elenca gli asset della versione 1.0.0 del pacchettomy-package.

Per elencare gli asset della versione del pacchetto

  • Chiama list-package-version-assets per elencare le risorse contenute in un pacchetto generico.

    Linux/macOS
    aws codeartifact list-package-version-assets --domain my_domain \
  --repository my_repo --format generic --namespace my-ns \
  --package my-package --package-version 1.0.0
    Windows
    aws codeartifact list-package-version-assets --domain my_domain ^
  --repository my_repo --format generic --namespace my-ns ^
  --package my-package --package-version 1.0.0

    Di seguito è riportato l'output.

    {
    "assets": [
        {
            "name": "asset.tar.gz",
            "size": 11,
            "hashes": {
                "MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
                "SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
                "SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
                "SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
            }
        }
    ],
    "package": "my-package",
    "format": "generic",
    "namespace": "my-ns",
    "version": "1.0.0",
    "versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
}

Scaricamento delle risorse del pacchetto generico

Per scaricare le risorse da un pacchetto generico, utilizzate il get-package-version-asset comando. Per ulteriori informazioni, consulta Scarica gli asset della versione del pacchetto.

L'esempio seguente scarica la risorsa asset.tar.gz dalla versione 1.0.0 del pacchetto my-package alla directory di lavoro corrente in un file denominato anch'essoasset.tar.gz.

Per scaricare gli asset della versione del pacchetto

  • Chiama get-package-version-asset per scaricare risorse da un pacchetto generico.

    Linux/macOS
    aws codeartifact get-package-version-asset --domain my_domain \
  --repository my_repo --format generic --namespace my-ns --package my-package \
  --package-version 1.0.0 --asset asset.tar.gz \ 
  asset.tar.gz
    Windows
    aws codeartifact get-package-version-asset --domain my_domain ^
  --repository my_repo --format generic --namespace my-ns --package my-package ^
  --package-version 1.0.0 --asset asset.tar.gz ^
  asset.tar.gz

    Di seguito è riportato l'output.

    {
    "assetName": "asset.tar.gz",
    "packageVersion": "1.0.0",
    "packageVersionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
}