Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,14 @@
** xref:mcp:test-tools.adoc[Test a server's tools]
** xref:mcp:managed/index.adoc[Managed catalog]
*** xref:mcp:managed/managed-catalog.adoc[Catalog reference]
*** xref:mcp:managed/bamboohr.adoc[BambooHR]
*** xref:mcp:managed/sql.adoc[SQL]
*** xref:mcp:managed/kafka.adoc[Kafka]
*** xref:mcp:managed/slack.adoc[Slack]
*** xref:mcp:managed/ironclad.adoc[Ironclad]
*** xref:mcp:managed/jira.adoc[Jira]
*** xref:mcp:managed/metabase.adoc[Metabase]
*** xref:mcp:managed/netsuite.adoc[NetSuite]
*** xref:mcp:managed/openapi.adoc[OpenAPI]
*** xref:mcp:managed/ramp.adoc[Ramp]
*** xref:mcp:managed/workday.adoc[Workday]
Expand Down
2 changes: 1 addition & 1 deletion modules/agents/pages/byoa-register.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -176,7 +176,7 @@ The symptom-driven checks in this section cover the three observable parts of th
// TODO: replace once standalone-ADP issuer / audience values are confirmed.
|===

== Out of scope
== Limitations

This page does not cover:

Expand Down
2 changes: 1 addition & 1 deletion modules/ai-gateway/pages/configure-provider.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -346,7 +346,7 @@ A list/grid view toggle in the top-right switches between table and card layouts

// TODO: add screenshots of common error toasts once captured from the live environment.

== Out of scope
== Limitations

AI Gateway does not provide these capabilities. For current status, consult the ADP release notes.

Expand Down
2 changes: 1 addition & 1 deletion modules/ai-gateway/pages/overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ It is not the right fit when you:
* Need routing, failover, or cross-provider load balancing across providers. AI Gateway does not provide these capabilities.

[[out-of-scope]]
== Out of scope
== Limitations

AI Gateway does not provide these capabilities. For current status, consult the ADP release notes.

Expand Down
68 changes: 65 additions & 3 deletions modules/get-started/pages/byoc-prereqs.adoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,67 @@
= ADP BYOC Prerequisites
:description: Requirements for deploying Redpanda ADP in your own cloud environment.
= ADP BYOC prerequisites
:description: Requirements for running Redpanda ADP on Redpanda Cloud BYOC clusters on AWS.
:page-topic-type: reference
:personas: platform_admin
:page-byoc: true
:learning-objective-1: Identify the AWS BYOC requirements for ADP
:learning-objective-2: Identify the ADP enablement and IAM resource patterns required by Crossplane

// TODO: Add content
// Source: `cloudv2` `terraform/provisioners/aws-redpanda-applications/*.tf`, `adp/manifests/CLAUDE.md`, and BYOC support partials, verified 2026-05-10.
// TODO: Confirm the Redpanda Cloud UI label and status indicator for ADP enablement after an authenticated Cloud walkthrough.

ADP on BYOC uses Redpanda Cloud BYOC infrastructure on AWS. Use this reference to confirm the requirements before you create ADP resources on a BYOC cluster.

Use this reference to:

* [ ] {learning-objective-1}
* [ ] {learning-objective-2}

== Supported cluster shape

include::partial$byoc-aws-requirement.adoc[]

The requirements are:

* Redpanda Cloud BYOC on AWS
* ADP enabled for the cluster (controlled by `adp_enabled` in the BYOC provisioner source)

== About Crossplane

Crossplane is a Kubernetes add-on that manages cloud resources declaratively. Each cloud resource (an IAM role, an RDS instance, a KMS key) is represented as a Kubernetes custom resource, and Crossplane's AWS provider reconciles those resources against your AWS account.

When ADP is enabled, the BYOC provisioner installs Crossplane in your cluster and attaches an IAM policy that grants it permission to create the cloud resources ADP needs. If your organization restricts IAM in your AWS account, the IAM patterns in the next section are the resource names Crossplane must be allowed to create on Redpanda's behalf.

== AWS IAM resource patterns

If your organization customizes BYOC IAM policies, include both AI Gateway and ADP resource name patterns so Crossplane can manage the resources ADP requires.

[cols="1,3"]
|===
|Resource kind |Required pattern

|IAM roles
|`arn:aws:iam::<account-id>:role/aigw-<redpanda-id>*` and `arn:aws:iam::<account-id>:role/adp-<redpanda-id>*`

|IAM policies
|`arn:aws:iam::<account-id>:policy/aigw-<redpanda-id>*` and `arn:aws:iam::<account-id>:policy/adp-<redpanda-id>*`

|Role policy attachments
|Attachments for roles matching `aigw-<redpanda-id>*` and `adp-<redpanda-id>*`, with policy ARNs matching the same AI Gateway and ADP policy patterns.
|===

The Crossplane policy also includes permissions for ADP-managed RDS, ElastiCache, KMS, and security-group resources. If your organization customizes the policy, keep those service permissions aligned with the Redpanda-provided BYOC policy.

== ADP components

When `adp_enabled` is set, the source provisions ADP components in the cluster, including:

* The `adp` Kubernetes namespace
* Crossplane resources for ADP infrastructure
* ADP PostgreSQL resources
* AI Gateway
* ADP API

== Next steps

* xref:get-started:byoc-quickstart.adoc[Start the ADP BYOC quickstart]
* xref:redpanda-cloud:get-started:cluster-types/byoc/aws/create-byoc-cluster-aws.adoc[Create a BYOC cluster on AWS] in Redpanda Cloud docs
36 changes: 33 additions & 3 deletions modules/get-started/pages/byoc-quickstart.adoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,35 @@
= ADP BYOC Quickstart
:description: Get started with Redpanda ADP in your own cloud environment.
= ADP BYOC quickstart
:description: Start with ADP on a Redpanda Cloud BYOC cluster on AWS.
:page-topic-type: how-to
:personas: platform_admin
:page-byoc: true
:learning-objective-1: Check that a BYOC cluster meets the ADP prerequisites
:learning-objective-2: Continue from BYOC cluster setup into ADP provider, MCP, and agent setup

// TODO: Add content
// Source: `cloudv2` BYOC Terraform and Redpanda Cloud BYOC docs source, verified 2026-05-10.
// TODO: Add click-by-click ADP BYOC setup steps after a UI walkthrough.

This quickstart helps you start ADP on a Redpanda Cloud BYOC cluster on AWS.

Use this guide to:

* [ ] {learning-objective-1}
* [ ] {learning-objective-2}

== Prerequisites

Review xref:get-started:byoc-prereqs.adoc[ADP BYOC prerequisites].

== Create or select a BYOC cluster on AWS

Use a Redpanda Cloud BYOC cluster on AWS. For the general AWS BYOC cluster creation flow, see xref:redpanda-cloud:get-started:cluster-types/byoc/aws/create-byoc-cluster-aws.adoc[Create a BYOC cluster on AWS].

Before you configure ADP resources, confirm that ADP is enabled for the cluster. The provisioner switch is `adp_enabled`.

== Continue with ADP setup

After the BYOC cluster meets the prerequisites, continue with the ADP setup guides:

. xref:ai-gateway:configure-provider.adoc[Configure your LLM provider]
. xref:mcp:create-server.adoc[Create an MCP server]
. xref:agents:create-agent.adoc[Create a declarative agent]
Loading