Skip to content

Add docs for AWS Cloudmap and Nameformat name resolution components #4694

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: v1.16
Choose a base branch
from

Conversation

jmenziessmith
Copy link

@jmenziessmith jmenziessmith commented Jun 26, 2025

Thank you for helping make the Dapr documentation better!

Please follow this checklist before submitting:

  • Commits are signed with Developer Certificate of Origin (DCO - learn more)
  • Read the contribution guide
  • Commands include options for Linux, MacOS, and Windows within codetabs
  • New file and folder names are globally unique
  • Page references use shortcodes instead of markdown or URL links
  • Images use HTML style and have alternative text
  • Places where multiple code/command options are given have codetabs

In addition, please fill out the following to help reviewers understand this pull request:

Description

Add docs supporting the new AWS Cloudmap and Nameformat name resolution components

Issue reference

Please reference the issue this PR will close: #4695

Signed-off-by: Jon Menzies-Smith <github@menzies-smith.co.uk>
Signed-off-by: Jon Menzies-Smith <github@menzies-smith.co.uk>
@jmenziessmith jmenziessmith requested review from a team as code owners June 26, 2025 16:55
@msfussell msfussell added the waiting-on-code-pr The code PR needs to be merged before the docs are updated label Jul 2, 2025
@msfussell msfussell added this to the 1.16 milestone Jul 2, 2025
Copy link
Member

@msfussell msfussell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jmenziessmith - Amazing contribution. Edits mostly to keep consistency.
Also you will to update dapr/docs/daprdocs/data/components/name_resolution/generic.yaml for the nameformat component and add a new file called dapr/docs/daprdocs/data/components/name_resolution/aws.yaml for Cloudmap component so that these appear in the https://docs.dapr.io/reference/components-reference/supported-name-resolution/ section
In both cases the since will be 1.16 with a v1 version.

spec:
nameResolution:
component: "aws.cloudmap"
configuration:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this have a version field? If not, I suggest that you add one. See SQLLite NR component as an example

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated


### Configuration Options

| Property | Type | Required | Default | Description |
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To keep this consistent with the rest of the docs can you rename and reorder the columns as

Field | Required | Type | Default | Details |

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated



## Example Usage

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Name resolution is configured via the [Dapr Configuration]({{< ref configuration-overview.md >}}). Here are some examples of its usage.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated

The Name Format name resolver provides a flexible way to resolve service names using a configurable format string with placeholders. This is useful in scenarios where you want to map service names to predictable DNS names following a specific pattern.

## Configuration Format

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Name resolution is configured via the [Dapr Configuration]({{< ref configuration-overview.md >}}).

Within the configuration YAML, set the spec.nameResolution.component property to "nameformat", then pass configuration options in the spec.nameResolution.configuration dictionary.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated

jmenziessmith and others added 3 commits July 3, 2025 11:26
Co-authored-by: Mark Fussell <markfussell@gmail.com>
Signed-off-by: Jon Menzies-Smith <github@menzies-smith.co.uk>
Signed-off-by: Jon Menzies-Smith <github@menzies-smith.co.uk>
@jmenziessmith
Copy link
Author

@jmenziessmith - Amazing contribution. Edits mostly to keep consistency. Also you will to update dapr/docs/daprdocs/data/components/name_resolution/generic.yaml for the nameformat component and add a new file called dapr/docs/daprdocs/data/components/name_resolution/aws.yaml for Cloudmap component so that these appear in the https://docs.dapr.io/reference/components-reference/supported-name-resolution/ section In both cases the since will be 1.16 with a v1 version.

@msfussell Thanks for the review , I have added the data and made the other recommended changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
waiting-on-code-pr The code PR needs to be merged before the docs are updated
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants