Remove examples from the main README.md

controllers/nginx/examples/custom-configuration/README.md

@@ -0,0 +1,57 @@
+The next command shows the defaults:
+```
+$ ./nginx-third-party-lb --dump-nginx—configuration
+Example of ConfigMap to customize NGINX configuration:
+data:
+  body-size: 1m
+  error-log-level: info
+  gzip-types: application/atom+xml application/javascript application/json application/rss+xml
+    application/vnd.ms-fontobject application/x-font-ttf application/x-web-app-manifest+json
+    application/xhtml+xml application/xml font/opentype image/svg+xml image/x-icon
+    text/css text/plain text/x-component
+  hts-include-subdomains: "true"
+  hts-max-age: "15724800"
+  keep-alive: "75"
+  max-worker-connections: "16384"
+  proxy-connect-timeout: "30"
+  proxy-read-timeout: "30"
+  proxy-real-ip-cidr: 0.0.0.0/0
+  proxy-send-timeout: "30"
+  server-name-hash-bucket-size: "64"
+  server-name-hash-max-size: "512"
+  ssl-buffer-size: 4k
+  ssl-ciphers: ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA
+  ssl-protocols: TLSv1 TLSv1.1 TLSv1.2
+  ssl-session-cache: "true"
+  ssl-session-cache-size: 10m
+  ssl-session-tickets: "true"
+  ssl-session-timeout: 10m
+  use-gzip: "true"
+  use-hts: "true"
+  worker-processes: "8"
+metadata:
+  name: custom-name
+  namespace: a-valid-namespace
+```
+
+For instance, if we want to change the timeouts we need to create a ConfigMap:
+```
+$ cat nginx-load-balancer-conf.yaml
+apiVersion: v1
+data:
+  proxy-connect-timeout: "10"
+  proxy-read-timeout: "120"
+  proxy-send-imeout: "120"
+kind: ConfigMap
+metadata:
+  name: nginx-load-balancer-conf
+
+```
+
+```
+$ kubectl create -f nginx-load-balancer-conf.yaml
+```
+
+Please check the example `rc-custom-configuration.yaml`
+
+If the Configmap it is updated, NGINX will be reloaded with the new configuration

controllers/nginx/examples/custom-configuration/rc-custom-configuration.yaml

@@ -44,10 +44,6 @@ spec:
           hostPort: 80
         - containerPort: 443
           hostPort: 4444
-        # we expose 8080 to access nginx stats in url /nginx_status
-        # this is optional
-        - containerPort: 8080
-          hostPort: 8081
         args:
         - /nginx-ingress-controller
         - --default-backend-service=default/default-http-backend

controllers/nginx/examples/daemonset/README.md

