Generische Pakete veröffentlichen und konsumieren

Verwenden Sie den publish-package-version Befehl, um eine generische Paketversion und die zugehörigen Elemente zu veröffentlichen. Sie können die Elemente eines generischen Pakets mithilfe des list-package-version-asset Befehls auflisten und mit diesem Befehl herunterladenget-package-version-asset. Das folgende Thema enthält step-by-step Anweisungen zum Veröffentlichen von generischen Paketen oder zum Herunterladen generischer Paketressourcen mithilfe dieser Befehle.

Veröffentlichen eines generischen Pakets

Ein generisches Paket besteht aus einem Paketnamen, einem Namespace, einer Version und einem oder mehreren Assets (oder Dateien). In diesem Thema wird gezeigt, wie ein Paket mit dem Namenmy-package, dem Namespace my-ns und der Version 1.0.0 veröffentlicht wird und das ein Objekt mit dem Namen enthält. asset.tar.gz

Voraussetzungen:

• Richten Sie das ein und konfigurieren Sie AWS Command Line Interface mit CodeArtifact (sieheEinrichtung mit AWS CodeArtifact)

• Besitzen Sie eine CodeArtifact Domain und ein Repository (sieheErste Schritte mit der AWS CLI)

Um ein generisches Paket zu veröffentlichen

1. Verwenden Sie den folgenden Befehl, um den SHA256-Hash für jede Datei zu generieren, die Sie in eine Paketversion hochladen möchten, und platzieren Sie den Wert in einer Umgebungsvariablen. Dieser Wert wird als Integritätsprüfung verwendet, um sicherzustellen, dass sich der Dateiinhalt nach dem ursprünglichen Senden nicht geändert hat.

   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. Rufen Sie publish-package-version auf, um das Asset hochzuladen und eine neue Paketversion zu erstellen.

   Anmerkung

   Wenn Ihr Paket mehr als ein Asset enthält, können Sie jedes Asset publish-package-version einmal aufrufen, um es hochzuladen. Geben Sie das --unfinished Argument für jeden Aufruf von an an an anpublish-package-version, außer wenn das endgültige Asset hochgeladen wird. Durch das Auslassen --unfinished wird der Status der Paketversion auf gesetzt und es wird verhindertPublished, dass weitere Inhalte in die Paketversion hochgeladen werden.

   Alternativ können Sie --unfinished bei jedem Aufruf von die Option „einschließen“ und dann den Status der Paketversion Published mithilfe des update-package-versions-status Befehls auf „setzen“. publish-package-version

   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%

   Nachfolgend sehen Sie die Ausgabe.

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

Generische Paketressourcen auflisten

Verwenden Sie den list-package-version-assets Befehl, um die in einem generischen Paket enthaltenen Ressourcen aufzulisten. Weitere Informationen finden Sie unter Listet die Ressourcen der Paketversion auf.

Das folgende Beispiel listet die Elemente 1.0.0 der Paketversion aufmy-package.

Um die Ressourcen der Paketversion aufzulisten

• Rufen Sie list-package-version-assets auf, um die in einem generischen Paket enthaltenen Ressourcen aufzulisten.

  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
  

  Nachfolgend sehen Sie die Ausgabe.

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

Generische Paket-Assets werden heruntergeladen

Verwenden Sie den get-package-version-asset Befehl, um die Assets aus einem generischen Paket herunterzuladen. Weitere Informationen finden Sie unter Laden Sie die Ressourcen der Paketversion herunter.

Im folgenden Beispiel wird das Asset asset.tar.gz aus 1.0.0 der Version des Pakets in my-package das aktuelle Arbeitsverzeichnis in eine ebenfalls benannte Datei heruntergeladenasset.tar.gz.

Um Assets aus der Paketversion herunterzuladen

• Rufen Sie get-package-version-asset auf, um Ressourcen aus einem generischen Paket herunterzuladen.

  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

  Nachfolgend sehen Sie die Ausgabe.

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