feat(DOC-1970): add missing rpk connect reference pages #1608
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,33 @@ | ||
| = rpk connect agent init | ||
| :description: Initialize a Redpanda Connect agent. | ||
|
|
||
| [IMPORTANT] | ||
| ==== | ||
| This command is experimental and subject to change. | ||
| ==== | ||
|
|
||
| Initialize a template for building a Redpanda Connect agent. | ||
|
|
||
| == Usage | ||
|
|
||
| rpk connect agent init [OPTIONS] | ||
|
|
||
| == Example | ||
|
|
||
| [,bash] | ||
| ---- | ||
| rpk connect agent init ./repo | ||
| ---- | ||
|
|
||
| == Options | ||
|
Contributor
There was a problem hiding this comment. No change required for this PR, but I wanted to note that the other rpk connect pages use a "Flags" heading (example). This might have to do with our reference automation tool, could be worth raising a separate ticket to look into. |
||
|
|
||
| [cols="1m,2a"] | ||
| |=== | ||
| | Option | Description | ||
|
|
||
| | --name | ||
| | The name of the agent. | ||
|
|
||
| | --help, -h | ||
| | Show help for the command. | ||
| |=== | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,36 @@ | ||||||
| = rpk connect agent run | ||||||
| :description: Execute a Redpanda Connect agent as part of a pipeline with MCP tool access. | ||||||
|
|
||||||
| [IMPORTANT] | ||||||
| ==== | ||||||
| This command is experimental and subject to change. | ||||||
| ==== | ||||||
|
|
||||||
| Execute a Redpanda Connect agent as part of a pipeline that has access to tools via the MCP (Model Context Protocol). Each resource in the `mcp` subdirectory creates tools that can be used, then the `redpanda_agents.yaml` file along with Python agent modules are invoked. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
The second sentence is a bit unclear to me, so here's a suggestion to rephrase -- @mmatczuk please let us know if the rephrase is correct. |
||||||
|
|
||||||
| == Usage | ||||||
|
|
||||||
| rpk connect agent run [OPTIONS] | ||||||
|
|
||||||
| == Example | ||||||
|
|
||||||
| [,bash] | ||||||
| ---- | ||||||
| rpk connect agent run ./repo | ||||||
| ---- | ||||||
|
|
||||||
| == Options | ||||||
|
|
||||||
| [cols="1m,2a"] | ||||||
| |=== | ||||||
| | Option | Description | ||||||
|
|
||||||
| | --secrets env: | ||||||
|
Contributor
There was a problem hiding this comment. Based on the description, if |
||||||
| | Attempt to load secrets from a provided URN. If more than one entry is specified, they are attempted in order until a value is found. Environment variable lookups are specified with the URN `env:`, which by default is the only entry. To disable all secret lookups, specify a single entry of `none:` (default: `env:`). | ||||||
|
|
||||||
| | --redpanda-license | ||||||
| | Provide an explicit Redpanda License, which enables enterprise functionality. By default, licenses found at the path `/etc/redpanda/redpanda.license` are applied. | ||||||
|
|
||||||
| | --help, -h | ||||||
| | Show help for the command. | ||||||
| |=== | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,29 @@ | ||||||
| = rpk connect agent | ||||||
| :description: Redpanda Connect agent commands. | ||||||
|
|
||||||
| [IMPORTANT] | ||||||
| ==== | ||||||
| This command is experimental and subject to change. | ||||||
| ==== | ||||||
|
|
||||||
| Run and initialize Redpanda Connect agents. Agents are pipelines that have access to tools via the MCP (Model Context Protocol) and can interact with AI models. | ||||||
|
|
||||||
| == Usage | ||||||
|
|
||||||
| rpk connect agent [command] | ||||||
|
|
||||||
| == Subcommands | ||||||
|
|
||||||
| * xref:rpk/rpk-connect/rpk-connect-agent-init.adoc[init]: Initialize a Redpanda Connect agent. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| * xref:rpk/rpk-connect/rpk-connect-agent-run.adoc[run]: Execute a Redpanda Connect agent as part of a pipeline with MCP tool access. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| * help, h: Show a list of commands or help for one command. | ||||||
|
|
||||||
| == Options | ||||||
|
|
||||||
| [cols="1m,2a"] | ||||||
| |=== | ||||||
| | Option | Description | ||||||
|
|
||||||
| | --help, -h | ||||||
| | Show help for the command. | ||||||
| |=== | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,37 @@ | ||||||
| = rpk connect dry-run | ||||||
| :description: Parse Redpanda Connect configs and test the connections of each plugin. | ||||||
|
|
||||||
| Parse Redpanda Connect configs and test the connections of each plugin. Exits with a status code of `1` if any connection errors are detected. | ||||||
|
|
||||||
| == Usage | ||||||
|
|
||||||
| rpk connect dry-run [command options] | ||||||
|
|
||||||
| == Example | ||||||
|
|
||||||
| [,bash] | ||||||
| ---- | ||||||
| rpk connect dry-run ./foo.yaml | ||||||
|
Contributor
There was a problem hiding this comment. Could we give the yaml file a name more descriptive than |
||||||
| ---- | ||||||
|
|
||||||
| == Options | ||||||
|
|
||||||
| [cols="1m,2a"] | ||||||
| |=== | ||||||
| | Option | Description | ||||||
|
|
||||||
| | --verbose | ||||||
| | Print the lint result for each target file (default: false). | ||||||
|
|
||||||
| | --secrets env: | ||||||
|
|
||||||
| | Attempt to load secrets from a provided URN. If more than one entry is specified, they are attempted in order until a value is found. Environment variable lookups are specified with the URN `env:`, which by default is the only entry. To disable all secret lookups, specify a single entry of `none:` (default: `env:`). | ||||||
|
|
||||||
| | --env-file, -e | ||||||
| | Import environment variables from a dotenv file. | ||||||
|
|
||||||
| | --redpanda-license | ||||||
| | Provide an explicit Redpanda License, which enables enterprise functionality. By default, licenses found at the path `/etc/redpanda/redpanda.license` are applied. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
|
|
||||||
| | --help, -h | ||||||
| | Show help for the command. | ||||||
| |=== | ||||||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| = rpk connect plugin init | ||
| :description: Create the boilerplate for a custom Redpanda Connect plugin. | ||
|
|
||
| [IMPORTANT] | ||
| ==== | ||
| This command is experimental and subject to change. | ||
| ==== | ||
|
|
||
| Generate a project on the local filesystem that can be used as a starting point for building a custom component for Redpanda Connect. Existing files in the specified directory are overwritten. | ||
|
|
||
| == Usage | ||
|
|
||
| rpk connect plugin init [OPTIONS] | ||
|
|
||
| == Options | ||
|
|
||
| [cols="1m,2a"] | ||
| |=== | ||
| | Option | Description | ||
|
|
||
| | --language, --lang | ||
| | The programming language for the plugin. Supported languages are `golang` and `python` (default: `python`). | ||
|
|
||
| | --component | ||
| | The type of component to generate. Supported components are `input`, `output`, and `processor` (default: `processor`). | ||
|
|
||
| | --help, -h | ||
| | Show help for the command. | ||
| |=== |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,28 @@ | ||||||
| = rpk connect plugin | ||||||
| :description: Plugin management commands for Redpanda Connect. | ||||||
|
|
||||||
| [IMPORTANT] | ||||||
| ==== | ||||||
| This command is experimental and subject to change. | ||||||
| ==== | ||||||
|
|
||||||
| Manage custom Redpanda Connect plugins. Use these commands to scaffold and build custom components. | ||||||
|
|
||||||
| == Usage | ||||||
|
|
||||||
| rpk connect plugin [command] | ||||||
|
|
||||||
| == Subcommands | ||||||
|
|
||||||
| * xref:rpk/rpk-connect/rpk-connect-plugin-init.adoc[init]: Create the boilerplate for a custom component plugin. | ||||||
|
Contributor
There was a problem hiding this comment.
Suggested change
|
||||||
| * help, h: Show a list of commands or help for one command. | ||||||
|
|
||||||
| == Options | ||||||
|
|
||||||
| [cols="1m,2a"] | ||||||
| |=== | ||||||
| | Option | Description | ||||||
|
|
||||||
| | --help, -h | ||||||
| | Show help for the command. | ||||||
| |=== | ||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.