必要條件步驟 1：初始化 Hello World 應用程式範例步驟 2：建置您的應用程式步驟 3：將應用程式部署到 AWS 雲端步驟 4：執行您的應用程式步驟 5：與中的函數互動 AWS 雲端步驟 6：修改應用程式並將其同步至 AWS 雲端步驟 7：（選用）在本機測試您的應用程式步驟 8：從刪除您的應用程式 AWS 雲端故障診斷進一步了解

教學課程：使用部署 Hello World 應用程式 AWS SAM

在本教學課程中，您可以使用 AWS Serverless Application Model 命令列介面（AWS SAM CLI）以完成下列操作：

初始化、建置和部署 Hello World 應用程式範例。
進行本機變更並同步至 AWS CloudFormation。
在開發主機上執行本機測試。
從刪除範例應用程式 AWS 雲端。

範例 Hello World 應用程式會實作基本API後端。它由下列資源組成：

Amazon API Gateway – 用來叫用函數的API端點。
AWS Lambda – 處理HTTPAPIGET請求並傳回hello world訊息的函數。
AWS Identity and Access Management （IAM）角色 – 為服務提供安全互動的許可。

下圖顯示此應用程式的組件：

必要條件

確認您已完成下列操作：

步驟 1：初始化 Hello World 應用程式範例

在此步驟中，您將使用 AWS SAM CLI 在本機機器上建立 Hello World 應用程式專案範例。

初始化 Hello World 應用程式範例

在命令列中，從您選擇的起始目錄中執行下列項目：
```
$ sam init
```
注意
此命令會初始化您的無伺服器應用程式，建立您的專案目錄。此目錄將包含數個檔案和資料夾。最重要的檔案是 template.yaml。這是您的 AWS SAM 範本。您的 python 版本必須符合 sam init命令建立的template.yaml檔案中列出的 python 版本。

的 AWS SAM CLI 將引導您初始化新的應用程式。設定下列項目：

選取AWS 快速啟動範本以選擇啟動範本。
選擇 Hello World 範例範本並下載。
使用 Python 執行期和zip套件類型。
在此教學課程中，選擇不 AWS X-Ray 追蹤。若要進一步了解，請參閱開發人員指南中的什麼是 AWS X-Ray？。 AWS X-Ray
在此教學課程中，選擇不使用 Amazon CloudWatch Application Insights 進行監控。若要進一步了解，請參閱 Amazon 使用者指南中的 Amazon CloudWatch Application Insights。 CloudWatch
在此教學課程中，選擇不在您的 Lambda 函數上設定JSON格式的結構化日誌記錄。
將應用程式命名為 sam-app 。

若要使用 AWS SAM CLI 互動式流程：

括號（[ ]）表示預設值。將答案保留空白以選取預設值。
針對y是輸入 ，針對否 n輸入。

以下是sam init互動式流程的範例：


$ sam init
...
Which template source would you like to use?
    1 - AWS Quick Start Templates
    2 - Custom Template Location
Choice: 1

Choose an AWS Quick Start application template
    1 - Hello World Example
    2 - Multi-step workflow
    3 - Serverless API
    4 - Scheduled task
    5 - Standalone function
    6 - Data processing
    7 - Hello World Example With Powertools
    8 - Infrastructure event management
    9 - Serverless Connector Hello World Example
    10 - Multi-step workflow with Connectors
    11 - Lambda EFS example
    12 - DynamoDB Example
    13 - Machine Learning
Template: 1

Use the most popular runtime and package type? (Python and zip) [y/N]: y

Would you like to enable X-Ray tracing on the function(s) in your application?  [y/N]: ENTER

Would you like to enable monitoring using CloudWatch Application Insights?
For more info, please view https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html [y/N]: ENTER
					
Would you like to set Structured Logging in JSON format on your Lambda functions?  [y/N]: ENTER

Project name [sam-app]: ENTER

的 AWS SAM CLI 會下載您的啟動範本，並在本機機器上建立應用程式專案目錄結構。以下是的範例 AWS SAM CLI 輸出：

