教程：在 AWS CodeStar 中创建和管理无服务器项目

1. 登录 AWS Management Console，然后通过以下网址打开 AWS CodeStar 控制台：https://console.aws.amazon.com/codestar/。

   注意

   您必须使用与在 设置 AWS CodeStar 中创建或标识的 IAM 用户关联的凭证登录 AWS Management Console。此用户必须附加了 AWSCodeStarFullAccess 托管策略。

2. 选择要在其中创建项目及其资源的 AWS 区域。

   有关 AWS CodeStar 在其中可用的 AWS 区域的信息，请参阅 AWS 一般参考中的区域和端点。

3. 请选择创建项目。

4. 在选择项目模板页面上：

   • 对于应用程序类型，选择 Web 服务。

   • 对于编程语言，选择 Python。

   • 对于AWS 服务，选择 AWS Lambda。

5. 选择您所需项对应的框。选择下一步。

6. 对于项目名称，输入项目的名称（例如，My SAM Project）。如果使用不同于示例所用的名称，请确保在本教程中通篇使用它。

   对于项目 ID，AWS CodeStar 将为此项目选择一个相关的标识符（例如，my-sam-project）。如果看到不同于示例所用的项目 ID，请务必在本教程中通篇使用它。

   将 AWS CodeCommit 保留为选中状态，不要更改存储库名称值。

7. 选择下一步。

8. 检查您的设置，然后选择创建项目。

   如果是第一次在此 AWS 区域使用 AWS CodeStar，则对于显示名称和电子邮件，输入希望 AWS CodeStar 用于您的 IAM 用户的显示名称和电子邮件地址。选择下一步。

9. 等待 AWS CodeStar 创建项目。这可能需要花几分钟的时间。请在刷新时看到项目已配置横幅后再继续。

在 CodeCommit 中浏览源代码存储库

1. 在项目在 AWS CodeStar 控制台中打开的情况下，在导航栏上选择存储库。

2. 在存储库详情中选择指向您 CodeCommit 存储库的链接（My-SAM-Project）。

3. 在 CodeCommit 控制台的代码页面中，将显示项目的源代码文件：

   • buildspec.yml，CodePipeline 指示 CodeBuild 在构建阶段使用该文件，以便利用 AWS SAM 打包 Web 服务。

   • index.py，包含 Lambda 函数的逻辑。此函数只输出字符串 Hello World 及 ISO 格式的时间戳。

   • README.md – 包含有关存储库的一般信息。

   • template-configuration.json，包含带有占位符的项目 ARN，用于使用项目 ID 标记资源

   • template.yml，AWS SAM 使用它打包 Web 服务和在 API Gateway 中创建 API。

   

   要查看某个文件的内容，请从列表中选择该文件。

   有关 CodeCommit 控制台的更多信息，请参阅 AWS CodeCommit 用户指南。

在 CodePipeline 中浏览管道

1. 要查看有关管道的信息，在项目在 AWS CodeStar 控制台中打开的情况下，请在导航栏上选择管道，即可看到管道包括：

   • 源阶段 - 从 CodeCommit 获取源代码。

   • 构建阶段 - 使用 CodeBuild 构建源代码。

   • Deploy 阶段 - 使用 AWS SAM 部署构建好的源代码和 AWS 资源。

2. 要查看有关管道的更多信息，请在管道详细信息中，选择要在 CodePipeline 控制台中打开的管道。

在概览页面上浏览项目活动和 AWS 服务资源

1. 在 AWS CodeStar 控制台中打开您的项目，并从导航栏中选择概览。

2. 查看项目活动和项目资源列表。

在 Lambda 中浏览函数

1. 在项目在 AWS CodeStar 控制台中打开的情况下，在侧导航栏上选择概览。

2. 在项目资源的 ARN 列中，选择 Lambda 函数的链接。

   函数代码显示在 Lambda 控制台中。

在 API Gateway 中浏览 API

1. 在项目在 AWS CodeStar 控制台中打开的情况下，在侧导航栏上选择概览。

2. 在项目资源的 ARN 列中，选择 Amazon API Gateway API 的链接。

   该 API 的资源显示在 API Gateway 控制台中。

1. 在上一步中的项目仍然打开的情况下，在导航栏上选择管道。

2. 确保源、构建和部署阶段显示已成功，然后再继续。这可能需要花几分钟的时间。

   注意

   如果任何阶段显示失败，请参阅以下内容获取问题排查帮助：

   • 对于源阶段，请参阅 AWS CodeCommit 用户指南中的 AWS CodeCommit 问题排查。

   • 对于构建阶段，请参阅 AWS CodeBuild 用户指南中的 AWS CodeBuild 问题排查。

   • 对于部署阶段，请参阅 AWS CloudFormation 用户指南中的 AWS CloudFormation 问题排查。

   • 有关其他问题，请参阅故障排除 AWS CodeStar。

