使用 AWS CLI 创建和部署

AWS CLI 是一个命令行工具,可帮助您使用 AWS 服务。我们可以使用它来创建、更新、删除和调用 AWS Lambda 函数。在本章中,您将详细讨论 AWS CLI 的安装和使用。

AWS CLI 的安装

本节将指导您在各种操作系统上安装 AWS CLI。按照给出的步骤操作,并观察所附的相应屏幕截图。

对于 Windows

检查您的 Windows 配置并选择以下链接之一安装 AWS CLI MSI −

选择相应的链接并单击它后,您可以找到一个窗口,如下所示 −

安装 AWS

接下来,设置 Windows 中的环境路径,如下面的屏幕截图所示 −

环境路径

完成后,您可以在命令提示符中使用以下命令,查看是否安装了 aws cli

aws --version

它显示 aws-cli 版本的详细信息,如以下屏幕截图所示 −

AWS Cli Version

适用于 Linux / Mac

要在 Linux 和 Mac 上安装,您需要 Python 2.6.3 或更高版本。然后,使用以下命令进行进一步的安装过程 −

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
$ unzip awscli-bundle.zip
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

现在,我们需要配置 AWS 设置。您可以使用以下命令实现此目的 −

aws configure

为此目的,需要以下详细信息:−

  • AWS 访问密钥 ID
  • AWS 秘密访问密钥
  • 默认区域名称
  • 默认输出格式

您可以从 aws 控制台获取这些详细信息。转到右上角的帐户名称,如下所示 −

Helpful Tips

现在,单击我的安全凭证并从左侧选择用户。根据要求添加用户并提供详细信息。

安全凭证

添加用户并获取访问密钥和秘密密钥。要查看新访问密钥,请选择显示。您的凭证将如下所示 −

访问密钥 ID − AOSAIOSFOCDD7Example

秘密访问密钥 − aJuirCVtnROUN/K7MDENG/bPxRfiCYExampleKEY

访问密钥

AWS CLIS 的参考命令

下表将提供可用于 aws cli 的命令参考。

aws cli 命令的名称 命令参考
create-function create-function --function-name <value> --runtime <value> --role <value> --handler <value> [--code <value>] [--description <value>] [--timeout <value>] [--memory-size <value>] [--environment <value>] [--kms-key-arn <value>] [--tags <value>] [--zip-file <value>] [--cli-input-json <value>]
list-functions list-functions [--master-region <value>] [--function-version <value>] [--max-items <value>] [--cli-input-json <value>] [--starting-token <value>] [--page-size <value>] [--generate-cli-skeleton <value>]
get-function get-function --function-name <value> [--qualifier <value>] [--cli-input-json <value>] [--generate-cli-skeleton <value>]
get-function-configuration get-function-configuration --function-name <value> [--qualifier <value>] [--cli-input-json <value>] [--generate-cli-skeleton <value>]
get-account-settings get-account-settings [--cli-input-json <value>] [--generate-cli-skeleton <value>]
update-function-configuration update-function-configuration --function-name <value> [--role <value>] [--handler <value>] [--description <value>] [--timeout <value>] [--memory-size <value>] [--vpc-config <value>] [--environment <value>] [--runtime <value>] [--dead-letter-config <value>] [--kms-key-arn <value>] [--tracing-config <value>] [--revision-id <value>] [--cli-input-json <value>] [--generate-cli-skeleton <value>]
update-function-code update-function-code --function-name <value> [--zip-file <value>] [--s3-bucket<value>] [--s3-key <value>] [--s3-object-version <value>] [--publish | --no-publish] [--dry-run | --no-dry-run] [--revision-id <value>][--cli-input-json <value>][--generate-cli-skeleton <value>]
delete-function delete-function --function-name <value> [--qualifier <value>] [--cli-input-json <value>] [--generate-cli-skeleton <value>]

现在,让我们逐一详细讨论这些命令。

create-function

此 api 将创建一个新的 lambda 函数。代码需要以 zip 格式提供。如果要创建的函数已经存在,则 api 将失败。请注意,函数名称区分大小写。

包含的命令

此处给出了可以与 create-function 一起使用的命令列表 −

create-function 
--function-name <value>
--runtime <value>
--role <value>
--handler <value>
[--code <value>] 
[--description <value>] 
[--timeout <value>] 
[--memory-size <value>] 
[--environment <value>] 
[--kms-key-arn <value>] 
[--tags <value>] 
[--zip-file <value>] 
[--cli-input-json <value>]

