

Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 在工作流程圖表中顯示應用程式 URL
<a name="deploy-app-url"></a>

如果您的工作流程部署應用程式，您可以設定 Amazon CodeCatalyst，將應用程式的 URL 顯示為可點選的連結。此連結會出現在 CodeCatalyst 主控台的部署動作內。下列工作流程圖表顯示出現在動作底部的**檢視應用程式** URL。

![\[檢視應用程式 URL\]](http://docs.aws.amazon.com/zh_tw/codecatalyst/latest/userguide/images/deploy/view-app-url.png)


透過在 CodeCatalyst 主控台中啟用此 URL，您可以快速驗證應用程式部署。

**注意**  
**部署至 Amazon ECS **動作不支援應用程式 URL。

若要啟用此功能，請使用包含 `appurl`或 的名稱，將輸出變數新增至您的動作`endpointurl`。您可以使用有或沒有聯結破折號 (`-`)、底線 (`_`) 或空格 () 的名稱` `。字串不區分大小寫。將變數的值設定為已部署應用程式的 `http`或 `https` URL。

**注意**  
如果您要更新現有的輸出變數以包含 `app url`或 `endpoint url`字串，請更新此變數的所有參考，以使用新的變數名稱。

如需詳細步驟，請參閱下列其中一個程序：
+ [在「AWS CDK 部署」動作中顯示應用程式 URL](#deploy-app-url-cdk)
+ [在「部署 CloudFormation 堆疊」動作中顯示應用程式 URL](#deploy-app-url-cfn)
+ [在所有其他動作中顯示應用程式 URL](#deploy-app-url-other)

當您完成設定 URL 後，請依照下列指示確認 URL 是否如預期顯示：
+ [驗證已新增應用程式 URL](#deploy-app-url-verify)<a name="deploy-app-url-cdk"></a>

**在「AWS CDK 部署」動作中顯示應用程式 URL**

1. 如果您使用的是**AWS CDK 部署**動作，請在 AWS CDK 應用程式程式碼中新增建構 `CfnOutput` （即索引鍵/值對）：
   + 索引鍵名稱必須包含 `appurl`、 或 `endpointurl`，包含或不包含聯結破折號 (`-`)、底線 (`_`) 或空格 ()` `。字串不區分大小寫。
   + 值必須是已部署應用程式的 `http`或 `https` URL。

   例如，您的 AWS CDK 程式碼可能如下所示：

   ```
   import { Duration, Stack, StackProps, CfnOutput, RemovalPolicy} from 'aws-cdk-lib';
   import * as dynamodb from 'aws-cdk-lib/aws-dynamodb';
   import * as s3 from 'aws-cdk-lib/aws-s3';
   import { Construct } from 'constructs';
   import * as cdk from 'aws-cdk-lib';
   export class HelloCdkStack extends Stack {
     constructor(scope: Construct, id: string, props?: StackProps) {
       super(scope, id, props);
       const bucket = new s3.Bucket(this, 'amzn-s3-demo-bucket', {
         removalPolicy: RemovalPolicy.DESTROY,
       });
       new CfnOutput(this, 'APP-URL', {
         value: https://mycompany.myapp.com,
         description: 'The URL of the deployed application',
         exportName: 'myApp',
       });
       ...
     }
   }
   ```

   如需建構模組的詳細資訊，請參閱 API `CfnOutput` 參考中的[界面 CfnOutputProps](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.CfnOutputProps.html)。 *AWS Cloud Development Kit (AWS CDK) *

1. 儲存並遞交您的程式碼。

1. 繼續執行「[驗證已新增應用程式 URL](#deploy-app-url-verify)」。<a name="deploy-app-url-cfn"></a>

**在「部署 CloudFormation 堆疊」動作中顯示應用程式 URL**

1. 如果您使用的是**部署 CloudFormation 堆疊**動作，請將輸出新增至 CloudFormation 範本或 AWS SAM 範本中具有下列特性的 `Outputs`區段：
   + 金鑰 （也稱為邏輯 ID) 必須包含 `appurl`、 或 `endpointurl`，包含或不包含聯結破折號 (`-`)、底線 (`_`) 或空格 ()` `。字串不區分大小寫。
   + 值必須是已部署應用程式的 `http`或 `https` URL。

   例如，您的 CloudFormation 範本可能如下所示：

   ```
   "Outputs" : {
     "APP-URL" : {
       "Description" : "The URL of the deployed app",
       "Value" : "https://mycompany.myapp.com",
       "Export" : {
         "Name" : "My App"
       }
     }
   }
   ```

   如需 CloudFormation 輸出的詳細資訊，請參閱*AWS CloudFormation *[《 使用者指南》中的輸出](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html)。

1. 儲存並遞交您的程式碼。

1. 繼續執行「[驗證已新增應用程式 URL](#deploy-app-url-verify)」。<a name="deploy-app-url-other"></a>

**在所有其他動作中顯示應用程式 URL**

如果您使用另一個動作來部署應用程式，例如建置動作或 **GitHub 動作**，請執行下列動作以顯示應用程式 URL。

1. 在工作流程定義檔案中 動作的 `Inputs`或 `Steps`區段中定義環境變數。變數必須具有下列特性：
   + `name` 必須包含 `appurl`、 或 `endpointurl`，包含或不包含聯結破折號 (`-`)、底線 (`_`) 或空格 ()` `。字串不區分大小寫。
   + 值必須是已部署應用程式的 `http`或 `https` URL。

   例如，建置動作可能如下所示：

   ```
   Build-action:
     Identifier: aws/build@v1
     Inputs:
       Variables:
         - Name: APP-URL
           Value: https://mycompany.myapp.com
   ```

   ...或此項目：

   ```
   Actions:
     Build:
       Identifier: aws/build@v1
       Configuration:    
         Steps:
           - Run: APP-URL=https://mycompany.myapp.com
   ```

   如需定義環境變數的詳細資訊，請參閱 [定義變數](workflows-working-with-variables-define-input.md)。

1. 匯出 變數。

   例如，您的建置動作可能如下所示：

   ```
   Build-action:
     ...
     Outputs:
       Variables:
         - APP-URL
   ```

   如需匯出變數的詳細資訊，請參閱 [匯出變數，讓其他動作可以使用它](workflows-working-with-variables-export-input.md)。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。

1. 繼續執行「[驗證已新增應用程式 URL](#deploy-app-url-verify)」。<a name="deploy-app-url-verify"></a>

**驗證已新增應用程式 URL**
+ 如果工作流程尚未自動啟動，請啟動工作流程執行。新執行應該在其工作流程圖表中將應用程式 URL 顯示為可點選連結。如需啟動執行的詳細資訊，請參閱 [手動啟動工作流程執行](workflows-manually-start.md)。