Menerbitkan dan mengkonsumsi paket generik - CodeArtifact

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menerbitkan dan mengkonsumsi paket generik

Untuk mempublikasikan versi paket generik dan aset terkait, gunakan publish-package-version perintah. Anda dapat membuat daftar aset paket generik menggunakan list-package-version-asset perintah dan mengunduhnya menggunakanget-package-version-asset. Topik berikut berisi step-by-step instruksi untuk menerbitkan paket generik atau mengunduh aset paket generik menggunakan perintah ini.

Menerbitkan paket generik

Paket generik terdiri dari nama paket, namespace, versi, dan satu atau lebih aset (atau file). Topik ini menunjukkan cara mempublikasikan paket bernamamy-package, dengan namespacemy-ns, versi1.0.0, dan berisi satu aset bernama. asset.tar.gz

Prasyarat:

Untuk mempublikasikan paket generik
  1. Gunakan perintah berikut untuk menghasilkan hash SHA256 untuk setiap file yang ingin Anda unggah ke versi paket, dan tempatkan nilai dalam variabel lingkungan. Nilai ini digunakan sebagai pemeriksaan integritas untuk memverifikasi bahwa konten file tidak berubah setelah awalnya dikirim.

    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. Panggil publish-package-version untuk mengunggah aset dan membuat versi paket baru.

    catatan

    Jika paket berisi lebih dari satu aset, Anda dapat menelepon satu publish-package-version kali untuk setiap aset yang akan diunggah. Sertakan --unfinished argumen untuk setiap panggilanpublish-package-version, kecuali saat mengunggah aset akhir. Penghilangan --unfinished akan mengatur status versi paket kePublished, dan mencegah aset tambahan diunggah ke sana.

    Atau, sertakan --unfinished untuk setiap panggilan kepublish-package-version, lalu atur status versi paket untuk Published menggunakan update-package-versions-status perintah.

    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%

    Berikut ini menunjukkan 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" } } }

Daftar aset paket generik

Untuk membuat daftar aset yang terkandung dalam paket generik, gunakan list-package-version-assets perintah. Untuk informasi selengkapnya, lihat Mencantumkan aset versi paket.

Contoh berikut mencantumkan aset 1.0.0 versi paketmy-package.

Untuk mencantumkan aset versi paket
  • Panggilan list-package-version-assets untuk membuat daftar aset yang terkandung dalam paket generik.

    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

    Berikut ini menunjukkan 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" }

Mengunduh aset paket generik

Untuk mengunduh aset dari paket generik, gunakan get-package-version-asset perintah. Untuk informasi selengkapnya, lihat Mengunduh aset versi paket.

Contoh berikut mengunduh aset asset.tar.gz 1.0.0 dari versi paket my-package ke direktori kerja saat ini ke dalam file yang juga bernamaasset.tar.gz.

Untuk mengunduh aset versi paket
  • Panggilan get-package-version-asset untuk mengunduh aset dari paket generik.

    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

    Berikut ini menunjukkan output.

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