包含的选项

您可以与上述函数一起使用的各种选项如下 −

--function-name (string) − 这将获取函数的名称。名称可以是 64 位字符。

--runtime(string) − 在这里您需要指定运行时环境,即语言选择。运行时的详细信息如下所示 −

可用选项 运行时
Python v3.6 python3.6
Python v2.7 python2.7
NodeJS v6.10 nodejs6.10
NodeJS v8.10 nodejs8.10
Java java8
C# 1 dotnetcore1.0
C# 2 dotnetcore2.0
Go go1.x

--role(字符串) − 这将是 lambda 策略的名称,即赋予 lambda 函数访问其他服务的角色。它将具有根据指定角色的权限。

--handler(字符串) − 这是 lambda 代码执行将从其开始的处理程序的名称。

  • 对于 nodejs,处理程序名称是我们导出的模块名称。
  • 对于 java,它是 package.classname :: handler 或 package.classname
  • 对于 python,处理程序是文件的名称。

--code(结构) −AWS Lambda 代码

--description(字符串) − AWS Lambda 函数的描述

--timeout(整数) − timeout 将具有 lambda 函数必须终止执行的时间。默认值为 3 秒。

--memory-size(整数) − 这是分配给 aws lambda 函数的内存。AWS 将根据给定的内存分配 CPU 和内存分配量。

--environment(结构) − 它是一个包含 aws lambda 函数中所需的环境详细信息的对象。

例如:变量 = {Name1 = 字符串,Name2 = 字符串}

--kms-key-arn(字符串) − 这是用于加密环境变量的亚马逊资源名称 (ARN)。如果未提供,则将采用默认设置进行加密。

--zip-file (blob) − 包含代码详细信息的 zip 文件的路径。

--cli-input-json (string):根据提供的 JSON 字符串执行服务操作。JSON 字符串遵循 --generate-cli-skeleton 提供的格式。如果在命令行上提供了其他参数,CLI 值将覆盖 JSON 提供的值。

现在,让我们使用运行时作为 nodejs 创建一个简单的 AWS Lambda 函数并添加一些要打印的 console.log。

考虑一个示例代码来理解相同的内容 −

exports.handler = async (event) => {
   console.log("Using aws cli");
   return 'Hello from Lambda from aws cli!'
};

现在,压缩文件并将其存储为 awscli.zip

获取 ARN

对于角色,让我们使用我们创建的现有角色中的 arn。要获取 ARN,您必须按照此处显示的步骤操作。观察附加的相应屏幕截图 −

步骤 1

转到 IAM 并从 角色 中选择所需的角色。角色的 ARN 详细信息显示如下。在 aws cli 中将 Role ARNcreate-function 结合使用。 Summary Cli

请注意,此处的角色 arn 为:arn:aws:iam::625297745038:role/lambdaapipolicy

带有 create-function 值的命令如下 −

aws lambda create-function 
--function-name "awslambdausingcli" 
--runtime "nodejs8.10" 
--role "arn:aws:iam::625297745038:role/lambdaapipolicy" 
--handler "awscli.handler" 
--timeout 5 
--memory-size 256 
--zip-file "fileb://awscli.zip"

现在,如果您在 aws cli 中运行该命令,您可以找到如下所示的输出 −

Command Cli

在 AWS 控制台中,Lambda 函数显示如下 −

Cli Function

函数的详细信息如下所示 −

Cli Code

配置的详细信息如下所示 −

Cli Role

您可以测试该函数并检查输出,如下所示 −

Cli Execution

相应的日志输出显示在此处 −

Cli Output

list-functions

此 API 提供迄今为止在 AWS Lambda 中创建的函数列表。

包含的命令

以下是与此 API 关联的命令 −

list-functions
[--master-region <value>]
[--function-version <value>]
[--max-items <value>]
[--cli-input-json <value>]

list-functions 下的选项

以下是您可以在此 list-functions api − 下使用的各种选项

--master-region(string) − 可选。需要显示函数的区域。

--function-version(string) − 可选。这将提供函数版本。

--max-items(integer) − 可选。这将根据指定的值提供项目。

--cli-input-json(string) − 可选。将根据提供的 json 文件执行操作。

带有值 list-functions 的命令如下 −

aws lambda list-functions --max-items 3

该命令显示详细信息如下 −

Cli Display

get-function

此 api 将提供函数的详细信息以及使用 create-function 上传的 zip 文件的 url 链接。带有 zip 详细信息的 url 仅在 10 分钟内有效。

