本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 發佈和使用一般套件
若要發佈一般套件版本及其相關資產，請使用 `publish-package-version`命令。您可以使用 `list-package-version-asset`命令列出一般套件的資產，並使用 下載。 `get-package-version-asset`下列主題包含step-by-step說明。
## 發佈一般套件
一般套件包含套件名稱、命名空間、版本，以及一或多個資產 （或 檔案）。本主題示範如何使用命名空間 `my-package`、 版本 發佈名為 `my-ns`的套件`1.0.0`，並包含一個名為 的資產`asset.tar.gz`。
**先決條件：**
+ AWS Command Line Interface 使用 CodeArtifact 設定 （請參閱 [使用 AWS CodeArtifact 設定](get-set-up-for-codeartifact.md))
+ 擁有 CodeArtifact 網域和儲存庫 （請參閱 [開始使用 AWS CLI](getting-started-cli.md))
**發佈一般套件**
1. 使用下列命令，為您要上傳至套件版本的每個檔案產生 SHA256 雜湊，並將 值放在 環境變數中。此值會用作完整性檢查，以確認檔案內容在原始傳送之後並未變更。
------
#### [ 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"
```
------
1. 呼叫 `publish-package-version` 上傳資產並建立新的套件版本。
**注意**
如果您的套件包含多個資產，您可以呼叫`publish-package-version`一次，讓每個資產上傳。包含每個對 呼叫的`--unfinished`引數`publish-package-version`，上傳最終資產時除外。省略 `--unfinished`會將套件版本的狀態設定為 `Published`，並防止其他資產上傳到其中。
或者，`--unfinished`針對每次對 的呼叫包含 `publish-package-version`，然後使用 `Published``update-package-versions-status`命令將套件版本的狀態設定為 。
------
#### [ 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%
```
------
以下將顯示輸出。
```
{
"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"
}
}
}
```
## 列出一般套件資產
若要列出包含在一般套件中的資產，請使用 `list-package-version-assets`命令。如需詳細資訊，請參閱[列出套件版本資產](list-assets.md)。
下列範例列出套件 `1.0.0`版本的資產`my-package`。
**列出套件版本資產**
+ 呼叫 `list-package-version-assets` 以列出包含在一般套件中的資產。
------
#### [ 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
```
------
以下將顯示輸出。
```
{
"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"
}
```
## 下載一般套件資產
若要從一般套件下載資產，請使用 `get-package-version-asset`命令。如需詳細資訊，請參閱[下載套件版本資產](download-assets.md)。
下列範例會將資產`asset.tar.gz`從 套件`1.0.0`的版本下載`my-package`至目前工作目錄，至名為 的檔案`asset.tar.gz`。
**下載套件版本資產**
+ 呼叫 從一般套件`get-package-version-asset`下載資產。
------
#### [ 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
```
------
以下將顯示輸出。
```
{
"assetName": "asset.tar.gz",
"packageVersion": "1.0.0",
"packageVersionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
}
```