@@ -0,0 +1,8 @@
+
+In some cases could be required to run the Ingress controller in all the nodes in cluster.
+Using [DaemonSet](https://github.com/kubernetes/kubernetes/blob/master/docs/design/daemon.md) it is possible to do this.
+The file `as-daemonset.yaml` contains an example
+
+```
+kubectl create -f as-daemonset.yaml
+```

controllers/nginx/examples/daemonset/as-daemonset.yaml

@@ -38,10 +38,6 @@ spec:
           hostPort: 80
         - containerPort: 443
           hostPort: 4444
-        # we expose 8080 to access nginx stats in url /nginx_status
-        # this is optional
-        - containerPort: 8080
-          hostPort: 8081
         args:
         - /nginx-ingress-controller-lb
         - --default-backend-service=default/default-http-backend

controllers/nginx/examples/default/README.md

@@ -0,0 +1,76 @@
+
+Create the Ingress controller
+```
+kubectl create -f rc-default.yaml
+```
+
+To test if evertyhing is working correctly:
+
+`curl -v http://<node IP address>:80/foo -H 'Host: foo.bar.com'`
+
+You should see an output similar to
+```
+*   Trying 172.17.4.99...
+* Connected to 172.17.4.99 (172.17.4.99) port 80 (#0)
+> GET /foo HTTP/1.1
+> Host: foo.bar.com
+> User-Agent: curl/7.43.0
+> Accept: */*
+>
+< HTTP/1.1 200 OK
+< Server: nginx/1.9.8
+< Date: Tue, 15 Dec 2015 13:45:13 GMT
+< Content-Type: text/plain
+< Transfer-Encoding: chunked
+< Connection: keep-alive
+< Vary: Accept-Encoding
+<
+CLIENT VALUES:
+client_address=10.2.84.43
+command=GET
+real path=/foo
+query=nil
+request_version=1.1
+request_uri=http://foo.bar.com:8080/foo
+
+SERVER VALUES:
+server_version=nginx: 1.9.7 - lua: 9019
+
+HEADERS RECEIVED:
+accept=*/*
+connection=close
+host=foo.bar.com
+user-agent=curl/7.43.0
+x-forwarded-for=172.17.4.1
+x-forwarded-host=foo.bar.com
+x-forwarded-server=foo.bar.com
+x-real-ip=172.17.4.1
+BODY:
+* Connection #0 to host 172.17.4.99 left intact
+```
+
+If we try to get a non exising route like `/foobar` we should see
+```
+$ curl -v 172.17.4.99/foobar -H 'Host: foo.bar.com'
+*   Trying 172.17.4.99...
+* Connected to 172.17.4.99 (172.17.4.99) port 80 (#0)
+> GET /foobar HTTP/1.1
+> Host: foo.bar.com
+> User-Agent: curl/7.43.0
+> Accept: */*
+>
+< HTTP/1.1 404 Not Found
+< Server: nginx/1.9.8
+< Date: Tue, 15 Dec 2015 13:48:18 GMT
+< Content-Type: text/html
+< Transfer-Encoding: chunked
+< Connection: keep-alive
+< Vary: Accept-Encoding
+<
+default backend - 404
+* Connection #0 to host 172.17.4.99 left intact
+```
+
+(this test checked that the default backend is properly working)
+
+*Replacing the default backend with a custom one we can change the default error pages provided by nginx*

controllers/nginx/examples/default/rc-default.yaml

@@ -44,10 +44,6 @@ spec:
           hostPort: 80
         - containerPort: 443
           hostPort: 4444
-        # we expose 8080 to access nginx stats in url /nginx_status
-        # this is optional
-        - containerPort: 8080
-          hostPort: 8081
         args:
         - /nginx-ingress-controller
         - --default-backend-service=default/default-http-backend

controllers/nginx/examples/tcp/README.md

@@ -0,0 +1,74 @@
+
+To configure which services and ports will be exposed
+```
+kubectl create -f tcp-configmap-example.yaml
+```
+
+The file `tcp-configmap-example.yaml` uses a ConfigMap where the key is the external port to use and the value is
+`<namespace/service name>:<service port>`
+It is possible to use a number or the name of the port.
+
+```
+kubectl create -f rc-tcp.yaml
+```
+
+Now we can test the new service:
+```
+$ (sleep 1; echo "GET / HTTP/1.1"; echo "Host: 172.17.4.99:9000"; echo;echo;sleep 2) | telnet 172.17.4.99 9000
+
+Trying 172.17.4.99...
+Connected to 172.17.4.99.
+Escape character is '^]'.
+HTTP/1.1 200 OK
+Server: nginx/1.9.7
+Date: Tue, 15 Dec 2015 14:46:28 GMT
+Content-Type: text/plain
+Transfer-Encoding: chunked
+Connection: keep-alive
+
+f
+CLIENT VALUES:
+
+1a
+client_address=10.2.84.45
+
+c
+command=GET
+
+c
+real path=/
+
+a
+query=nil
+
+14
+request_version=1.1
+
+25
+request_uri=http://172.17.4.99:8080/
+
+1
+
+
+f
+SERVER VALUES:
+
+28
+server_version=nginx: 1.9.7 - lua: 9019
+
+1
+
+
+12
+HEADERS RECEIVED:
+
+16
+host=172.17.4.99:9000
+
+6
+BODY:
+
+14
+-no body in request-
+0
+```

controllers/nginx/examples/tls/rc-ssl.yaml

@@ -46,9 +46,6 @@ spec:
           hostPort: 4444
         - containerPort: 8080
           hostPort: 9000
-        # to configure ssl_dhparam http://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_dhparam
-        # use the dhparam.sh file to generate and mount a secret that containing the key dhparam.pem or
-        # create a configuration with the content of dhparam.pem in the field sslDHParam.
         args:
         - /nginx-ingress-controller
         - --default-backend-service=default/default-http-backend