Skip to content

docs(sensei): clarify Bedrock ambient identity only applies on AWS - #15889

Merged
Maffooch merged 1 commit into
bugfixfrom
docs/sensei-bedrock-ambient-identity
Sep 9, 2026
Merged

docs(sensei): clarify Bedrock ambient identity only applies on AWS#15889
Maffooch merged 1 commit into
bugfixfrom
docs/sensei-bedrock-ambient-identity

Conversation

@Maffooch

@Maffooch Maffooch commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

[sc-15209]

Description

Clarify the Amazon Bedrock "ambient AWS identity" guidance on the Sensei → AI Model Settings docs page.

The page tells operators to leave the AWS keys blank to use the engine's ambient identity, but that only yields credentials when the Sensei engine actually runs inside AWS with an attached role. This makes the per-runtime story explicit and adds a callout for on-prem / non-AWS deployments, so a self-hosted operator isn't left thinking Bedrock will "just work" without keys.

What changed (docs/content/sensei/ai_model_settings.md)

  • The ambient-identity path now lists each AWS runtime explicitly:
    • EKS — an IRSA or EKS Pod Identity role bound to the engine's service account.
    • ECS — the task role.
    • EC2, including a Docker Compose host on an EC2 instance — the instance profile, with a note that IMDSv2's default hop limit of 1 blocks a metadata request from inside a container, so it must be set to 2.
    • Lambda — the execution role.
  • New callout: on-prem / non-AWS deployments (a non-EKS Kubernetes cluster or a Docker Compose host in your own data center) have no ambient identity, so static AWS keys are required there.

Docs-only. Renders as plain Markdown (a blockquote callout — no custom shortcode), companion to the Pro AI Model Settings change that surfaces the same guidance in the UI.

🤖 Generated with Claude Code

The AI Model Settings page says to leave the AWS keys blank to use the engine's
ambient identity, but that only yields credentials when the Sensei engine runs
inside AWS with an attached role. Spell out the per-runtime story (EKS IRSA/Pod
Identity, ECS task role, EC2 instance profile — incl. the IMDSv2 hop-limit=2
gotcha for containers, Lambda), and add a callout that on-prem / non-AWS
deployments (non-EKS k8s, Docker Compose in a data center) have no ambient
identity and must enter static keys.

Companion to the dojo-pro AI Model Settings change.
@Maffooch Maffooch added this to the 3.4.0 milestone Sep 8, 2026
@github-actions github-actions Bot added the docs label Sep 8, 2026
@Maffooch Maffooch modified the milestones: 3.4.0, 3.3.1 Sep 9, 2026
@Maffooch
Maffooch changed the base branch from dev to bugfix September 9, 2026 14:26
@Maffooch
Maffooch added this pull request to the merge queue Sep 9, 2026
Merged via the queue into bugfix with commit c7c1bb9 Sep 9, 2026
31 checks passed
@Maffooch
Maffooch deleted the docs/sensei-bedrock-ambient-identity branch September 9, 2026 15:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants