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

xds: a myriad of cleanups #4479

Closed
wants to merge 1 commit into from
Closed

xds: a myriad of cleanups #4479

wants to merge 1 commit into from

Conversation

dfawley
Copy link
Member

@dfawley dfawley commented May 21, 2021

The first commit is branched from #4476

  • mv xds/internal/client xds/internal/xdsclient
    • most import aliased to xdsclient; those that didn't were confusing. Some double imported because of this (cdsbalancer_test.go and eds_impl_test.go, maybe others).
  • remove Interface from the names of some interfaces. Types aren't supposed to be named by their types, generally.
  • standardize xds balancer receivers to b
  • standardize xds balancer xds client field names to xdsClient (was: xdsC or client in some)
  • made balancer builders that didn't have fields register by value instead of pointer; removed receiver vars

RELEASE NOTES: none

@dfawley dfawley changed the title xds: add test-only injection of xds config to client and server xds: a myriad of cleanups May 21, 2021
@dfawley dfawley force-pushed the cleanups branch 2 times, most recently from 21296fb to d6f1d66 Compare May 21, 2021 23:30
@sergiitk
Copy link
Member

I love this title.

@@ -408,9 +409,6 @@ func (b *cdsBalancer) run() {
b.edsLB.Close()
b.edsLB = nil
}
if newXDSClient != nil {
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this an intended change, or merge conflict?

Copy link
Contributor

@menghanl menghanl Jun 3, 2021

Choose a reason for hiding this comment

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

I think I know why this change is here.

I would say don't make this change, or at least, don't mix it in this XL PR.

And it's an incomplete test cleanup. It leaves the balancers in an inconsistent state (if the balancer creates the client, it should call close, even though we know close is a noop)

And it only changes the easy part, but leaves the hard part behind. We should modify the tests to use attributes to pass the fake xDS client, so we can completely get rid of newXDSClient.
But that's going to be a semi big change, it requires changing signature of xds.SetClient() to take an interface instead of *Client, so it can be the fakeClient.

I will make it, I need it to fix the tests in my other PR.

Copy link
Member Author

Choose a reason for hiding this comment

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

And it's an incomplete test cleanup. It leaves the balancers in an inconsistent state (if the balancer creates the client, it should call close, even though we know close is a noop)

It's for tests only, so I don't think it's important to call Close only for tests, which don't need it to be called. Many types don't need a Close method to be called when they're done being used. Our xdsClient interface is one of those.

You could also consider this half of the cleanup (removing the method from the interface and the call to it in b.Close), with the other half being changing how it's injected. I can add all this back if you want, but I do see it as a step in the right direction.

Copy link
Contributor

Choose a reason for hiding this comment

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

I still think this doesn't give us enough benefit, to justify itself.
At least should not be mixed in a 84-file (trivial) change PR.
This diff really stick out when I was scanning the changes.

Copy link
Contributor

Choose a reason for hiding this comment

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

x.edsImpl.updateState(u.priority, u.s)
case <-x.closed.Done():
x.cancelWatch()
if newXDSClient != nil {
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this intended?

@@ -256,7 +255,4 @@ func (w *xdsClientWrapper) close() {
w.cancelLoadReport()
w.cancelLoadReport = nil
}
if newXDSClient != nil {
w.c.Close()
Copy link
Contributor

Choose a reason for hiding this comment

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

And here


// WaitForClose waits for Close to be invoked on this client and returns
// context.DeadlineExceeded otherwise.
func (xdsC *Client) WaitForClose(ctx context.Context) error {
Copy link
Contributor

Choose a reason for hiding this comment

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

This isn't right.

The actual question is, why is this method not used in any tests (it should be all the tests, but not only the resolver tests would matter).

The right fix is to call and check for this in the xds resolver tests, not to delete this.

Copy link
Member Author

Choose a reason for hiding this comment

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

The actual question is, why is this method not used in any tests (it should be all the tests, but not only the resolver tests would matter).

I had assumed this was once here for some kind of synchronization, then the usage was removed because it wasn't necessary.

This doesn't seem like the right way to test that the resolver closes the client. We should be ensuring that by the time xdsResolver.Close() returns, xdsClient.Close() has been called -- not "block until it happens".

I can add this test case in another PR immediately after this if you want.

Copy link
Member Author

Choose a reason for hiding this comment

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

Copy link
Contributor

Choose a reason for hiding this comment

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

Same as the other comment. This change should be moved to the other PR.

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'll just close this PR and open a series of other PRs, one for each change.

}
if newXDSClient != nil {
Copy link
Contributor

Choose a reason for hiding this comment

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

This is same as the others.

@menghanl menghanl assigned dfawley and unassigned menghanl Jun 3, 2021
@dfawley dfawley assigned menghanl and unassigned dfawley Jun 3, 2021
@menghanl menghanl assigned dfawley and unassigned menghanl Jun 3, 2021
@dfawley dfawley closed this Jun 3, 2021
@dfawley dfawley deleted the cleanups branch June 9, 2021 16:53
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Dec 7, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants