Skip to content
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

Extension: fix pointer error #1323

Merged
merged 1 commit into from
Apr 20, 2023

Conversation

Alice-Lilith
Copy link
Member

previously I was under the false impression that despite the linter warning about an ineffectual assignment that things were working as intended. This was because the test cases directly operated on passed-in pointers instead of ensuring that the returned pointer was being used.

I added a new func copyPtr() func to assist with the copying of xDS resource pointer fields instead of doing the following because of the mutex copy.

*x = *y

I don't like how copyPtr() exists twice in two different files and would like to move it to a helpers/utils file/package. All the existing helpers/utils files seem pretty package specific so I didn't think it would fit in any of them. I might just make a more general/top-level utils package and move it there so let me know if you're a +1/-1 on that plan or if you have a better idea for where this helper func can live.

@Alice-Lilith Alice-Lilith requested a review from a team as a code owner April 17, 2023 15:30
// Overwrite the pointer for the original virtual host.
// Uses nolint because of the ineffectual assignment check
vHost = modifiedVH //nolint
copyPtr(modifiedVH, vHost)
Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Member Author

Choose a reason for hiding this comment

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

I used it to get rid of the duplicated function in the testutils functions since those setup new variables, but it won't work for this file since it returns a value, so you end up in the same scenario I described where *x = *y and *x = *proto.Clone(y) cause lint errors because of the mutex inside all the xDS resource messages, and doing x = proto.Clone(y) results in x not really getting updated outside of the function since it's a local variable.

I was looking at proto.Merge as a potential solution, but unfortunately that won't work either since if you don't .Reset() the initial Route/VirtualHost first, then Merge() results in all the fields that are lists (like add request headers) getting duplicate entries. If you do call .Reset() on the Route/VirtualHost first, then proto.Merge() does nothing since it only merges fields that are set on the source and dest.

@@ -53,9 +55,7 @@ func processExtensionPostRouteHook(route *routev3.Route, vHost *routev3.VirtualH

// If the extension returned a modified Route, then copy its to the one that was passed in as a reference
if modifiedRoute != nil {
// Overwrite the pointer for the original route.
// Uses nolint because of the ineffectual assignment check
route = modifiedRoute //nolint
Copy link
Member

@Xunzhuo Xunzhuo Apr 18, 2023

Choose a reason for hiding this comment

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

why not just ?

*route = *modifiedRoute

And

*vHost = *modifiedVH

Copy link
Member Author

Choose a reason for hiding this comment

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

This is what I initially wanted to do, but unfortunately it causes a lint error because all the xDS resources have mutexes in the message state fields 😅

copylocks: assignment copies lock value to *route: github.com/envoyproxy/go-control-plane/envoy/config/route/v3.Route contains google.golang.org/protobuf/internal/impl.MessageState contains sync.Mutex

previously I was under the false impression that despite the linter
warning about an innefectual assignment that things were working as
intended. This was because the test cases directly operated on passed in
pointers instead of ensuring that the returned pointer was being used.

Signed-off-by: AliceProxy <alicewasko@datawire.io>
@Alice-Lilith Alice-Lilith force-pushed the alicewasko/extension-logic-error branch from 69ddd23 to 2236152 Compare April 19, 2023 17:41
@codecov
Copy link

codecov bot commented Apr 19, 2023

Codecov Report

Merging #1323 (2236152) into main (7a116c9) will decrease coverage by 0.29%.
The diff coverage is 40.00%.

@@            Coverage Diff             @@
##             main    #1323      +/-   ##
==========================================
- Coverage   61.94%   61.65%   -0.29%     
==========================================
  Files          85       85              
  Lines       10854    10871      +17     
==========================================
- Hits         6723     6703      -20     
- Misses       3688     3717      +29     
- Partials      443      451       +8     
Impacted Files Coverage Δ
internal/xds/translator/extension.go 74.04% <40.00%> (-9.29%) ⬇️

... and 2 files with indirect coverage changes

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@Alice-Lilith
Copy link
Member Author

@arkodg I know you approved, but since codecov/patch failed I'm happy to add individual coverage for the func deepCopyPtr() I added by moving it into the utils package at /internal/xds/utils/utils.go (I didn't initially do that since I don't think it's really an "xDS themed" util function, nor do I think it needs to be exported) or by adding tests in translator_test.go (wouldn't really fit the theme with testing translation bits). Lmk if you have any thoughts.

@arkodg
Copy link
Contributor

arkodg commented Apr 19, 2023

I'm fine with this going in, I believe there are tests testing this diff

@arkodg arkodg added this to the 0.4.0 milestone Apr 20, 2023
@Xunzhuo Xunzhuo merged commit 2bf9607 into envoyproxy:main Apr 20, 2023
Alice-Lilith pushed a commit that referenced this pull request Apr 24, 2023
(cherry picked from commit 2bf9607)
Signed-off-by: AliceProxy <alicewasko@datawire.io>
Alice-Lilith pushed a commit that referenced this pull request Apr 24, 2023
* Extension: fix pointer error (#1323)

(cherry picked from commit 2bf9607)
Signed-off-by: AliceProxy <alicewasko@datawire.io>

* fix: add the namespace resource within helm templates (#1332)

Add the namespace resource within helm templates

This is unfortunate workaround due the difference in
UX between `helm template` and `helm install`
The project recommends `helm install` as a way to install
EG which supports a `--create-namespace` flag to create a namespace
However we also generate a static YAML using `helm template` as part of
the release artficat so a user can install the YAML directly using
`kubectl` instead of `helm` . The issue here is `helm template` does
not support `--create-namespace`, so instead this commit adds a knob
called `createNamespace` to the Helm chart which is `false` by default,
but turned on during `make generate-manifests`

Fixes: #1307

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
(cherry picked from commit 9d6d699)
Signed-off-by: AliceProxy <alicewasko@datawire.io>

---------

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: AliceProxy <alicewasko@datawire.io>
Co-authored-by: Arko Dasgupta <arkodg@users.noreply.github.com>
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