Cloning from https://github.com/aws/aws-sam-cli-app-templates (process may take a moment)

    -----------------------
    Generating application:
    -----------------------
    Name: sam-app
    Runtime: python3.9
    Architectures: x86_64
    Dependency Manager: pip
    Application Template: hello-world
    Output Directory: .
    Configuration file: sam-app/samconfig.toml

    Next steps can be found in the README file at sam-app/README.md


Commands you can use next
=========================
[*] Create pipeline: cd sam-app && sam pipeline init --bootstrap
[*] Validate SAM template: cd sam-app && sam validate
[*] Test Function in the Cloud: cd sam-app && sam sync --stack-name {stack-name} --watch

從命令列中，移至新建立的sam-app目錄。以下是的範例 AWS SAM CLI 已建立：


$ cd sam-app

$ tree

├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
    ├── __init__.py
    ├── integration
    │   ├── __init__.py
    │   └── test_api_gateway.py
    ├── requirements.txt
    └── unit
        ├── __init__.py
        └── test_handler.py
        
6 directories, 14 files

要強調的一些重要檔案：

hello_world/app.py – 包含您的 Lambda 函數程式碼。
hello_world/requirements.txt – 包含任何 Python Lambda 函數所需的相依性。
samconfig.toml – 存放使用之預設參數的應用程式組態檔案 AWS SAM CLI.
template.yaml – 包含應用程式基礎設施程式碼的 AWS SAM 範本。

您現在在本機機器上擁有完全撰寫的無伺服器應用程式！

步驟 2：建置您的應用程式

在此步驟中，您可以使用 AWS SAM CLI 建置您的應用程式並準備部署。當您建置時， AWS SAM CLI 會建立.aws-sam目錄，並在其中組織函數相依性、專案程式碼和專案檔案。

建置您的應用程式

在命令列中，從sam-app專案目錄執行下列動作：


$ sam build

注意

如果您沒有 Python 在本機電腦上，改用 sam build --use-container 命令。的 AWS SAM CLI 將建立 Docker 包含函數執行期和相依性的容器。此命令需要 Docker 在本機機器上。安裝 Docker，請參閱安裝 Docker。

以下是的範例 AWS SAM CLI 輸出：


$ sam build
Starting Build use cache
Manifest file is changed (new hash: 3298f1304...d4d421) or dependency folder (.aws-sam/deps/4d3dfad6-a267-47a6-a6cd-e07d6fae318c) is missing for (HelloWorldFunction), downloading dependencies and copying/building source
Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction
Running PythonPipBuilder:CleanUp
Running PythonPipBuilder:ResolveDependencies
Running PythonPipBuilder:CopySource
Running PythonPipBuilder:CopySource

Build Succeeded

Built Artifacts  : .aws-sam/build
Built Template   : .aws-sam/build/template.yaml

Commands you can use next
=========================
[*] Validate SAM template: sam validate
[*] Invoke Function: sam local invoke
[*] Test Function in the Cloud: sam sync --stack-name {{stack-name}} --watch
[*] Deploy: sam deploy --guided

以下是所 AWS SAM 建立.aws-sam目錄的縮短範例CLI：

.aws-sam
├── build
│   ├── HelloWorldFunction
│   │   ├── __init__.py
│   │   ├── app.py
│   │   └── requirements.txt
│   └── template.yaml
└── build.toml

要強調的一些重要檔案：

build/HelloWorldFunction – 包含您的 Lambda 函數程式碼和相依性。 AWS SAM CLI 會為應用程式中的每個函數建立目錄。
build/template.yaml – 包含部署 AWS CloudFormation 時由參考的 AWS SAM 範本複本。
build.toml – 儲存參考的預設參數值的組態檔案 AWS SAM CLI 建置和部署應用程式時。

您現在可以將應用程式部署到 AWS 雲端。

步驟 3：將應用程式部署到 AWS 雲端

注意

此步驟需要 AWS 憑證組態。如需詳細資訊，請參閱 AWS SAM 先決條件中的步驟 5：使用 AWS CLI 設定 AWS 憑證。

