Skip to content

[DOCS-14545] Add AWS Agent installation guide - #37537

Closed
buraizu wants to merge 14 commits into
masterfrom
docs14545/aws-agent-installation
Closed

[DOCS-14545] Add AWS Agent installation guide#37537
buraizu wants to merge 14 commits into
masterfrom
docs14545/aws-agent-installation

Conversation

@buraizu

@buraizu buraizu commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Fixes DOCS-14545

Documents Agent installation on Amazon EC2 directly through the AWS integration (preview). This PR includes:

  • A new setup guide at content/en/integrations/guide/aws-agent-installation.md: what the feature does, prerequisites, the required AWS permissions and why each is needed, the installation entry points, verification, and troubleshooting. Gated with private: true until the v1 rollout.
  • A new technical reference at content/en/integrations/guide/aws-agent-installation-technical-reference.md: the AWS resources Datadog creates, the installation mechanism, the security and auditing model, and the Agent lifecycle and reconciliation behavior. Aimed at platform, cloud, and security teams reviewing what runs in their AWS account. Also gated with private: true.
  • A reusable aws-agent-installation shortcode for the Agent installation IAM policy, so the same content can be reused on the main AWS integration page.
  • A "How it works" flow diagram illustrating the install flow and the trust boundary (actions run in the customer's own AWS account).

Scope

Amazon EC2 only. Support for more AWS resource types is planned, starting with EKS.

Dependencies

The companion PR DataDog/integrations-internal-core#3426 adds an Agent installation section to the main AWS integration page and consumes the aws-agent-installation shortcode from this PR. This PR should merge first.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

Do not publish before the v1 rollout. Both new pages are gated with private: true and must be un-gated together, since they cross-link.

@buraizu buraizu added the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 15, 2026
@github-actions github-actions Bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR Guide Content impacting a guide labels Jun 15, 2026
@github-actions

github-actions Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

@genesor

genesor commented Jun 17, 2026

Copy link
Copy Markdown
Member

Hey @buraizu, I think this PR is blocking local builds across branches.

_vendor/content/en/integrations/amazon-web-services.md on staging websites-sources already references {{% aws-agent-installation %}}, but the shortcode template (layouts/shortcodes/aws-agent-installation.en.md) only lives on this branch. Anyone who refreshes _vendor/ via make websites_sources_data (default FF_S3_PATH=staging) and tries make start hits:

Error: error building site: process: readAndProcessContent: "/Users/benjamin.debernardi/go/src/github.com/DataDog/documentation/_vendor/content/en/integrations/amazon-web-services.md:86:1": failed to extract shortcode: template for shortcode "aws-agent-installation" not found

Could you either land this PR (maybe with an empty shortcode content) or temporarily back out the integration content change in websites-sources until this merges? Happy to review if it helps unblock.

buraizu and others added 6 commits June 18, 2026 15:00
Rephrased prereq + Install Agents sections. Expect EKS updates, updated permissions and wording around permissions early next week!
…technical documentation coming in upcoming commit
…cument for Agent Installation, giving deep information on permissions, reasoning, and mechanism
@datadog-official

This comment has been minimized.

@buraizu buraizu added the Do Not Merge Just do not merge this PR :) label Aug 4, 2026
@jhgilbert jhgilbert added the astro-reorg-no-conflicts Needs manual conflict resolution after replatforming reorg label Aug 6, 2026
@github-actions github-actions Bot removed Architecture Everything related to the Doc backend Images Images are added/removed with this PR Guide Content impacting a guide labels Aug 6, 2026
@buraizu buraizu added editorial review Waiting on a more in-depth review and removed WORK IN PROGRESS No review needed, it's a wip ;) Do Not Merge Just do not merge this PR :) astro-reorg-no-conflicts Needs manual conflict resolution after replatforming reorg labels Aug 10, 2026
@buraizu
buraizu marked this pull request as ready for review August 10, 2026 18:50
@buraizu
buraizu requested a review from a team as a code owner August 10, 2026 18:50
@buraizu

buraizu commented Aug 10, 2026

Copy link
Copy Markdown
Contributor Author

Closing in favor of #39078. The documentation repo re-org moved content/, layouts/, and static/ under a hugo/ prefix, so this PR's file paths no longer exist. #39078 recreates the identical content at the new locations.

@buraizu buraizu closed this Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants