Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 「Amazon S3 發佈」動作 YAML 以下是 **Amazon S3 發佈**動作的 YAML 定義。若要了解如何使用此動作，請參閱 [使用工作流程將檔案發佈至 Amazon S3](s3-pub-action.md)。 此動作定義以區段的形式存在於更廣泛的工作流程定義檔案中。如需有關此檔案的詳細資訊，請參閱[工作流程 YAML 定義](workflow-reference.md)。 **注意** 下列大多數 YAML 屬性在視覺化編輯器中都有對應的 UI 元素。若要查詢 UI 元素，請使用 **Ctrl\$1F**。 元素將與其相關聯的 YAML 屬性一起列出。 ``` # The workflow definition starts here. # See 最上層屬性 for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. S3Publish\$1nn: Identifier: aws/s3-publish@v1 DependsOn: - build-action Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: Sources: - source-name-1 Artifacts: - artifact-name Variables: - Name: variable-name-1 Value: variable-value-1 - Name: variable-name-2 Value: variable-value-2 Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: SourcePath: my/source DestinationBucketName: amzn-s3-demo-bucket TargetPath: my/target ``` ## S3Publish (必要) 指定動作的名稱。工作流程中的所有動作名稱都必須是唯一的。動作名稱僅限於英數字元 (a-z、A-Z、0-9)、連字號 (-) 和底線 (\$1)。不允許空格。您無法使用引號在動作名稱中啟用特殊字元和空格。 預設：`S3Publish_nn`。 對應的 UI：組態索引標籤/**動作名稱** ## Identifier (*S3Publish*/**Identifier**) (必要) 識別 動作。除非您想要變更版本，否則請勿變更此屬性。如需詳細資訊，請參閱[指定要使用的動作版本](workflows-action-versions.md)。 預設：`aws/s3-publish@v1`。 對應的 UI：工作流程圖表/S3Publish\$1nn/**aws/s3-publish@v1** 標籤 ## DependsOn (*S3Publish*/**DependsOn**) (選用) 指定必須成功執行的動作、動作群組或閘道，才能執行此動作。 如需 'depends on' 功能的詳細資訊，請參閱 [定序動作](workflows-depends-on.md)。 對應的 UI：輸入索引標籤/**取決於 - 選用** ## Compute (*S3Publish*/**Compute**) (選用) 用來執行工作流程動作的運算引擎。您可以在工作流程層級或動作層級指定運算，但不能同時指定兩者。在工作流程層級指定時，運算組態會套用至工作流程中定義的所有動作。在工作流程層級，您也可以在相同的執行個體上執行多個動作。如需詳細資訊，請參閱[跨動作共用運算](compute-sharing.md)。 對應的 UI：*無* ## Type (*S3Publish*/Compute/**Type**) （如果[Compute](#s3.pub.computename)包含 則為必要） 運算引擎的類型。您可以使用下列其中一個值： + **EC2** （視覺化編輯器） 或 `EC2`(YAML 編輯器） 最佳化動作執行期間的彈性。 + **Lambda** （視覺化編輯器） 或 `Lambda`(YAML 編輯器） 最佳化動作啟動速度。 如需運算類型的更多相關資訊，請參閱[運算類型](workflows-working-compute.md#compute.types)。 對應的 UI：組態索引標籤/**運算類型** ## Fleet (*S3Publish*/Compute/**Fleet**) (選用) 指定將執行工作流程或工作流程動作的機器或機群。使用隨需機群時，當動作開始時，工作流程會佈建所需的資源，並在動作完成時銷毀機器。隨需機群的範例：`Linux.x86-64.Large`、`Linux.x86-64.XLarge`。如需隨需機群的詳細資訊，請參閱[隨需機群屬性](workflows-working-compute.md#compute.on-demand)。 使用佈建機群，您可以設定一組專用機器來執行工作流程動作。這些機器保持閒置狀態，準備好立即處理動作。如需佈建機群的詳細資訊，請參閱 [佈建的機群屬性](workflows-working-compute.md#compute.provisioned-fleets)。 如果省略 `Fleet` ，則預設值為 `Linux.x86-64.Large`。 對應的 UI：組態索引標籤/**運算機群** ## Timeout (*S3Publish*/**Timeout**) (必要) 指定動作在 CodeCatalyst 結束動作之前可執行的時間，以分鐘為單位 (YAML 編輯器） 或小時和分鐘為單位。最小值為 5 分鐘，最大值如 中所述[CodeCatalyst 中工作流程的配額](workflows-quotas.md)。預設逾時與最大逾時相同。 對應的 UI：組態索引標籤/**逾時 - 選用 ** ## Inputs (*S3Publish*/**Inputs**) (選用) `Inputs` 區段定義工作流程執行期間 `S3Publish`所需的資料。 **注意** 每個**AWS CDK 部署**動作最多允許四個輸入 （一個來源和三個成品）。變數不會計入此總計。 如果您需要參考位於不同輸入中的檔案 （例如來源和成品），則來源輸入是主要輸入，而成品是次要輸入。對次要輸入中檔案的參考需要特殊的字首，才能將其從主要輸入中消除。如需詳細資訊，請參閱[範例：參考多個成品中的檔案](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file)。 對應的 UI：**輸入**索引標籤 ## Sources (*S3Publish*/Inputs/**Sources**) （如果您要發佈至 Amazon S3 的檔案存放在來源儲存庫中，則為必要項目） 如果您要發佈至 Amazon S3 的檔案存放在來源儲存庫中，請指定該來源儲存庫的標籤。目前，唯一支援的標籤是 `WorkflowSource`。 如果您想要發佈至 Amazon S3 的檔案不包含在來源儲存庫中，它們必須位於另一個動作所產生的成品中。 如需來源的詳細資訊，請參閱 [將來源儲存庫連線至工作流程](workflows-sources.md)。 對應的 UI：輸入索引標籤/**來源 - 選用** ## Artifacts - input (*S3Publish*/Inputs/**Artifacts**) （如果您要發佈至 Amazon S3 的檔案存放在先前動作的[輸出成品](workflows-working-artifacts-output.md)中，則為必要項目） 如果您想要發佈至 Amazon S3 的檔案包含在先前動作產生的成品中，請在此處指定該成品。如果您的檔案不包含在成品中，它們必須位於您的來源儲存庫中。 如需成品的詳細資訊，包括範例，請參閱 [在動作之間共用成品和檔案](workflows-working-artifacts.md)。 對應的 UI：組態索引標籤/**成品 - 選用** ## Variables - input (*S3Publish*/Inputs/**Variables**) (選用) 指定名稱/值對的序列，以定義您要提供給動作的輸入變數。變數名稱僅限於英數字元 (a-z、A-Z、0-9)、連字號 (-) 和底線 (\$1)。不允許空格。您不能使用引號在變數名稱中啟用特殊字元和空格。 如需變數的詳細資訊，包括範例，請參閱 [在工作流程中使用變數](workflows-working-with-variables.md)。 對應的 UI：輸入索引標籤/**變數 - 選用** ## Environment (*S3Publish*/**Environment**) (必要) 指定要與 動作搭配使用的 CodeCatalyst 環境。動作會連線至所選環境中指定的 AWS 帳戶 和選用 Amazon VPC。動作會使用環境中指定的預設 IAM 角色來連線至 AWS 帳戶，並使用 [Amazon VPC 連線](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html)中指定的 IAM 角色來連線至 Amazon VPC。 **注意** 如果預設 IAM 角色沒有 動作所需的許可，您可以將動作設定為使用不同的角色。如需詳細資訊，請參閱[變更 動作的 IAM 角色](deploy-environments-switch-role.md)。 如需環境的詳細資訊，請參閱 [部署至 AWS 帳戶 和 VPCs](deploy-environments.md)和 [建立環境](deploy-environments-creating-environment.md)。 對應的 UI：組態索引標籤/**環境** ## Name (*S3Publish*/Environment/**Name**) （如果[Environment](#s3.pub.environment)包含 則為必要） 指定您要與動作建立關聯的現有環境名稱。 對應的 UI：組態索引標籤/**環境** ## Connections (*S3Publish*/Environment/**Connections**) （動作的較新版本為選用；較舊版本為必要） 指定要與動作建立關聯的帳戶連線。您可以在 下指定最多一個帳戶連線`Environment`。 如果您未指定帳戶連線： + 動作會使用 CodeCatalyst 主控台中環境指定的 AWS 帳戶 連線和預設 IAM 角色。如需將帳戶連線和預設 IAM 角色新增至環境的相關資訊，請參閱 [建立環境](deploy-environments-creating-environment.md)。 + 預設 IAM 角色必須包含 動作所需的政策和許可。若要判斷這些政策和許可是什麼，請參閱動作 YAML 定義文件中**角色**屬性的描述。 如需帳戶連線的詳細資訊，請參閱 [允許存取已連線 AWS 的資源 AWS 帳戶](ipa-connect-account.md)。如需將帳戶連線新增至環境的相關資訊，請參閱 [建立環境](deploy-environments-creating-environment.md)。 對應的 UI：取決於動作版本，下列其中一項： + （較新版本） 組態tab/Environment/What*我的環境*是什麼？/三個點功能表/**切換角色** + （舊版本） 組態索引標籤/'Environment/account/role'/**AWS account connection** ## Name (*S3Publish*/Environment/Connections/**Name**) （如果[Connections](#s3.pub.environment.connections)包含 則為必要） 指定帳戶連線的名稱。 對應的 UI：取決於動作版本，下列其中一項： + （較新版本） 組態tab/Environment/What是 *my-environment*？/三個點功能表/**切換角色** + （舊版本） 組態索引標籤/'Environment/account/role'/**AWS account connection** ## Role (*S3Publish*/Environment/Connections/**Role**) （如果[Connections](#s3.pub.environment.connections)包含 則為必要） 指定 **Amazon S3 發佈**動作用來存取 AWS 和複製檔案至 Amazon S3 的 IAM 角色名稱。請確定您已[將角色新增至 CodeCatalyst 空間](ipa-connect-account-addroles.md)，且該角色包含下列政策。 如果您未指定 IAM 角色，則動作會使用 CodeCatalyst 主控台中[環境中](deploy-environments.md)列出的預設 IAM 角色。如果您在環境中使用預設角色，請確定其具有下列政策。 + 下列許可政策： **警告** 將許可限制為下列政策中顯示的許可。使用具有更廣泛許可的角色可能會帶來安全風險。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:ListBucket", "s3:DeleteObject" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] } ``` ------ + 下列自訂信任政策： **注意** 如有需要，您可以使用 `CodeCatalystWorkflowDevelopmentRole-spaceName`角色搭配此動作。如需有關此角色的詳細資訊，請參閱 [為您的帳戶和空間建立 **CodeCatalystWorkflowDevelopmentRole-*spaceName***角色](ipa-iam-roles.md#ipa-iam-roles-service-create)。了解該`CodeCatalystWorkflowDevelopmentRole-spaceName`角色具有可能造成安全風險的完整存取許可。我們建議您只在安全性較少的教學課程和案例中使用此角色。 對應的 UI：取決於動作版本，下列其中一項： + （較新版本） 組態tab/Environment/What是 *my-environment*？/三個點功能表/**切換角色** + （舊版本） 組態索引標籤/'Environment/account/role'/**Role** ## Configuration (*S3Publish*/**Configuration**) (必要) 您可以在此區段定義 動作的組態屬性。 對應的 UI：**組態**索引標籤 ## SourcePath (*S3Publish*/Configuration/**SourcePath**) (必要) 指定您要發佈至 Amazon S3 的目錄或檔案的名稱和路徑。目錄或檔案可以位於來源儲存庫或先前動作的成品中，並與來源儲存庫或成品根相關。 範例： 指定 會將 的內容`./myFolder/`複製到 `/myFolder` Amazon S3，並保留基礎目錄結構。 *僅*`myfile.txt`指定`./myFolder/myfile.txt`複本至 Amazon S3。（目錄結構已移除。) 您無法使用萬用字元。 **注意** 您可能需要將字首新增至目錄或檔案路徑，以指出要在其中找到的成品或來源。如需詳細資訊，請參閱[參考來源儲存庫檔案](workflows-sources-reference-files.md)及[參考成品中的檔案](workflows-working-artifacts-refer-files.md)。 對應的 UI：組態索引標籤/**來源路徑** ## DestinationBucketName (*S3Publish*/Configuration/**DestinationBucketName**) (必要) 指定您要發佈檔案的 Amazon S3 儲存貯體名稱。 對應的 UI：組態索引標籤/**目的地儲存貯體 - 選用** ## TargetPath (*S3Publish*/Configuration/**TargetPath**) (選用) 在 Amazon S3 中指定您要發佈檔案的目錄名稱和路徑。如果目錄不存在，則會建立該目錄。目錄路徑不得包含儲存貯體名稱。 範例： `myS3Folder` `./myS3Folder/myS3Subfolder` 對應的 UI：組態索引標籤/**目的地目錄 - 選用**