3. 选择查看应用程序。

1. 在上一步中的项目仍然打开的情况下，执行以下操作：

   • 在导航栏中，选择 IDE，然后展开访问您的项目代码。

   • 选择命令行界面下方的查看说明。

     如果安装了 Visual Studio 或 Eclipse，则改为选择 Visual Studio 或 Eclipse 下的查看说明，按照说明进行操作，然后跳到 步骤 5：向 Web 服务添加逻辑。

2. 按照说明完成以下任务：

   1. 在本地工作站上设置 Git。

   2. 使用 IAM 控制台为您的 IAM 用户生成 Git 凭证。

   3. 将项目的 CodeCommit 存储库克隆到本地工作站上。

3. 在左侧导航栏中，选择项目，返回到项目概述。

1. 在本地工作站上，转到包含克隆的源代码存储库的目录。

2. 在此目录中，创建名为 hello.py 的文件。添加以下代码，然后保存文件：

   import json
   
   def handler(event, context):
     data = {
       'output': 'Hello ' + event["pathParameters"]["name"]
     }
     return {
       'statusCode': 200,
       'body': json.dumps(data),
       'headers': {'Content-Type': 'application/json'}
     }

   上述代码将输出字符串 Hello 及调用方发送到此函数的字符串。

3. 在同一目录中，打开 template.yml 文件。将以下代码添加到文件末尾，然后保存文件：

     Hello:
       Type: AWS::Serverless::Function
       Properties:
         FunctionName: !Sub 'awscodestar-${ProjectId}-lambda-Hello'
         Handler: hello.handler
         Runtime: python3.7
         Role:
           Fn::GetAtt:
           - LambdaExecutionRole
           - Arn
         Events:
           GetEvent:
             Type: Api
             Properties:
               Path: /hello/{name}
               Method: get

   AWS SAM 将使用此代码在 Lambda 中创建一个函数，向 API Gateway 中的 API 添加一个新方法和路径，然后将此方法和路径连接到新函数。

   注意

   上述代码的缩进很重要。如果添加的代码与所示代码有任何差异，都可能无法正确构建项目。

4. 运行 git add .，将文件更改添加到克隆存储库的暂存区域。不要忘记圆点 (.)，它表示添加所有更改过的文件。

   注意

   如果使用 Visual Studio 或 Eclipse 而不是命令行，则使用 Git 的说明可能有所不同。请参阅 Visual Studio 或 Eclipse 文档。

5. 运行 git commit -m "Added hello.py and updated template.yaml." 以提交克隆存储库中的暂存文件

6. 运行 git push 以将提交推送到远程存储库。

   注意

   系统可能会提示您输入之前为您生成的登录凭证。要避免每次与远程存储库交互时都显示提示，可以考虑安装和配置 Git 凭证管理器。例如，在 macOS 或 Linux 上，可以在终端中运行 git config credential.helper 'cache --timeout 900'，指示显示提示的间隔不得短于 15 分钟。或者，也可以运行 git config credential.helper 'store --file ~/.git-credentials' 永久关闭提示。Git 将凭证以明文形式存储在主目录中的纯文本文件中。有关更多信息，请参阅 Git 网站上的 Git 工具 - 凭证存储。

1. 在项目仍在 AWS CodeStar 控制台中打开的情况下，在导航栏上选择管道。

2. 确保管道已再次运行，且源、构建和部署阶段显示已成功，然后再继续。这可能需要花几分钟的时间。

   注意

   如果任何阶段显示失败，请参阅以下内容获取问题排查帮助：

   • 对于源阶段，请参阅 AWS CodeCommit 用户指南中的 AWS CodeCommit 问题排查。

   • 对于构建阶段，请参阅 AWS CodeBuild 用户指南中的 AWS CodeBuild 问题排查。

   • 对于部署阶段，请参阅 AWS CloudFormation 用户指南中的 AWS CloudFormation 问题排查。

   • 有关其他问题，请参阅故障排除 AWS CodeStar。

3. 选择查看应用程序。

   在 Web 浏览器中打开的新标签页上，Web 服务显示以下响应输出：

   {"output": "Hello World", "timestamp": "2017-08-30T15:53:42.682839"}

