# 启动 Amazon ECS 的 Bottlerocket 实例
<a name="bottlerocket-launch"></a>

您可以启动 Bottlerocket 实例，以便运行容器工作负载。

您可以使用 AWS CLI 启动 Bottlerocket 实例。

1. 创建名为 `userdata.toml` 的文件。此文件会用于实例用户数据。将 *cluster-name* 替换为您集群的名称。

   ```
   [settings.ecs]
   cluster = "cluster-name"
   ```

1. 使用 [检索经 Amazon ECS 优化的 Bottlerocket AMI 元数据](ecs-bottlerocket-retrieve-ami.md) 中包含的命令之一获取 Bottlerocket AMI ID。您将在以下步骤中使用此 ID。

1. 运行以下命令来启动 Bottlerocket 实例。请记得替换以下参数：
   + 用您的实例将在其中启动的私有或公有子网的 ID 替换*子网*。
   + 将 *bottlerocket\$1ami* 替换为上一步中的 AMI ID。
   + 将 *t3.large* 替换为您要使用的实例类型。
   + 将 *region* 替换为区域代码。

   ```
   aws ec2 run-instances --key-name ecs-bottlerocket-example \
      --subnet-id subnet \
      --image-id bottlerocket_ami \
      --instance-type t3.large \
      --region region \
      --tag-specifications 'ResourceType=instance,Tags=[{Key=bottlerocket,Value=example}]' \
      --user-data file://userdata.toml \
      --iam-instance-profile Name=ecsInstanceRole
   ```

1. 运行以下命令，以验证容器实例是否注册到集群。在运行此命令时，请记得替换以下参数：
   + 将 *cluster* 替换为您的集群名称。
   + 将 *region* 替换为区域代码。

   ```
   aws ecs list-container-instances --cluster cluster-name --region region
   ```

有关如何在 Amazon ECS 上开始使用 Bottlerocket 操作系统的详细演练，请参阅 GitHub 上的[在 Amazon ECS 上使用 Bottlerocket AMI](https://github.com/bottlerocket-os/bottlerocket/blob/develop/QUICKSTART-ECS.md) 和 AWS 博客网站上的[开始使用 Bottlerocket 和 Amazon ECS](https://aws.amazon.com/blogs/containers/getting-started-with-bottlerocket-and-amazon-ecs/)。