包含的命令

以下是与此 api 相关的命令 −

get-function
--function-name <value>
[--qualifier <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

包含的选项

--function-name − AWS Lambda 函数的名称。您还可以指定函数的 Amazon 资源名称。

--qualifier(string) − 可选。函数版本可用于获取函数的详细信息。

带有 get-function 值的命令是 −

aws lambda get-function --function-name awslambdausingcli

命令显示详细信息如下 −

Option Included

它提供已上传邮政编码的 url。在上述情况下,url 为−

https://prod-04-2014-
tasks.s3.amazonaws.com/snapshots/625297745038/awslambdausingcli-97048f8d-4a08
-4ed9-99d9-acb00d2063d2?versionId=d04HKvPu9S2zz8pzjbW6Rmf5o5fxnc_r&X-Amz-Security
-Token=FQoDYXdzEKT%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDCpTmGvtwKToPBiWcyK3A96UcJEnwvYDhMbbxu
%2Bg2gffK2ocfnlEeiCHak8QqqE1RFpbKrdks9NzxP9gNbagL4M9RValxJ1a9PUY%2FOdAekscRHOiX00MVAxUlI8
2pKryhdOwLJWSj0uRzqvOxCcBwJenHrSNPeG6lMa2ZDo0qZFEUDONSaTg4nuSnJK1f6t3pMAKu4vF9wPvf92G%2BU
60rUxwleggigISmD9l1IlZse3%2BVF1JlNuN%2F5d85v0y2Q%2F%2BO515CybcZpn91sHPYG8JMJ00LsrkQ2Ww4VU
9Zz5c5QYH4JYPj0CyEgSz9b%2FMceMPpOoPUAMjctb%2FEwQqcShZeqAr9%2Fcd2ZI%2BXl2%2Bs4ri0ucgPvQQvs
eGIIiZbX3GqdwR2jb1nylrAEIfiuFMoSWfcFYoYtuL0MZnjGR9jy2GNkp6MB%2BlHHr7%2BnuFRUzU26rgDYmdE1w
Rb3%2B21Jm49WGDa9opRLvUxFaux57Or70haib2FuKzN6Gf3Vzzk5KPdWsYUpaLyf%2B1ovEytOZhB1JEXuCs%2FG
IlOXS88yxT%2BpOKmyxweiezpGgI%2FAkSAQTbSRsYQKIOFyIJNHzplwrJKhy28vy60numIBIo9Zqq2AU%3D
&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20180527T112426Z&X-Amz-
SignedHeaders=host&X-Amz-Expires=600&X-Amz-
Credential=ASIAICSQHLSBWFP37U4Q%2F20180527%2Fus-
east-1%2Fs3%2Faws4_request&X-Amz-Signature=
8b97e7d6d7da13313068e027894d2c875be5e50a0c5a62550f55307985bdc1aa

get-function-configuration

这将提供 AWS Lambda 函数的配置详细信息。

以下是与此 api 一起使用的命令 −

get-function-configuration
--function-name <value>
[--qualifier <value>]

以下是与

一起使用的选项

--function-name (string) − aws lambda 函数的名称。您还可以指定函数的 Amazon 资源名称。

--qualifier(string) − 可选。函数版本可用于获取函数的详细信息。

带有 get-function 值的命令是 −

aws lambda get-function-configuration --function-name awslambdausingcli

该命令显示详细信息如下 −

Get Function.

get-account-settings

此 api 提供账户设置。

涉及的命令

您可以与此 api 一起使用的命令是 −

get-account-settings
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

涉及的选项

您可以将以下选项与此 api 一起使用 −

--cli-input-json(string) − 根据提供的 json 字符串执行服务。

--generate-cli-skeleton(string) − 它打印 json 输出而不发送 API 请求。

您可以将以下命令用于 get-account-settings −

aws lambda get-account-settings

执行上述命令时,您可以看到以下输出 −

涉及的选项

update-function-configuration

此 api 有助于更新创建的 AWS Lambda 函数的配置详细信息。您可以更改内存、超时、处理程序、角色、运行时、描述等。

涉及的命令

以下是 update-function-configuration api 中涉及的命令 −

update-function-configuration
--function-name <value>
[--role <value>]
[--handler <value>]
[--description <value>]
[--timeout <value>]
[--memory-size <value>]
[--environment <value>]
[--runtime <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

涉及的选项

以下是 update-function-configuration api −

中涉及的选项

--function-name − aws lambda 函数的名称

--role (string) − 可选。需要更新角色的 ARN。

--handler (string) − 可选。aws lambda 函数的处理程序详细信息。

--description(string) − 可选。函数的描述。

--timeout(integer) − 可选。aws lambda 函数终止所需的时间。

--memory-size(integer) − 可选。这是分配给 aws lambda 函数的内存。AWS 将根据给定的内存分配 CPU 和内存分配量。

--environment(结构)− 可选。它是一个包含 aws lambda 函数中所需的环境详细信息的对象。

例如:变量 Variables = {Name1 = string,Name2 = string}

--runtime(string)− 在这里您需要指定运行时环境,即语言选择。

运行时的详细信息显示在下表中 −

可用选项 运行时
Python v3.6 python3.6
Python v2.7 python2.7
NodeJS v6.10 nodejs6.10
NodeJS v8.10 nodejs8.10
Java java8
C# 1 dotnetcore1.0
C# 2 dotnetcore2.0
Go go1.x

--cli-input-json (string) − 可选。这将按照提供的 json 字符串中指定的方式对 api 执行操作。

--generate-cli-skeleton (string) − 可选。这将输出所有详细信息的 JSON 骨架,而无需执行 api。输出可用作 --cli-input-json 的输入。

现在,让我们更改我们之前创建的 AWS Lambda 函数的内存和超时。按照下面给出的步骤操作,并观察为此目的附加的相应屏幕截图 −

步骤 1

更改发生之前的内存和超时如下 −

Timeout

步骤 2

现在,使用 update-function-configuration,让我们将内存和超时更改为 320MB,将超时更改为 10 秒。为此,请使用以下命令并设置值 −

aws lambda update-function-configuration --function-name "awslambdusingcli"
--timeout 10 --memory-size 320

步骤 3

然后您可以看到以下输出作为显示 −

Cli updated

步骤 4

使用 update-function-configuration 后,AWS 控制台中的显示如下 −

Cli Configuration

Update-function-code

此 API 将更新现有 AWS Lambda 函数的代码。

涉及的命令

update-function-code
--function-name <value>
[--zip-file <value>]
[--s3-bucket <value>]
[--s3-key <value>]
[--s3-object-version <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

涉及的选项

以下是 update-function-code api − 涉及的选项

--function-name(string) − aws lambda 函数的名称

--zip-file (blob) − 可选。包含要更新的代码的 zip 文件的路径。

--s3-bucket(string) − 可选。包含已上传代码的 zip 文件的 S3 bucket 名称。

--s3-key(string) − 可选。必须上传的 AWS s3 对象密钥名称。

--s3-object-version (string) − 可选。 AWS s3 对象版本。

--cli-input-json (string) − 可选。这将按照提供的 json 字符串中指定的操作对 api 执行操作。

--generate-cli-skeleton (string) − 可选。这将输出所有详细信息的 JSON 骨架,而无需执行 api。输出可用作 --cli-input-json 的输入。

更新后的代码如下所示 −

exports.handler = async (event, context) => {
   console.log("Using aws cli");
   console.log()
   return 'Hello from Lambda from aws cli!'
};

您可以使用以下命令及其值来实现此目的

aws lambda update-function-code --function-name "awslambdausingcli"
--zip-file "fileb://awscli.zip"

相应的输出如下所示 −

Cli Purpose

AWS 控制台的显示如下所示 −

AWS Cli Console

相应的日志输出如下所示 −

Cli日志

delete-function

delete aws cli api 将删除给定的函数。

包含的命令

此处提供了相同的命令详细信息 −

delete-function
--function-name <value>
[--qualifier <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

包含的选项

此 api 中包含的选项如下所示 −

--function-name(string) − 这将采用 lambda 函数名称或 aws lambda 函数的 arn。

--qualifier (string) − 这是可选的。您可以在此处指定需要删除的 aws lambda 版本。

-- cli-input-json(string) − 根据提供的 JSON 字符串执行服务操作。JSON 字符串遵循 --generate-cli-skeleton 提供的格式。如果在命令行上提供了其他参数,CLI 值将覆盖 JSON 提供的值。

--generate-cli-skeleton(string) − 它会将 json 骨架打印到标准输出,而无需发送 API 请求。

您可以将以下命令与值一起使用以实现此目的 −

aws lambda delete-function --function-name "lambdatestcli"
Delete Function

现在,请注意,该函数不会出现在 AWS Lambda 函数列表中 −

Cli Keywords