如何使用 AWS CLI 命令管理我的 Lightsail 实例?
上次更新日期:2021 年 1 月 11 日
如何使用 AWS 命令行界面 (AWS CLI) 版本 1 命令管理我的 Amazon Lightsail 实例?
简短描述
有关 Amazon Lightsail AWS CLI 命令的列表,请参阅 AWS CLI 命令参考和 Amazon Lightsail API 参考。
以下是在 Lightsail 实例上使用 AWS CLI 命令的常见场景:
- 列出区域中提供的所有 Lightsail 计划(捆绑包)和蓝图。
- 使用特定的捆绑包和蓝图创建 Lightsail 实例。
- 列出特定区域中的所有 Lightsail 实例。
- 分配静态 IP 地址,然后将其附加到实例并进行验证。
注意:使用 AWS CLI 命令时请记住以下事项:
- 如果在运行 AWS CLI 命令时收到错误,请确保您使用的是最新版本的 AWS CLI。
- 默认的 AWS CLI 输出为 JSON。您可以使用默认值,也可以将 --output json 附加到命令以接收输出,如以下示例所示。有关更多信息,请参阅控制 AWS CLI 的命令输出。
- 有关解决 AWS CLI 错误的一般信息,请参阅运行 AWS CLI 命令时为什么会收到错误?
- AWS CLI 命令输出以 Unix Epoch 时间格式显示时间戳。使用以下一种方法将时间戳转换成 UTC:
macOS:
从时间戳中删除小数点和小数点右侧的任何数字,然后运行以下命令:
# date -r 1602175741 -u
Thu Oct 8 16:49:01 UTC 2020
Linux:
运行以下命令:
# date -d @1602175741.603 -u
Thu Oct 8 16:49:01 UTC 2020
Windows:
使用转换器对时间戳进行转换,如 epochconverter.com。
解决方法
列出区域中可用的所有 Lightsail 捆绑包和蓝图
运行 get-bundles 命令以查看您所在区域可供购买的所有捆绑包的列表。在以下命令中,将 eu-west-1 替换为您的区域:
# aws lightsail get-bundles --region eu-west-1 --query 'bundles[].{price:price,cpuCount:cpuCount,ramSizeInGb:ramSizeInGb,diskSizeInGb:diskSizeInGb,bundleId:bundleId,instanceType:instanceType,supportedPlatforms:supportedPlatforms[0]}' --output table
---------------------------------------------------------------------------------------------------------------
| GetBundles |
+-----------------+-----------+---------------+---------------+--------+---------------+----------------------+
| bundleId | cpuCount | diskSizeInGb | instanceType | price | ramSizeInGb | supportedPlatforms |
+-----------------+-----------+---------------+---------------+--------+---------------+----------------------+
| nano_2_0 | 1 | 20 | nano | 3.5 | 0.5 | LINUX_UNIX |
| micro_2_0 | 1 | 40 | micro | 5.0 | 1.0 | LINUX_UNIX |
| small_2_0 | 1 | 60 | small | 10.0 | 2.0 | LINUX_UNIX |
| medium_2_0 | 2 | 80 | medium | 20.0 | 4.0 | LINUX_UNIX |
| large_2_0 | 2 | 160 | large | 40.0 | 8.0 | LINUX_UNIX |
| xlarge_2_0 | 4 | 320 | xlarge | 80.0 | 16.0 | LINUX_UNIX |
| 2xlarge_2_0 | 8 | 640 | 2xlarge | 160.0 | 32.0 | LINUX_UNIX |
| nano_win_2_0 | 1 | 30 | nano | 8.0 | 0.5 | WINDOWS |
| micro_win_2_0 | 1 | 40 | micro | 12.0 | 1.0 | WINDOWS |
| small_win_2_0 | 1 | 60 | small | 20.0 | 2.0 | WINDOWS |
| medium_win_2_0 | 2 | 80 | medium | 40.0 | 4.0 | WINDOWS |
| large_win_2_0 | 2 | 160 | large | 70.0 | 8.0 | WINDOWS |
| xlarge_win_2_0 | 4 | 320 | xlarge | 120.0 | 16.0 | WINDOWS |
| 2xlarge_win_2_0| 8 | 640 | 2xlarge | 240.0 | 32.0 | WINDOWS |
+-----------------+-----------+---------------+---------------+--------+---------------+----------------------+
运行 get-blueprints 命令以查看您所在区域中所有映像或蓝图的列表。然后,您可以选择使用可用映像创建新实例。在以下命令中,将 eu-west-1 替换为您的区域:
# aws lightsail get-blueprints --region eu-west-1 --query 'blueprints[].{blueprintId:blueprintId,name:name,group:group,productUrl:productUrl,platform:platform}' --output table
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
| GetBlueprints |
+--------------------------------------+-----------------------+--------------------------------+-------------+-----------------------------------------------------+
| blueprintId | group | name | platform | productUrl |
+--------------------------------------+-----------------------+--------------------------------+-------------+-----------------------------------------------------+
| windows_server_2019 | windows_2019 | Windows Server 2019 | WINDOWS | https://aws.amazon.com/marketplace/pp/B07QZ4XZ8F |
| windows_server_2016 | windows_2016 | Windows Server 2016 | WINDOWS | https://aws.amazon.com/marketplace/pp/B01M7SJEU7 |
| windows_server_2012 | windows_2012 | Windows Server 2012 R2 | WINDOWS | https://aws.amazon.com/marketplace/pp/B00KQOWCAQ |
| windows_server_2016_sql_2016_express| windows_2016_sql_exp | SQL Server 2016 Express | WINDOWS | https://aws.amazon.com/marketplace/pp/B01MAZHH98 |
| amazon_linux_2 | amazon_linux_2 | Amazon Linux 2 | LINUX_UNIX | https://aws.amazon.com/amazon-linux-2/ |
| amazon_linux | amazon-linux | Amazon Linux | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00CIYTQTC |
| ubuntu_20_04 | ubuntu_20 | Ubuntu | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B087QQNGF1 |
| ubuntu_18_04 | ubuntu_18 | Ubuntu | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B07CQ33QKV |
| ubuntu_16_04_2 | ubuntu | Ubuntu | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B01JBL2M0O |
| debian_10 | debian_10 | Debian | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B0859NK4HC |
| debian_9_5 | debian_9 | Debian | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B073HW9SP3 |
| debian_8_7 | debian | Debian | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00WUNJIEE |
| freebsd_12 | freebsd | FreeBSD | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B07L6QV354 |
| opensuse_15_1 | opensuse | openSUSE | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B01N4R3GJI |
| centos_7_1901_01 | centos | CentOS | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00O7WM7QW |
| wordpress | wordpress | WordPress | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NN8Y43U |
| wordpress_multisite | wordpress_multisite | WordPress Multisite | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NN8XE6S |
| lamp_7 | lamp_7 | LAMP (PHP 7) | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B072JNJZ5C |
| nodejs | node | Node.js | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZUAKO |
| joomla | joomla | Joomla | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZUP54 |
| magento | magento | Magento | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZTA6Y |
| mean | mean | MEAN | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NO1HJ56 |
| drupal | drupal | Drupal | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZSUMO |
| gitlab | gitlab | GitLab CE | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZU5PO |
| redmine | redmine | Redmine | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZUVHQ |
| nginx | nginx | Nginx | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NPHKI3Y |
| ghost_bitnami | ghost_bitnami | Ghost | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NPHLY8W |
| django_bitnami | django_bitnami | Django | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NNZTDNO |
| plesk_ubuntu_18_0_28 | plesk_ubuntu | Plesk Hosting Stack on Ubuntu | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B077MJL7Z2 |
| cpanel_whm_linux | cpanel_whm_linux | cPanel & WHM for Linux | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B07RRX2TVV |
+--------------------------------------+-----------------------+--------------------------------+-------------+-----------------------------------------------------+
示例:
以下命令用于筛选具有 Linux/Unix 平台操作系统的蓝图:
# aws lightsail get-blueprints --query 'blueprints[?type==`os`&&platform==`LINUX_UNIX`].{name:name,version:version}' --output table
--------------------------------------------
| GetBlueprints |
+-----------------+------------------------+
| name | version |
+-----------------+------------------------+
| Amazon Linux 2 | 2.0.20200917.0 |
| Amazon Linux | 2018.03.0.20200918.0 |
| Ubuntu | 20.04 LTS |
| Ubuntu | 18.04 LTS |
| Ubuntu | 16.04 LTS |
| Debian | 10.5 |
| Debian | 9.5 |
| Debian | 8.7 |
| FreeBSD | 12.1 |
| openSUSE | 15.1 |
| CentOS | 7 1901-01 |
+-----------------+------------------------+
使用特定的捆绑包和蓝图创建 Lightsail 实例
1. 运行以下命令以获取蓝图。以下示例命令获取 WordPress 蓝图。将 eu-west-1 替换为您的区域,并将 WordPress 信息替换为您选择的蓝图信息。
# aws lightsail get-blueprints --region eu-west-1 --query 'blueprints[].{blueprintId:blueprintId,name:name,group:group,productUrl:productUrl,platform:platform}' --output table |grep -i wordpress
| wordpress | wordpress | WordPress | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NN8Y43U |
| wordpress_multisite | wordpress_multisite | WordPress Multisite | LINUX_UNIX | https://aws.amazon.com/marketplace/pp/B00NN8XE6S |
2. 运行 create-instances 命令以创建 Amazon Lightsail 实例。以下示例使用 WordPress 蓝图和 micro_2_0 捆绑包在 eu-west-1 区域创建一个 Amazon Lightsail 实例。将 --instance-names、blueprint-id、bundle-id 和 --region 替换为您的请求中的相应值。
# aws lightsail create-instances --region eu-west-1 --instance-names MyNewInstance --availability-zone eu-west-1a --blueprint-id wordpress --bundle-id micro_2_0
{
"operations": [
{
"id": "003757e7-0880-4162-9912-211d4756081e",
"resourceName": "MyNewInstance",
"resourceType": "Instance",
"createdAt": 1602175452.334,
"location": {
"availabilityZone": "eu-west-1a",
"regionName": "eu-west-1"
},
"isTerminal": false,
"operationType": "CreateInstance",
"status": "Started",
"statusChangedAt": 1602175452.334
}
]
}
要使用单个 API 调用创建多个实例,请使用 --instance-names {"LightsailInstance1","LightsailInstance2"} 指定参数。 以下示例使用 WordPress 蓝图和 micro_2_0 捆绑包在 eu-west-1 区域创建两个 Lightsail 实例。
# aws lightsail create-instances --region eu-west-1 --instance-names {"TestLightsailInstance1","TestLightsailInstance2"} --availability-zone eu-west-1a --blueprint-id wordpress --bundle-id micro_2_0
{
"operations": [
{
"id": "8a15b195-9a20-4d79-ad1d-6e85557ae94d",
"resourceName": "TestLightsailInstance1",
"resourceType": "Instance",
"createdAt": 1602175741.602,
"location": {
"availabilityZone": "eu-west-1a",
"regionName": "eu-west-1"
},
"isTerminal": false,
"operationType": "CreateInstance",
"status": "Started",
"statusChangedAt": 1602175741.602
},
{
"id": "a006513b-0e25-4802-ab33-671a40bf5a92",
"resourceName": "TestLightsailInstance2",
"resourceType": "Instance",
"createdAt": 1602175741.603,
"location": {
"availabilityZone": "eu-west-1a",
"regionName": "eu-west-1"
},
"isTerminal": false,
"operationType": "CreateInstance",
"status": "Started",
"statusChangedAt": 1602175741.603
}
]
}
列出区域中的所有 Lightsail 实例
运行 get-instances 命令以显示特定区域中的 Lightsail 实例。以下示例显示了 eu-west-1 区域中的所有 Lightsail 实例。将 --region 替换为您的请求中的相应值。
# aws lightsail get-instances --region eu-west-1 --query 'instances[].{name:name,createdAt:createdAt,blueprintId:blueprintId,blueprintName:blueprintName,publicIpAddress:publicIpAddress}' --output table
---------------------------------------------------------------------------------------------------------------------
| GetInstances |
+-----------------+----------------+-----------------+------------------------------------------+-------------------+
| blueprintId | blueprintName | createdAt | name | publicIpAddress |
+-----------------+----------------+-----------------+------------------------------------------+-------------------+
| wordpress_4_9_8| WordPress | 1545700733.77 | WordPress-512MB-Ireland-1 | 63.33.xx.xx |
| wordpress | WordPress | 1602175741.603 | TestLightsailInstance2 | 63.33.xx.xx |
| wordpress | WordPress | 1602175741.602 | TestLightsailInstance1 | 54.7.xx.xx |
| wordpress | WordPress | 1588098501.555 | WordPress-1 | 3.250.xx.xx |
| wordpress | WordPress | 1602175452.334 | MyNewInstance | 54.195.xx.xx
+-----------------+----------------+-----------------+------------------------------------------+-------------------+
分配静态 IP,然后将其附加到创建的 Lightsail 实例并对其进行验证。
注意:create-instances 命令可创建分配有一个公有 IP 地址的 Lightsail 实例。与您可以分配和重新分配给实例或其他资源的公有 IP 地址不同,静态 IP 地址是固定的。如果您尚未创建实例的静态 IP 地址,则 Lightsail 会在您每次停止或重新启动实例时分配一个新的公有 IP 地址。
1. 运行 allocate-static-ip 命令以分配固定的公有地址。以下示例显示了名为 StaticIpForTestLightsailInstance1 的静态 IP 在 eu-west-1 区域中的分配。将 --static-ip-name 和 --region 替换为您的请求中的相应值。
# aws lightsail allocate-static-ip --static-ip-name StaticIpForTestLightsailInstance1 --region eu-west-1
{
"operations": [
{
"id": "6471cedc-97f5-42d1-b35f-4f77c5f93242",
"resourceName": "StaticIpForTestLightsailInstance1",
"resourceType": "StaticIp",
"createdAt": 1602180341.746,
"location": {
"availabilityZone": "all",
"regionName": "eu-west-1"
},
"isTerminal": true,
"operationType": "AllocateStaticIp",
"status": "Succeeded",
"statusChangedAt": 1602180342.011
}
]
}
2. 运行 get-static-ip 命令以显示分配的静态 IP 地址的值。以下示例显示了名为 StaticIpForTestLightsailInstance1 的静态 IP 52.210.xx.xx 在 eu-west-1 区域中的分配。将 --static-ip-name 和 --region 替换为您的请求中的相应值。
# aws lightsail get-static-ip --static-ip-name StaticIpForTestLightsailInstance1 --region eu-west-1
{
"staticIp": {
"name": "StaticIpForTestLightsailInstance1",
"arn": "arn:aws:lightsail:eu-west-1:920893848407:StaticIp/16a97579-c51e-404c-96cc-5946528d12aa",
"supportCode": "11178xxxxxxx/52.210.xx.xx",
"createdAt": 1602180341.746,
"location": {
"availabilityZone": "all",
"regionName": "eu-west-1"
},
"resourceType": "StaticIp",
"ipAddress": "52.210.xx.xx",
"isAttached": false
}
}
3. 运行 attach-static-ip 命令将静态 IP 地址附加到您的 Lightsail 实例。以下示例显示了名为 StaticIpForTestLightsailInstance1 的静态 IP 52.210.xx.xx 带 eu-west-1 区域中名为 TestLightsailInstance1 的实例的分配。将 --static-ip-name、--instance-name 和 --region 替换为您的请求中的相应值。
# aws lightsail attach-static-ip --static-ip-name StaticIpForTestLightsailInstance1 --instance-name TestLightsailInstance1 --region eu-west-1
{
"operations": [
{
"id": "d9d2372f-b4b7-4838-99ae-c15f8ffb8332",
"resourceName": "StaticIpForTestLightsailInstance1",
"resourceType": "StaticIp",
"createdAt": 1602180562.026,
"location": {
"availabilityZone": "all",
"regionName": "eu-west-1"
},
"isTerminal": true,
"operationDetails": "TestLightsailInstance1",
"operationType": "AttachStaticIp",
"status": "Succeeded",
"statusChangedAt": 1602180562.026
},
{
"id": "131994d8-bd25-4b47-8d81-851224b168d1",
"resourceName": "TestLightsailInstance1",
"resourceType": "Instance",
"createdAt": 1602180562.026,
"location": {
"availabilityZone": "eu-west-1a",
"regionName": "eu-west-1"
},
"isTerminal": true,
"operationDetails": "StaticIpForTestLightsailInstance1",
"operationType": "AttachStaticIp",
"status": "Succeeded",
"statusChangedAt": 1602180562.026
}
]
}
4. 运行 get-instances 命令以验证静态 IP 地址是否与您的 Lightsail 实例正确关联。
# aws lightsail get-instances --region eu-west-1 --query 'instances[].{name:name,createdAt:createdAt,blueprintId:blueprintId,blueprintName:blueprintName,publicIpAddress:publicIpAddress,InstanceID:supportCode}' --output table
---------------------------------------------------------------------------------------------------------------------------------------------------------
| GetInstances |
+----------------------------------+------------------+----------------+-----------------+------------------------------------------+-------------------+
| InstanceID | blueprintId | blueprintName | createdAt | name | publicIpAddress |
+----------------------------------+------------------+----------------+-----------------+------------------------------------------+-------------------+
| 11178xxxxxxx/i-09f6xxxx| wordpress | WordPress | 1602175741.602 | TestLightsailInstance1 | 52.210.xx.xx |
+----------------------------------+------------------+----------------+-----------------+------------------------------------------+-------------------+