Skip to content

[codex] Clarify AWS Batch KMS requirements#1271

Draft
llewellyn-sl wants to merge 2 commits intomasterfrom
EDU-1105-docs-draft
Draft

[codex] Clarify AWS Batch KMS requirements#1271
llewellyn-sl wants to merge 2 commits intomasterfrom
EDU-1105-docs-draft

Conversation

@llewellyn-sl
Copy link
Copy Markdown
Contributor

Summary

  • clarify the AWS Batch docs for accounts that enforce customer-managed default EBS encryption
  • document the required KMS permissions on the EC2 instance role and the Auto Scaling service-linked role dependency in the KMS key policy
  • keep the update scoped to the existing platform-cloud AWS Batch setup pages instead of creating a new troubleshooting page

Source

Doc target

  • platform-cloudplatform-cloud/docs/compute-envs/aws-batch.md
  • platform-cloudplatform-cloud/docs/enterprise/advanced-topics/manual-aws-batch-setup.mdx

Rationale

The ticket points to a recurring setup failure where AWS Batch instances remain stuck because the docs mention encryption broadly but do not spell out the customer-managed KMS key requirements for default EBS encryption. These edits add the missing guidance exactly where operators configure the instance role and Batch environment.

Validation

  • File-level validation confirming the new KMS guidance is present in both pages
  • Full Docusaurus build not run in this environment because node_modules are not available in the automation clone

Follow-up questions / gaps

  • If this issue keeps recurring, the next step would be a dedicated troubleshooting section for common AWS Batch instance launch failures, but this draft keeps the change minimal and directly actionable.

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 3, 2026

Deploy Preview for seqera-docs failed. Why did it fail? →

Name Link
🔨 Latest commit 28f42d7
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/69d7c87f2d0483000846ab96

@justinegeffen justinegeffen requested a review from robsyme April 9, 2026 15:40
@justinegeffen justinegeffen added 1. Editor review Needs a language review 1. Dev/PM/SME Needs a review by a Dev/PM/SME labels Apr 9, 2026
@justinegeffen
Copy link
Copy Markdown
Contributor

@llewellyn-sl, does this PR output include the details from Drew's comment in the Jira issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1. Dev/PM/SME Needs a review by a Dev/PM/SME 1. Editor review Needs a language review codex codex-automation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants