-
-
Notifications
You must be signed in to change notification settings - Fork 128
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
feat: add essential Kafka client security config #447
Conversation
This commit updates the HTML generated by the react template so that it includes essential Kafka config required for clients. This makes it easier for someone using HTML docs generated from AsyncAPI docs to get started creating a Kafka client. Signed-off-by: Dale Lane <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Welcome to AsyncAPI. Thanks a lot for creating your first pull request. Please check out our contributors guide and the instructions about a basic recommended setup useful for opening a pull request.
Keep in mind there are also other channels you can use to interact with AsyncAPI community. For more details check out this issue.
inspired by a discussion on Slack similar to a pull request I created for markdown-template |
Example output: asyncapi: '2.2.0'
info:
title: Streetlights Kafka API
version: '1.0.0'
description: |
The Smartylighting Streetlights API allows you to remotely manage the city lights.
servers:
test:
url: test.mykafkacluster.org:8092
protocol: kafka
description: Test broker results in this from |
Example output: asyncapi: '2.2.0'
info:
title: Streetlights Kafka API
version: '1.0.0'
description: |
The Smartylighting Streetlights API allows you to remotely manage the city lights.
servers:
test:
url: test.mykafkacluster.org:8092
protocol: kafka-secure
description: Test broker results in this from |
Example output: asyncapi: '2.2.0'
info:
title: Streetlights Kafka API
version: '1.0.0'
description: |
The Smartylighting Streetlights API allows you to remotely manage the city lights.
servers:
test:
url: test.mykafkacluster.org:8092
protocol: kafka-secure
description: Test broker
security:
- saslScram: []
components:
securitySchemes:
saslScram:
type: scramSha256
description: create credentials in the dev portal results in this from |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@dalelane Thanks for contribution! I'm not an expert in security and thanks for rendering it the way it needs to be. For 2.1
I just rendered new security types, so thank you!
Please refer to my suggestions, overall good, but we can improve some parts :)
Signed-off-by: Dale Lane <[email protected]>
Styling improvement requested in review Co-authored-by: Maciej Urbańczyk <[email protected]>
Thanks for the review! I've added commits to address the bits you caught. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM! Thanks for contribution!
@dalelane Sorry, we have a problem 😅 Could you run lint npm run lint:fix
to fix linter errors and push changes? While pushing the suggestions I forgot that there might be a problem with the linter. And sorry for the delay with the second review.
Signed-off-by: Dale Lane <[email protected]>
Kudos, SonarCloud Quality Gate passed! |
@all-contributors please add @dalelane for code, ideas |
I've put up a pull request to add @dalelane! 🎉 |
🎉 This PR is included in version 1.0.0-next.21 🎉 The release is available on: Your semantic-release bot 📦🚀 |
This commit updates the HTML generated by the react template
so that it includes essential Kafka config required for clients.
This makes it easier for someone using HTML docs generated from
AsyncAPI docs to get started creating a Kafka client.
Signed-off-by: Dale Lane [email protected]