在此步驟中，您可以使用 AWS SAM CLI 將應用程式部署到 AWS 雲端。的 AWS SAM CLI 將執行下列動作：

引導您完成設定應用程式設定以進行部署。
將應用程式檔案上傳至 Amazon Simple Storage Service （Amazon S3）。
將 AWS SAM 範本轉換為 AWS CloudFormation 範本。然後，它會將您的範本上傳至 AWS CloudFormation 服務，以佈建您的 AWS 資源。

部署您的應用程式

在命令列中，從sam-app專案目錄執行下列動作：
```
$ sam deploy --guided
```
遵循 AWS SAM CLI 互動式流程來設定您的應用程式設定。設定下列項目：
1. AWS CloudFormation 堆疊名稱 – 堆疊是您可以作為單一單位管理的一組 AWS 資源。若要進一步了解，請參閱 AWS CloudFormation 使用者指南 中的使用堆疊。
2. AWS 區域 要部署 AWS CloudFormation 堆疊的。如需詳細資訊，請參閱 AWS CloudFormation 使用者指南 中的AWS CloudFormation 端點。
3. 對於本教學課程，選擇在部署之前不確認變更。
4. 允許IAM角色建立 – 如此可讓 AWS SAM 建立API閘道資源和 Lambda 函數資源互動所需的IAM角色。
5. 在此教學課程中，選擇不停用回復 。
6. 允許 HelloWorldFunction ，但未定義授權 – 顯示此訊息，因為閘道API端點已設定為可公開存取，無需授權。由於這是 Hello World 應用程式的預期組態，請允許 AWS SAM CLI 以繼續。如需設定授權的詳細資訊，請參閱使用 AWS SAM 範本控制API存取。
7. 將引數儲存至組態檔案 – 這會使用部署偏好設定更新應用程式的samconfig.toml檔案。
8. 選取預設組態檔案名稱 。
9. 選取預設組態環境 。
以下是sam deploy --guided互動式流程的範例輸出：
```
$ sam-app sam deploy --guided

Configuring SAM deploy
======================

    Looking for config file [samconfig.toml] :  Found
    Reading default arguments  :  Success

    Setting default arguments for 'sam deploy'
    =========================================
    Stack Name [sam-app]: ENTER
    AWS Region [us-west-2]: ENTER
    #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
    Confirm changes before deploy [Y/n]: n
    #SAM needs permission to be able to create roles to connect to the resources in your template
    Allow SAM CLI IAM role creation [Y/n]: ENTER
    #Preserves the state of previously provisioned resources when an operation fails
    Disable rollback [y/N]: ENTER
    HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
    Save arguments to configuration file [Y/n]: ENTER
    SAM configuration file [samconfig.toml]: ENTER
    SAM configuration environment [default]: ENTER
```

的 AWS SAM CLI 透過執行下列動作來部署您的應用程式：

的 AWS SAM CLI 會建立 Amazon S3 儲存貯體並上傳您的.aws-sam目錄。
的 AWS SAM CLI 會將您的 AWS SAM 範本轉換為， AWS CloudFormation 並將其上傳至 AWS CloudFormation 服務。
AWS CloudFormation 佈建您的資源。

在部署期間， AWS SAM CLI 會顯示您的進度。以下是輸出範例：

Looking for resources needed for deployment:

    Managed S3 bucket: aws-sam-cli-managed-default-samcliamzn-s3-demo-source-bucket-1a4x26zbcdkqr
    A different default S3 bucket can be set in samconfig.toml

    Parameter "stack_name=sam-app" in [default.deploy.parameters] is defined as a global parameter [default.global.parameters].
    This parameter will be only saved under [default.global.parameters] in /Users/.../Demo/sam-tutorial1/sam-app/samconfig.toml.

    Saved arguments to config file
    Running 'sam deploy' for future deployments will use the parameters saved above.
    The above parameters can be changed by modifying samconfig.toml
    Learn more about samconfig.toml syntax at
    https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/serverless-sam-cli-config.html

