Skip to content

docs: first pass at documenting how to add extensions#11540

Merged
htuch merged 6 commits into
envoyproxy:masterfrom
alyssawilk:extensions
Jun 19, 2020
Merged

docs: first pass at documenting how to add extensions#11540
htuch merged 6 commits into
envoyproxy:masterfrom
alyssawilk:extensions

Conversation

@alyssawilk
Copy link
Copy Markdown
Contributor

This includes enhancing the script failures to leave breadcrumbs for devs who miss the new docs.

Risk Level: n/a (tooling / docs)
Testing: manual testing removing files from #11327
Docs Changes: yes
Release Notes: no

Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
Copy link
Copy Markdown
Member

@htuch htuch left a comment

Choose a reason for hiding this comment

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

Thanks for adding this! A few nits/suggestions.
/wait

Comment thread CONTRIBUTING.md Outdated

# Adding new extensions

For developers adding a new extension, one can largely model off of existing extensions.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
For developers adding a new extension, one can largely model off of existing extensions.
For developers adding a new extension, one can take an existing extension as the starting point.

Comment thread CONTRIBUTING.md
`source/extensions/area/plugin`, and include an envoy_cc_extension with the
configuration and tagged with the appropriate security posture, and an
envoy_cc_library with the code.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
Comment thread CONTRIBUTING.md Outdated
For developers adding a new extension, one can take an existing extension as the starting point.

Extension configuration should be located in a directory structure like
`api/envoy/extensions/area/plugin/`, for example `api/envoy/extensions/tracers/zipkin/`
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Let's use other extension as examples other than tracers, they only have v4alpha which might be confusing.

Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
@alyssawilk
Copy link
Copy Markdown
Contributor Author

@htuch I miss anything or is this good to go?

Copy link
Copy Markdown
Member

@htuch htuch left a comment

Choose a reason for hiding this comment

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

Looks good, just one nit.

Comment thread CONTRIBUTING.md Outdated
Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
@alyssawilk
Copy link
Copy Markdown
Contributor Author

Nit should be addressed!

Copy link
Copy Markdown
Member

@htuch htuch left a comment

Choose a reason for hiding this comment

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

LGTM, thanks!

@htuch htuch merged commit 983599a into envoyproxy:master Jun 19, 2020
songhu pushed a commit to songhu/envoy that referenced this pull request Jun 25, 2020
This includes enhancing the script failures to leave breadcrumbs for devs who miss the new docs.

Risk Level: n/a (tooling / docs)
Testing: manual testing removing files from envoyproxy#11327
Docs Changes: yes
Release Notes: no

Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
yashwant121 pushed a commit to yashwant121/envoy that referenced this pull request Jul 24, 2020
This includes enhancing the script failures to leave breadcrumbs for devs who miss the new docs.

Risk Level: n/a (tooling / docs)
Testing: manual testing removing files from envoyproxy#11327
Docs Changes: yes
Release Notes: no

Signed-off-by: Alyssa Wilk <alyssar@chromium.org>
Signed-off-by: yashwant121 <yadavyashwant36@gmail.com>
@alyssawilk alyssawilk deleted the extensions branch September 30, 2020 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants