Add documentation for the aws-ecs-1 variant

[samuelkarp]

Issue number:
#815

Description of changes:

• New QUICKSTART-ECS.md setup guide for ECS
• Updates to README.md to document the variant
• Updates to BUILDING.md to link to the new setup guide

Terms of contribution:

By submitting this pull request, I agree that this contribution is dual-licensed under the terms of both the Apache License, version 2.0, and the MIT license.

[srgothi92]

Additionally, Do you think we should add a line before 138 in your commit and 132 in old Readme.md section Admin Container , conveying how to reach the admin container and SSM session is not the one directly connecting to admin container

[srgothi92]

Do you think we should add supported feature list or TODO feature list somewhere ?

[samuelkarp]

Additionally, Do you think we should add a line before 138 in your commit and 132 in old Readme.md section Admin Container , conveying how to reach the admin container and SSM session is not the one directly connecting to admin container

If you want to propose that as a separate PR, I think that could be reasonable. We do already say at the top of that section: "This container has an SSH server that lets you log in as ec2-user using your EC2-registered SSH key." But maybe we can make that more clear?

(I don't think that should be part of this PR as it's not an ECS-specific change.)

Do you think we should add supported feature list or TODO feature list somewhere ?

I'm planning to update #815 with that information.

[srgothi92]

Do you think we should add supported feature list or TODO feature list somewhere ?

I’m planning to update #815 with that information.

Shouldn’t that be somewhere public as well and linked to QuickStart-ECS doc, for anyone trying out ECS variant knows what features of ECS will work.

[samuelkarp]

I’m planning to update #815 with that information.

Shouldn’t that be somewhere public as well and linked to QuickStart-ECS doc, for anyone trying out ECS variant knows what features of ECS will work.

Our GitHub issues are public. I don't think it's the right choice to include this information in the quickstart/setup guide document as the primary audience of that is people trying out Bottlerocket for the first time rather than folks who are running their workloads on Bottlerocket.

We don't really have a section in our documentation today where we talk about what kinds of features do and don't work for our Kubernetes variants either. I think #815 is a reasonable place to put the information for now, and we can potentially add a link to issues like @jahkeup suggested here once those are created.

[samuelkarp]

samuelkarp force-pushed the samuelkarp:ecs-documentation branch from b07a8ce to 1d32f2a now

This push adds documentation for the new ecs.loglevel setting added in #1062.

[webern]

This part of QUICKSTART-EKS.md is my fault. It's even less true now than it was at the time:

Finally, you'll need [aws-cli v1](https://aws.amazon.com/cli/) set up to interact with AWS.
(You'll need a [recent v1 release](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html#install-tool-bundled) with EKS support.)

Please update that to leave out the version number and point to the latest release.

Edit: the links are correct as-is.

[samuelkarp]

Please update that to leave out the version number and point to the latest release.

Looks like @srgothi92 is taking care of that in #1073.

[zmrow]

🚴

[samuelkarp]

⬆️ This push addresses @rothgar's comment about quoting the expression argument to jq.