File with same data already exists at sam-app/da3c598813f1c2151579b73ad788cac8, skipping upload

    Deploying with following values
    ===============================
    Stack name                   : sam-app
    Region                       : us-west-2
    Confirm changeset            : False
    Disable rollback             : False
    Deployment s3 bucket         : aws-sam-cli-managed-default-samcliamzn-s3-demo-source-bucket-1a4x26zbcdkqr
    Capabilities                 : ["CAPABILITY_IAM"]
    Parameter overrides          : {}
    Signing Profiles             : {}

Initiating deployment
=====================

File with same data already exists at sam-app/2bebf67c79f6a743cc5312f6dfc1efee.template, skipping upload


Waiting for changeset to be created..

CloudFormation stack changeset
---------------------------------------------------------------------------------------------------------------------------------------------
Operation                           LogicalResourceId                   ResourceType                        Replacement
---------------------------------------------------------------------------------------------------------------------------------------------
* Modify                            HelloWorldFunction                  AWS::Lambda::Function               False
* Modify                            ServerlessRestApi                   AWS::ApiGateway::RestApi            False
- Delete                            AwsSamAutoDependencyLayerNestedSt   AWS::CloudFormation::Stack          N/A
                                    ack
---------------------------------------------------------------------------------------------------------------------------------------------


Changeset created successfully. arn:aws:cloudformation:us-west-2:012345678910:changeSet/samcli-deploy1678917603/22e05525-08f9-4c52-a2c4-f7f1fd055072


2023-03-15 12:00:16 - Waiting for stack create/update to complete

CloudFormation events from stack operations (refresh every 0.5 seconds)
---------------------------------------------------------------------------------------------------------------------------------------------
ResourceStatus                      ResourceType                        LogicalResourceId                   ResourceStatusReason
---------------------------------------------------------------------------------------------------------------------------------------------
UPDATE_IN_PROGRESS                  AWS::Lambda::Function               HelloWorldFunction                  -
UPDATE_COMPLETE                     AWS::Lambda::Function               HelloWorldFunction                  -
UPDATE_COMPLETE_CLEANUP_IN_PROGRE   AWS::CloudFormation::Stack          sam-app                             -
SS
DELETE_IN_PROGRESS                  AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                        ack
DELETE_COMPLETE                     AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                        ack
UPDATE_COMPLETE                     AWS::CloudFormation::Stack          sam-app                             -
---------------------------------------------------------------------------------------------------------------------------------------------

CloudFormation outputs from deployed stack
----------------------------------------------------------------------------------------------------------------------------------------------
Outputs
----------------------------------------------------------------------------------------------------------------------------------------------
Key                 HelloWorldFunctionIamRole
Description         Implicit IAM Role created for Hello World function
Value               arn:aws:iam::012345678910:role/sam-app-HelloWorldFunctionRole-15GLOUR9LMT1W

Key                 HelloWorldApi
Description         API Gateway endpoint URL for Prod stage for Hello World function
Value               https://<restapiid>.execute-api.us-west-2.amazonaws.com/Prod/hello/

Key                 HelloWorldFunction
Description         Hello World Lambda Function ARN
Value               arn:aws:lambda:us-west-2:012345678910:function:sam-app-HelloWorldFunction-yQDNe17r9maD
----------------------------------------------------------------------------------------------------------------------------------------------


Successfully created/updated stack - sam-app in us-west-2

您的應用程式現在已部署並在中執行 AWS 雲端！

步驟 4：執行您的應用程式

在此步驟中，您將傳送GET請求至API端點，並查看 Lambda 函數輸出。

若要取得您的API端點值

從顯示的資訊 AWS SAM CLI 在上一個步驟中，找到 Outputs區段。在本節中，找到您的HelloWorldApi資源以尋找HTTP端點值。以下是輸出範例：

----------------------------------------------------------------------------------------------------------------------------------------------
Outputs
----------------------------------------------------------------------------------------------------------------------------------------------
...
Key                 HelloWorldApi
Description         API Gateway endpoint URL for Prod stage for Hello World function
Value               https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/
...
----------------------------------------------------------------------------------------------------------------------------------------------

