這是 AWS CDK v2 開發人員指南。較舊的 CDK v1 已於 2022 年 6 月 1 日進入維護，並於 2023 年 6 月 1 日結束支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `cdk publish-assets`
<a name="ref-cli-cmd-publish-assets"></a>

**重要**  
`cdk publish-assets` 命令正在開發 AWS CDK。此命令的目前功能可能會有所變更。因此，您必須提供使用此命令`--unstable=publish-assets`的選項來選擇加入。

將指定 AWS Cloud Development Kit (AWS CDK) 堆疊的 Docker 映像和檔案資產等資產發佈至各自的目的地，例如 Amazon Elastic Container Registry (Amazon ECR) 儲存庫和 Amazon Simple Storage Service (Amazon S3) 儲存貯體，而無需執行部署。

此命令在您要將資產發佈階段與部署階段分開的 CI/CD 管道中很有用。透過獨立發佈資產，您可以在開始部署程序之前驗證所有資產是否已建置並可用。

## Usage
<a name="ref-cli-cmd-publish-assets-usage"></a>

```
$ cdk publish-assets <arguments> <options>
```

## 引數
<a name="ref-cli-cmd-publish-assets-args"></a><a name="ref-cli-cmd-publish-assets-args-stack-name"></a>

 **CDK 堆疊 ID**   
要發佈資產之應用程式中 CDK 堆疊的建構 ID。  
 *類型：*字串  
 *必要*：否

## 選項
<a name="ref-cli-cmd-publish-assets-options"></a>

如需適用於所有 CDK CLI 命令的全域選項清單，請參閱[全域選項](ref-cli-cmd.md#ref-cli-cmd-options)。<a name="ref-cli-cmd-publish-assets-options-all"></a>

 `--all <BOOLEAN>`   
發佈 CDK 應用程式中所有堆疊的資產。  
 *預設值*：`false`<a name="ref-cli-cmd-publish-assets-options-concurrency"></a>

 `--concurrency <NUMBER>`   
指定要同時執行的資產發佈操作數目上限。  
 *預設值*：`4`<a name="ref-cli-cmd-publish-assets-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
僅發佈所請求堆疊的資產，不包含相依性。<a name="ref-cli-cmd-publish-assets-options-force"></a>

 `--force <BOOLEAN>`   
重新發佈所有資產，即使它們已存在於目的地。  
 *預設值*：`false`<a name="ref-cli-cmd-publish-assets-options-help"></a>

 `--help, -h <BOOLEAN>`   
顯示命令的`cdk publish-assets`命令參考資訊。

## 範例
<a name="ref-cli-cmd-publish-assets-examples"></a>

### 發佈特定堆疊的資產
<a name="ref-cli-cmd-publish-assets-examples-1"></a>

```
$ cdk publish-assets MyStack --unstable=publish-assets
```

### 發佈所有堆疊的資產
<a name="ref-cli-cmd-publish-assets-examples-2"></a>

```
$ cdk publish-assets --all --unstable=publish-assets
```

### 強制重新發佈已存在的資產
<a name="ref-cli-cmd-publish-assets-examples-3"></a>

```
$ cdk publish-assets MyStack --unstable=publish-assets --force
```

### 發佈資產，然後分別部署
<a name="ref-cli-cmd-publish-assets-examples-4"></a>

首先，發佈堆疊的資產：

```
$ cdk publish-assets MyStack --unstable=publish-assets
```

然後，部署堆疊：

```
$ cdk deploy MyStack
```