4. 在该标签的地址框中，将路径 /hello/ 和您的名字添加到 URL 末尾（例如，https://API_ID.execute-api.REGION_ID.amazonaws.com/Prod/hello/YOUR_FIRST_NAME），然后按 Enter。

1. 在本地工作站上，转到包含克隆的源代码存储库的目录。

2. 在此目录中，创建名为 hello_test.py 的文件。添加以下代码，然后保存文件。

   from hello import handler
   
   def test_hello_handler():
   
     event = {
       'pathParameters': {
         'name': 'testname'
       }
     }
   
     context = {}
   
     expected = {
       'body': '{"output": "Hello testname"}',
       'headers': {
         'Content-Type': 'application/json'
       },
       'statusCode': 200
     }
   
     assert handler(event, context) == expected

   此测试检查 Lambda 函数输出是否为预期格式。如果是，则测试成功。否则，测试失败。

3. 在同一目录中，打开 buildspec.yml 文件。使用以下代码替换文件内容，然后保存文件。

   version: 0.2
   
   phases:
      install:
         runtime-versions:
            python: 3.7
   
         commands:
            - pip install pytest
            # Upgrade AWS CLI to the latest version
            - pip install --upgrade awscli
   
   
      pre_build:
         commands:
            - pytest
   
      build:
         commands:
            # Use AWS SAM to package the application by using AWS CloudFormation
            - aws cloudformation package --template template.yml --s3-bucket $S3_BUCKET --output-template template-export.yml
   
            # Do not remove this statement. This command is required for AWS CodeStar projects.
            # Update the AWS Partition, AWS Region, account ID and project ID in the project ARN on template-configuration.json file so AWS CloudFormation can tag project resources.
            - sed -i.bak 's/\$PARTITION\$/'${PARTITION}'/g;s/\$AWS_REGION\$/'${AWS_REGION}'/g;s/\$ACCOUNT_ID\$/'${ACCOUNT_ID}'/g;s/\$PROJECT_ID\$/'${PROJECT_ID}'/g' template-configuration.json
   
   artifacts:
      type: zip
      files:
         - template-export.yml
         - template-configuration.json

   此构建规范指示 CodeBuild 向构建环境中安装 Python 测试框架 pytest。CodeBuild 使用 pytest 运行单元测试。构建规范的其余部分与以前相同。

4. 使用 Git 将这些更改推送到远程存储库。

   git add .
   
   git commit -m "Added hello_test.py and updated buildspec.yml."
   
   git push

1. 在项目仍在 AWS CodeStar 控制台中打开的情况下，在导航栏上选择管道。

2. 请确保管道已再次运行，然后再继续。这可能需要花几分钟的时间。

   如果单元测试成功，则构建阶段显示已成功。

3. 要查看单元测试结果的详细信息，请在构建阶段中选择 CodeBuild 链接。

4. 在 CodeBuild 控制台中，在构建项目: my-sam-project 页面上的构建历史记录中，选择表的构建运行列中的链接。

5. 在 my-sam-project:BUILD_ID 页面的构建日志中，选择查看完整日志链接。

6. 在 Amazon CloudWatch Logs 控制台中，在日志输出中查找类似以下内容的测试结果。在以下测试结果中，测试通过：

   ...
   ============================= test session starts ==============================
   platform linux2 -- Python 2.7.12, pytest-3.2.1, py-1.4.34, pluggy-0.4.0
   rootdir: /codebuild/output/src123456789/src, inifile:
   collected 1 item
   
   hello_test.py .
   
   =========================== 1 passed in 0.01 seconds ===========================
   ...

   如果测试失败，日志输出中应包含详细信息，可帮助您进行问题排查。

1. 在项目仍在 AWS CodeStar 控制台中打开的情况下，在导航栏上选择设置。

2. 在项目详细信息页上，选择删除项目。

3. 输入 delete，让删除资源框处于选中状态，然后选择删除。

   重要

   如果清除此框，将从 AWS CodeStar 中删除项目记录，但项目的许多 AWS 资源都将保留。您的 AWS 账户可能需要继续支付相应费用。

1. 通过以下网址打开 Amazon S3 控制台：https://console.aws.amazon.com/s3/。

2. 在存储桶列表中，选择 aws-codestar-REGION_ID-ACCOUNT_ID-my-sam-project--pipe 旁边的图标，其中：

   • REGION_ID 是刚刚删除的项目的 AWS 区域。

   • ACCOUNT_ID 是您的 AWS 账户 ID。

   • my-sam-project 是刚刚删除的项目的 ID。

3. 选择清空存储桶。输入存储桶名称，然后选择确认。

4. 选择删除存储桶。输入存储桶名称，然后选择确认。