或者，您可以使用 sam list endpoints --output json命令來取得此資訊。以下是輸出範例：


$ sam list endpoints --output json
2023-03-15 12:39:19 Loading policies from IAM...
2023-03-15 12:39:25 Finished loading policies from IAM.
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-HelloWorldFunction-yQDNe17r9maD",
    "CloudEndpoint": "-",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "ets1gv8lxi",
    "CloudEndpoint": [
      "https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod",
      "https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]

叫用函數

使用瀏覽器或命令列，將GET請求傳送至API端點。以下是使用 curl 命令的範例：


$ curl https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/
{"message": "hello world"}

步驟 5：與中的函數互動 AWS 雲端

在此步驟中，您可以使用 AWS SAM CLI 在中調用 Lambda 函數 AWS 雲端。

在雲端中叫用 Lambda 函數

記下上LogicalResourceId一個步驟的函數。它應該是 HelloWorldFunction。

在命令列中，從sam-app專案目錄執行下列動作：


$ sam remote invoke HelloWorldFunction --stack-name sam-app

的 AWS SAM CLI 在雲端中調用您的函數並傳回回應。以下是輸出範例：


$ sam remote invoke HelloWorldFunction --stack-name sam-app

Invoking Lambda Function HelloWorldFunction                                       
START RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9 Version: $LATEST
END RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9
REPORT RequestId: d5ef494b-5f45-4086-86fd-d7322fa1a1f9  Duration: 6.62 ms       Billed Duration: 7 ms     Memory Size: 128 MB     Max Memory Used: 67 MB  Init Duration: 164.06 ms
{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%

步驟 6：修改應用程式並將其同步至 AWS 雲端

在此步驟中，您可以使用 AWS SAM CLI sam sync --watch 命令將本機變更同步至 AWS 雲端。

使用 sam 同步

在命令列中，從sam-app專案目錄執行下列動作：
```
$ sam sync --watch
```

的 AWS SAM CLI 會提示您確認正在同步開發堆疊。由於 sam sync --watch命令會自動 AWS 雲端即時將本機變更部署至，因此我們建議僅用於開發環境。

的 AWS SAM CLI 會在開始監控本機變更之前執行初始部署。以下是輸出範例：


$ sam sync --watch
The SAM CLI will use the AWS Lambda, Amazon API Gateway, and AWS StepFunctions APIs to upload your code without
performing a CloudFormation deployment. This will cause drift in your CloudFormation stack.
**The sync command should only be used against a development stack**.

Confirm that you are synchronizing a development stack.

Enter Y to proceed with the command, or enter N to cancel:
 [Y/n]: y
Queued infra sync. Waiting for in progress code syncs to complete...
Starting infra sync.
Manifest is not changed for (HelloWorldFunction), running incremental build
Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction
Running PythonPipBuilder:CopySource

Build Succeeded

Successfully packaged artifacts and wrote output template to file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpq3x9vh63.
Execute the following command to deploy the packaged template
sam deploy --template-file /var/folders/45/5ct135bx3fn2551_ptl5g6_80000gr/T/tmpq3x9vh63 --stack-name <YOUR STACK NAME>


    Deploying with following values
    ===============================
    Stack name                   : sam-app
    Region                       : us-west-2
    Disable rollback             : False
    Deployment s3 bucket         : aws-sam-cli-managed-default-samcliamzn-s3-demo-source-bucket-1a4x26zbcdkqr
    Capabilities                 : ["CAPABILITY_NAMED_IAM", "CAPABILITY_AUTO_EXPAND"]
    Parameter overrides          : {}
    Signing Profiles             : null

Initiating deployment
=====================


2023-03-15 13:10:05 - Waiting for stack create/update to complete

CloudFormation events from stack operations (refresh every 0.5 seconds)
---------------------------------------------------------------------------------------------------------------------------------------------
ResourceStatus                      ResourceType                        LogicalResourceId                   ResourceStatusReason
---------------------------------------------------------------------------------------------------------------------------------------------
UPDATE_IN_PROGRESS                  AWS::CloudFormation::Stack          sam-app                             Transformation succeeded
CREATE_IN_PROGRESS                  AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                        ack
CREATE_IN_PROGRESS                  AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   Resource creation Initiated
                                                                        ack
CREATE_COMPLETE                     AWS::CloudFormation::Stack          AwsSamAutoDependencyLayerNestedSt   -
                                                                        ack
UPDATE_IN_PROGRESS                  AWS::Lambda::Function               HelloWorldFunction                  -
UPDATE_COMPLETE                     AWS::Lambda::Function               HelloWorldFunction                  -
UPDATE_COMPLETE_CLEANUP_IN_PROGRE   AWS::CloudFormation::Stack          sam-app                             -
SS
UPDATE_COMPLETE                     AWS::CloudFormation::Stack          sam-app                             -
---------------------------------------------------------------------------------------------------------------------------------------------

CloudFormation outputs from deployed stack
----------------------------------------------------------------------------------------------------------------------------------------------
Outputs
----------------------------------------------------------------------------------------------------------------------------------------------
Key                 HelloWorldFunctionIamRole
Description         Implicit IAM Role created for Hello World function
Value               arn:aws:iam::012345678910:role/sam-app-HelloWorldFunctionRole-15GLOUR9LMT1W

Key                 HelloWorldApi
Description         API Gateway endpoint URL for Prod stage for Hello World function
Value               https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/

Key                 HelloWorldFunction
Description         Hello World Lambda Function ARN
Value               arn:aws:lambda:us-west-2:012345678910:function:sam-app-HelloWorldFunction-yQDNe17r9maD
----------------------------------------------------------------------------------------------------------------------------------------------


Stack update succeeded. Sync infra completed.

Infra sync completed.
CodeTrigger not created as CodeUri or DefinitionUri is missing for ServerlessRestApi.

接下來，您將修改 Lambda 函數程式碼。的 AWS SAM CLI 會自動偵測此變更，並將您的應用程式同步至 AWS 雲端。

若要修改和同步您的應用程式

在IDE您選擇的中，開啟 sam-app/hello_world/app.py 檔案。

變更 message並儲存您的檔案。以下是範例：


import json
...
def lambda_handler(event, context):
    ...
    return {
        "statusCode": 200,
        "body": json.dumps({
            "message": "hello everyone!",
            ...
        }),
    }

的 AWS SAM CLI 會偵測您的變更，並將您的應用程式同步至 AWS 雲端。以下是輸出範例：

Syncing Lambda Function HelloWorldFunction...
Manifest is not changed for (HelloWorldFunction), running incremental build
Building codeuri: /Users/.../Demo/sam-tutorial1/sam-app/hello_world runtime: python3.9 metadata: {} architecture: x86_64 functions: HelloWorldFunction
Running PythonPipBuilder:CopySource
Finished syncing Lambda Function HelloWorldFunction.

若要驗證變更，請再次將GET請求傳送至您的API端點。


$ curl https://ets1gv8lxi.execute-api.us-west-2.amazonaws.com/Prod/hello/
{"message": "hello everyone!"}

步驟 7：（選用）在本機測試您的應用程式

注意

此步驟是選用的，因為它需要 Docker 在本機機器上。

重要

若要使用 AWS SAM CLI 針對本機測試，您必須具有 Docker 已安裝和設定。如需詳細資訊，請參閱安裝 Docker。

在此步驟中，您可以使用 AWS SAM CLI sam local 命令在本機測試您的應用程式。為了達成此目標， AWS SAM CLI 會使用建立本機環境 Docker。此本機環境模擬 Lambda 函數的雲端型執行環境。

您可執行下列項目：

為您的 Lambda 函數建立本機環境並叫用它。
在本機託管您的HTTPAPI端點，並使用它來調用 Lambda 函數。

在本機叫用 Lambda 函數

在命令列中，從sam-app專案目錄執行下列動作：
```
$ sam local invoke
```

的 AWS SAM CLI 會建立本機 Docker 容器並調用您的函數。以下是輸出範例：


$ sam local invoke
Invoking app.lambda_handler (python3.9)
Local image was not found.
Removing rapid images for repo public.ecr.aws/sam/emulation-python3.9
Building image.....................
Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64.

Mounting /Users/.../Demo/sam-tutorial1/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated inside runtime container
START RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6 Version: $LATEST
END RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6
REPORT RequestId: b046db01-2a00-415d-af97-35f3a02e9eb6    Init Duration: 1.01 ms    Duration: 633.45 ms    Billed Duration: 634 ms    Memory Size: 128 MB    Max Memory Used: 128 MB
{"statusCode": 200, "body": "{\"message\": \"hello world\"}"}

託管您的API本機

在命令列中，從sam-app專案目錄執行下列動作：
```
$ sam local start-api
```

的 AWS SAM CLI 會建立本機 Docker Lambda 函數的容器，並建立本機HTTP伺服器來模擬您的API端點。以下是輸出範例：


$ sam local start-api
Initializing the lambda functions containers.
Local image is up-to-date
Using local image: public.ecr.aws/lambda/python:3.9-rapid-x86_64.

Mounting /Users/.../Demo/sam-tutorial1/sam-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated inside runtime container
Containers Initialization is done.
Mounting HelloWorldFunction at http://127.0.0.1:3000/hello [GET]
You can now browse to the above endpoints to invoke your functions. You do not need to restart/reload SAM CLI while working on your functions, changes will be reflected instantly/automatically. If you used sam build before running local commands, you will need to re-run sam build for the changes to be picked up. You only need to restart SAM CLI if you update your AWS SAM template
2023-03-15 14:25:21 WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:3000
2023-03-15 14:25:21 Press CTRL+C to quit

使用瀏覽器或命令列，將GET請求傳送至本機API端點。以下是使用 curl 命令的範例：
```
$ curl http://127.0.0.1:3000/hello
{"message": "hello world"}
```

步驟 8：從刪除您的應用程式 AWS 雲端

在此步驟中，您可以使用 AWS SAM CLI sam delete 命令從刪除您的應用程式 AWS 雲端。

從中刪除您的應用程式 AWS 雲端

在命令列中，從sam-app專案目錄執行下列動作：
```
$ sam delete
```

的 AWS SAM CLI 會要求您確認。然後，它會刪除應用程式的 Amazon S3 儲存貯體和 AWS CloudFormation 堆疊。以下是輸出範例：


$ sam delete
    Are you sure you want to delete the stack sam-app in the region us-west-2 ? [y/N]: y
    Are you sure you want to delete the folder sam-app in S3 which contains the artifacts? [y/N]: y
    - Deleting S3 object with key c6ce8fa8b5a97dd022ecd006536eb5a4
    - Deleting S3 object with key 5d513a459d062d644f3b7dd0c8b56a2a.template
    - Deleting S3 object with key sam-app/2bebf67c79f6a743cc5312f6dfc1efee.template
    - Deleting S3 object with key sam-app/6b208d0e42ad15d1cee77d967834784b.template
    - Deleting S3 object with key sam-app/da3c598813f1c2151579b73ad788cac8
    - Deleting S3 object with key sam-app/f798cdd93cee188a71d120f14a035b11
    - Deleting Cloudformation stack sam-app

Deleted successfully

故障診斷

若要對 AWS SAM CLI，請參閱AWS SAMCLI疑難排。

進一步了解

若要繼續了解 AWS SAM，請參閱下列資源：

完整 AWS SAM 研討會 – 旨在教導您許多主要 AWS SAM 功能的研討會。
使用的工作階段 SAM – 由我們的 AWS Serverless Developer Advocate 團隊使用建立的影片系列 AWS SAM。
Serverless Land – 將最新的無伺服器資訊、部落格、影片、程式碼和學習資源 AWS 集合在一起的網站。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

可選：驗證 AWS SAM CLI Installer (安裝程式)

如何使用 AWS SAM

教學課程：使用 部署 Hello World 應用程式 AWS SAM

主題