diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000000..78d7d2acd1 --- /dev/null +++ b/.gitignore @@ -0,0 +1,20 @@ +# OSX +._* +.DS_Store + +# Eclipse files +.classpath +.project +.settings/** + +# Emacs save files +*~ +\#*\# +.\#* + +# Vim-related files +[._]*.s[a-w][a-z] +[._]s[a-w][a-z] +*.un~ +Session.vim +.netrwhist diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..e56ac2613c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,42 @@ +# Contributing Guidelines + +Read the following guide if you're interested in contributing to Ingress. + +## Contributor License Agreements + +We'd love to accept your patches! Before we can take them, we have to jump a couple of legal hurdles. + +Please fill out either the individual or corporate Contributor License Agreement (CLA). + + * If you are an individual writing original source code and you're sure you own the intellectual property, then you'll need to sign an [individual CLA](http://code.google.com/legal/individual-cla-v1.0.html). + * If you work for a company that wants to allow you to contribute your work, then you'll need to sign a [corporate CLA](http://code.google.com/legal/corporate-cla-v1.0.html). + +Follow either of the two links above to access the appropriate CLA and instructions for how to sign and return it. Once we receive it, we'll be able to accept your pull requests. + +***NOTE***: Only original source code from you and other people that have signed the CLA can be accepted into the main repository. + +## Finding Things That Need Help + +If you're new to the project and want to help, but don't know where to start, we have a semi-curated list of issues that should not need deep knowledge of the system. [Have a look and see if anything sounds interesting](https://github.com/kubernetes/ingress/issues?utf8=%E2%9C%93&q=is%3Aopen%20is%3Aissue%20label%3Ahelp-wanted%20). Alternatively, read some of the docs on other controllers and try to write your own, file and fix any/all issues that come up, including gaps in documentation! + +## Contributing A Patch + +1. If you haven't already done so, sign a Contributor License Agreement (see details above). +1. Fork the desired repo, develop and test your code changes. +1. Submit a pull request. + +All changes must be code reviewed. Coding conventions and standards are explained in the official [developer docs](https://github.com/kubernetes/kubernetes/tree/8a2c639bfb2087a9a89c02d2dc30fcb9bd0846f6/docs/devel). Expect reviewers to request that you avoid common [go style mistakes](https://github.com/golang/go/wiki/CodeReviewComments) in your PRs. + +### Merge Approval + +Ingress collaborators may add "LGTM" (Looks Good To Me) or an equivalent comment to indicate that a PR is acceptable. Any change requires at least one LGTM. No pull requests can be merged until at least one Ingress collaborator signs off with an LGTM. + +## Support Channels + +Whether you are a user or contributor, official support channels include: + +- GitHub issues: https://github.com/kubenetes/ingress/issues/new +- Slack: kubernetes-users room in the [Kubernetes Slack](http://slack.kubernetes.io/) +- Email: [kubernetes-users](https://groups.google.com/forum/#!forum/kubernetes-users) mailing list + +Before opening a new issue or submitting a new pull request, it's helpful to search the project - it's likely that another user has already reported the issue you're facing, or it's a known issue that we're already aware of. diff --git a/OWNERS b/OWNERS new file mode 100644 index 0000000000..163563012d --- /dev/null +++ b/OWNERS @@ -0,0 +1,5 @@ +assignees: +- aledbf +- justinsb +- bprashanth +- thockin diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000000..607441ae63 --- /dev/null +++ b/README.adoc @@ -0,0 +1,21 @@ +// vim: ft=asciidoc + += Ingress +:toc: macro +:toc-title: + +toc::[] + +== Description + +This repository contains controllers built around the http://kubernetes.io/docs/user-guide/ingress/[Kubernetes Ingress resource]. +It is currently in a state of flux as project maintainers port code over from https://github.com/kubernetes/contrib/tree/master/ingress[Kubernetes/contrib/ingress]. + +== Directory Structure + +---- +ingress +├── docs Documentation/examples +├── controllers Ingress Controllers +└── vendor Vendored dependencies +---- diff --git a/controllers/README.md b/controllers/README.md new file mode 100644 index 0000000000..fc7e784c61 --- /dev/null +++ b/controllers/README.md @@ -0,0 +1,3 @@ +# Ingress controllers + +This directory contains ingress controllers. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000000..c7fa9d1c50 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,3 @@ +# Ingress documentation and examples + +This directory contains examples and documentation.