From ad6ef7daf89962bdf178afdf3f8af017dc9b106e Mon Sep 17 00:00:00 2001
From: Manuel de Brito Fontes <aledbf@gmail.com>
Date: Sat, 30 Sep 2017 18:24:59 -0300
Subject: [PATCH] Add example of server-snippet

---
 controllers/nginx/configuration.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/controllers/nginx/configuration.md b/controllers/nginx/configuration.md
index 98257bf3c6..064458a9cb 100644
--- a/controllers/nginx/configuration.md
+++ b/controllers/nginx/configuration.md
@@ -65,6 +65,7 @@ The following annotations are supported:
 |[ingress.kubernetes.io/rewrite-target](#rewrite)|URI|
 |[ingress.kubernetes.io/secure-backends](#secure-backends)|true or false|
 |[ingress.kubernetes.io/server-alias](#server-alias)|string|
+|[ingress.kubernetes.io/server-snippet](#server-snippet)|string|
 |[ingress.kubernetes.io/service-upstream](#service-upstream)|true or false|
 |[ingress.kubernetes.io/session-cookie-name](#cookie-affinity)|string|
 |[ingress.kubernetes.io/session-cookie-hash](#cookie-affinity)|string|
@@ -191,6 +192,29 @@ the new server configuration will take place over the alias configuration.
 
 For more information please see http://nginx.org/en/docs/http/ngx_http_core_module.html#server_name
 
+### Server snippet
+
+Using the annotation `ingress.kubernetes.io/server-snippet` it is possible to add custom configuration in the server configuration block.
+
+```
+apiVersion: extensions/v1beta1
+kind: Ingress
+metadata:
+annotations:
+ingress.kubernetes.io/server-snippet: |
+set $agentflag 0;
+
+if ($http_user_agent ~* "(Mobile)" ){
+  set $agentflag 1;
+}
+
+if ( $agentflag = 1 ) {
+  return 301 https://m.example.com;
+}
+```
+
+**Important:** This annotation can be used only once per host
+
 ### Client Body Buffer Size
 
 Sets buffer size for reading client request body per location. In case the request body is larger than the buffer,