-
Notifications
You must be signed in to change notification settings - Fork 8.3k
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
Move issues and prs over from contrib/ingress #3
Comments
Issues sound straightforward (once we have a list of all that apply). |
I think just issues are fine actually. By "move prs" I meant ping the original pr saying we aren't accepting ingress code in contrib anymore and close it with a pointer to this repo. Before we do that we should probably write a doc on how we expect people to integrate with the generic controller, because some prs in contrib are submitting a custom ingress controller, which right now should just become a backed implementing the interface. |
OK, you can assign this one to me, then. |
@porridge this is the list of issues to move from contrib:
|
before that :) we need to publish the examples and the configuration guide that was removed Edit: this is the list of PR to close (only related to nginx) kubernetes-retired/contrib#2368 |
Two questions about timing:
1) Do you think we should couple PR and issue move? I.e. wait with moving
issues until we're ready to also close PRs in contrib/?
2) Also, unless github.com/kubernetes/contrib/ingress/ gets deleted really
soon after the above move, we'll keep getting new issues and PRs in
contrib/ - so would you rather do another followup move later, or delay the
move until contrib/ingress is gone?
|
@porridge I think we need to restore the docs first. |
We also can't delete the contrib repo because it's linked from older relese documentation on k8s.io, suggest keeping it around for a while with a big notice in the readme linking to this repo. Re examples, we should start doing this #9 (comment) |
@bprashanth regarding the "older release documentation on k8s.io" do you mean it points to contrib/ingress at the tip of master? Can you show examples? If it points at individual files, I guess we need to keep the source. However if it points at the directory in general, then I guess we could just leave around a README with links to two places:
|
Doing all of #9 seems like a major undertaking, so I'd like us to agree here on the minimum that needs to be done in order to unblock this issue. I think that:
should be enough. Rationale: we should not make things worse with the move, but we also cannot expect to improve everything straight away. @bprashanth WDYT? |
I was planning to fill in text for all the READMEs added in this pr https://github.com/kubernetes/ingress/pull/33/files This basically gives us 3 tasks:
I think a lot of confusion comes from us having a cross platform api, but actually documenting it as distinct implementations, instead of taking a more wholeistic view.
@porridge I agree with this to some extent, but at the same time we have a chance to slowly improve things as we move and I fear that just lifting and shifting will lead to 0 improvement. |
Hi @bprashanth @aledbf @porridge, I want to help in this documentation moving from contrib/ TBH it is my first contribution. |
@mrmm as mentioned in #3 (comment) there are three main areas. Does any one of those feel particularly attractive to you? |
Sorry I meant to comment sooner, I wrote some dev docs on how you can setup a local env, start with those: https://github.com/kubernetes/ingress/tree/master/docs/dev. Report if something doesn't work. Otherwise suggest picking one of the tasks in https://github.com/kubernetes/ingress/tree/master/examples, looking up the corresponding example from contrib/ (https://github.com/kubernetes/contrib/tree/master/ingress), getting it to work and writing the doc. Suggest following the pattern of other examples in main repo for formatting etc (https://github.com/kubernetes/kubernetes/tree/master/examples). If there's no existing example in contrib, the feature is still possible but just undocumented (eg: nginx controller and sticky sessions), so you can try to figure out the right annotations and write the whole example. |
@porridge @bprashanth Thanks for your comments, I would like to help with writing detailed examples. |
Support MultiClusterIngress API
…_1.2.0 Upgrade ingress 1.2.0
# This is the 1st commit message: Add feature flag to disable annotation prefix check in admission controller # This is the commit message kubernetes#2: Add log message for when ingress hits annotation check Indicates that the correct environment variable is set. Does not log on absence of environment variable. # This is the commit message kubernetes#3: Add flag for disabling legacy ingress class annotation prefix check # This is the commit message kubernetes#4: Remove negation from if statement on annotation prefix check # This is the commit message kubernetes#5: Add logline to indicate annotation prefix check is skipped
As the title suggests. See tools like https://github.com/google/github-issue-mover
The text was updated successfully, but these errors were encountered: