Skip to content

Bring back removed Mesh config entries.#663

Closed
ozevren wants to merge 3 commits into
istio:masterfrom
ozevren:fix-meshconfig
Closed

Bring back removed Mesh config entries.#663
ozevren wants to merge 3 commits into
istio:masterfrom
ozevren:fix-meshconfig

Conversation

@ozevren
Copy link
Copy Markdown
Contributor

@ozevren ozevren commented Oct 19, 2018

Based on diff of master against 76349c5 in release-1.0 branch.

@ozevren ozevren requested review from geeknoid and rshriram October 19, 2018 20:44
@istio-testing istio-testing added the do-not-merge/work-in-progress Block merging of a PR because it isn't ready yet. label Oct 19, 2018
@googlebot googlebot added the cla: yes Set by the Google CLA bot to indicate the author of a PR has signed the Google CLA. label Oct 19, 2018
@ozevren ozevren removed the request for review from sebastienvas October 19, 2018 20:48
Comment thread mesh/v1alpha1/config.proto Outdated
AuthPolicy auth_policy = 10 [deprecated=true];

reserved 11;
// $hide_from_docs
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I don't think we want $hide_from_docs. Just mark the field as deprecated and it will be rendered appropriately by the doc infra.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done

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.

We don't want to render this.. as this is not implemented at all. Unless you mean marking something as deprecated will also hide it from the docs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Marking deprecated will indicate that is deprecated, but otherwise it is visible.

What do you mean "not implemented at all"? Was the field available in 1.0 (I thought it was).

The higher-order decision bit is, whether there are config maps that have a value for this field or not. If we can say we won't have for sure, then we can simply remove it. If not (i.e. there was a default value put when config was being generated), then we can't remove it.

(rendering is a separate thing, I'll let you guys come to an agreement and do the what is agreed on ).

@geeknoid
Copy link
Copy Markdown
Contributor

/lgtm
/approve

@ozevren ozevren changed the title WIP: Bring back removed Mesh config entries. Bring back removed Mesh config entries. Oct 22, 2018
@ozevren ozevren removed the do-not-merge/work-in-progress Block merging of a PR because it isn't ready yet. label Oct 22, 2018
// requested destination.
// Users are strongly encouraged to use ServiceEntries to explicitly declare any external dependencies,
// instead of using allow_any.
OutboundTrafficPolicy outbound_traffic_policy = 17 [deprecated=true];
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.

This was never implemented from the beginning. Do we have to keep it/bring it back?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Did we actually create any mesh config files with a value for this field? If so, yes.

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.

Nope. As I said not even in docs or helm.

@istio-testing
Copy link
Copy Markdown
Collaborator

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: geeknoid

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@geeknoid
Copy link
Copy Markdown
Contributor

We decided at TOC that deprecated fields should be visible in the docs. This tells the user "this field is going away soon" which is clearly different than "this is a new field that hasn't yet been documented". To avoid all confusion, the field is documented and gets removed from the docs when it gets removed from the implementation.

We haven't used the deprecation feature in the docs yet. Once this change goes in and I update the reference docs on istio.io, we can look at the rendering and decide whether we want something different there. If I recall correctly, deprecated fields just get rendered in a different color and it says something about being deprecated if you hover over the field. We could also use striketrhough or other approaches...

@istio-testing
Copy link
Copy Markdown
Collaborator

New changes are detected. LGTM label has been removed.

@istio-testing
Copy link
Copy Markdown
Collaborator

@ozevren: The following test failed, say /retest to rerun them all:

Test name Commit Details Rerun command
prow/api-presubmit.sh c7cffd5 link /test api-presubmit
Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository. I understand the commands that are listed here.

Copy link
Copy Markdown
Member

@rshriram rshriram left a comment

Choose a reason for hiding this comment

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

Everything that is marked as deprecated and unused in this PR - we should not even be displaying them. These were removed (implementation) by 1.0 but not from the mesh config. So you can define them but it will have no effect at all.

I am also pretty certain that we did not use any of these fields in the 1.0 release (helm). No one could have used them either as they would have had no effect.

@rshriram
Copy link
Copy Markdown
Member

closing as another PR that does the same has merged

@rshriram rshriram closed this Oct 31, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla: yes Set by the Google CLA bot to indicate the author of a PR has signed the Google CLA.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants