Blame
|
1 | # Howto: NGINX-public_html |
||||||
| 2 | ||||||||
| 3 | 1. create a `~/public_html/domain.tld` on `gate0.t3m4.net` |
|||||||
| 4 | 2. `sudo` or ping <mail@redimp.de> to add the folder to `/etc/exports` and run `exportfs -a` |
|||||||
| 5 | 3. create a `domain-tld.yaml` definition for a deployment, a service and an ingress and `kubectl apply -f domain-tld.yaml` it. |
|||||||
| 6 | ||||||||
|
7 | > [!WARNING] |
||||||
| 8 | > Please consider all files in the exported folders as public, since any k8s pod can mount it via nfs. name the directories accordingly, e.g. `public_html` or `share`. |
|||||||
|
9 | |||||||
|
10 | ## One nginx for multiple domains: k8s deployment, services and ingress |
||||||
| 11 | ||||||||
| 12 | An example for an nginx deployment with multiple virtualhosts can be found below. Make sure to replace all the |
|||||||
| 13 | ||||||||
| 14 | - domain1.tld |
|||||||
| 15 | - doman2.tld |
|||||||
| 16 | - username |
|||||||
| 17 | ||||||||
| 18 | ```yaml |
|||||||
| 19 | --- |
|||||||
| 20 | apiVersion: v1 |
|||||||
| 21 | kind: ConfigMap |
|||||||
| 22 | metadata: |
|||||||
| 23 | name: nginx-conf |
|||||||
| 24 | namespace: username-vserver |
|||||||
| 25 | data: |
|||||||
| 26 | virtualhost.conf: | |
|||||||
| 27 | server { |
|||||||
| 28 | listen 80; |
|||||||
| 29 | server_name domain1.tld www.domain1.tld; |
|||||||
| 30 | root /var/www/html/domain1.tld; |
|||||||
| 31 | index index.html; |
|||||||
| 32 | location / { |
|||||||
| 33 | try_files $uri $uri/ =404; |
|||||||
| 34 | } |
|||||||
| 35 | } |
|||||||
| 36 | ||||||||
| 37 | server { |
|||||||
| 38 | listen 80; |
|||||||
| 39 | server_name domain2.tld www.domain2.tld; |
|||||||
| 40 | root /var/www/html/domain2.tld; |
|||||||
| 41 | index index.html; |
|||||||
| 42 | location / { |
|||||||
| 43 | try_files $uri $uri/ =404; |
|||||||
| 44 | } |
|||||||
| 45 | } |
|||||||
| 46 | --- |
|||||||
| 47 | apiVersion: apps/v1 |
|||||||
| 48 | kind: Deployment |
|||||||
| 49 | metadata: |
|||||||
| 50 | name: nginx-static |
|||||||
| 51 | namespace: username-vserver |
|||||||
| 52 | spec: |
|||||||
| 53 | selector: |
|||||||
| 54 | matchLabels: |
|||||||
| 55 | app: nginx-static |
|||||||
| 56 | replicas: 1 |
|||||||
| 57 | template: |
|||||||
| 58 | metadata: |
|||||||
| 59 | labels: |
|||||||
| 60 | app: nginx-static |
|||||||
| 61 | spec: |
|||||||
| 62 | containers: |
|||||||
| 63 | - name: nginx |
|||||||
| 64 | image: nginx:1.14.2 |
|||||||
| 65 | command: |
|||||||
| 66 | - /bin/sh |
|||||||
| 67 | - -c |
|||||||
| 68 | - | |
|||||||
| 69 | sed -i '/^nginx/d' /etc/passwd |
|||||||
| 70 | sed -i '/^nginx/d' /etc/group |
|||||||
| 71 | echo "nginx:x:101:101:nginx user,,,:/nonexistent:/bin/false" >> /etc/passwd |
|||||||
| 72 | echo "nginx:x:101:" >> /etc/group |
|||||||
| 73 | nginx -g 'daemon off;' |
|||||||
| 74 | ports: |
|||||||
| 75 | - containerPort: 80 |
|||||||
| 76 | volumeMounts: |
|||||||
| 77 | - name: nginx-conf |
|||||||
| 78 | subPath: virtualhost.conf |
|||||||
| 79 | mountPath: /etc/nginx/conf.d/virtualhost.conf |
|||||||
| 80 | - name: nfs-public-html |
|||||||
| 81 | mountPath: /var/www/html |
|||||||
| 82 | volumes: |
|||||||
| 83 | - name: nginx-conf |
|||||||
| 84 | configMap: |
|||||||
| 85 | name: nginx-conf |
|||||||
| 86 | items: |
|||||||
| 87 | - key: virtualhost.conf |
|||||||
| 88 | path: virtualhost.conf |
|||||||
| 89 | - name: nfs-public-html |
|||||||
| 90 | nfs: |
|||||||
| 91 | server: 10.1.0.2 |
|||||||
| 92 | path: /home/username/public_html |
|||||||
| 93 | --- |
|||||||
| 94 | apiVersion: v1 |
|||||||
| 95 | kind: Service |
|||||||
| 96 | metadata: |
|||||||
| 97 | name: nginx-static |
|||||||
| 98 | namespace: username-vserver |
|||||||
| 99 | spec: |
|||||||
| 100 | ports: |
|||||||
| 101 | - port: 80 |
|||||||
| 102 | targetPort: 80 |
|||||||
| 103 | protocol: TCP |
|||||||
| 104 | selector: |
|||||||
| 105 | app: nginx-static |
|||||||
| 106 | --- |
|||||||
| 107 | apiVersion: networking.k8s.io/v1 |
|||||||
| 108 | kind: Ingress |
|||||||
| 109 | metadata: |
|||||||
| 110 | name: nginx-static |
|||||||
| 111 | namespace: username-vserver |
|||||||
| 112 | annotations: |
|||||||
| 113 | cert-manager.io/cluster-issuer: "letsencrypt-production" |
|||||||
| 114 | nginx.ingress.kubernetes.io/ssl-redirect: "true" |
|||||||
| 115 | nginx.ingress.kubernetes.io/server-alias: "www.domain1.tld,www.domain2.tld,domain2.tld" |
|||||||
| 116 | spec: |
|||||||
| 117 | ingressClassName: "nginx" |
|||||||
| 118 | tls: |
|||||||
| 119 | - hosts: |
|||||||
| 120 | - domain1.tld |
|||||||
| 121 | - www.domain1.tld |
|||||||
| 122 | - domain2.tld |
|||||||
| 123 | - www.domain2.tld |
|||||||
| 124 | secretName: nginx-static-tls |
|||||||
| 125 | rules: |
|||||||
| 126 | - host: domain1.tld |
|||||||
| 127 | http: |
|||||||
| 128 | paths: |
|||||||
| 129 | - path: / |
|||||||
| 130 | pathType: Prefix |
|||||||
| 131 | backend: |
|||||||
| 132 | service: |
|||||||
| 133 | name: nginx-static |
|||||||
| 134 | port: |
|||||||
| 135 | number: 80 |
|||||||
| 136 | - host: domain2.tld |
|||||||
| 137 | http: |
|||||||
| 138 | paths: |
|||||||
| 139 | - path: / |
|||||||
| 140 | pathType: Prefix |
|||||||
| 141 | backend: |
|||||||
| 142 | service: |
|||||||
| 143 | name: nginx-static |
|||||||
| 144 | port: |
|||||||
| 145 | number: 80 |
|||||||
| 146 | ||||||||
| 147 | ``` |
|||||||
| 148 | ||||||||
| 149 | ## One nginx per domain: k8s deployment, service and ingress |
|||||||
|
150 | |||||||
| 151 | An example for an nginx deployment can be found below. Make sure to replace all the |
|||||||
| 152 | ||||||||
| 153 | - domain-tld |
|||||||
| 154 | - domain.tld |
|||||||
| 155 | - username |
|||||||
| 156 | ||||||||
| 157 | entries. |
|||||||
| 158 | ||||||||
| 159 | ```yaml |
|||||||
| 160 | --- |
|||||||
| 161 | apiVersion: apps/v1 |
|||||||
| 162 | kind: Deployment |
|||||||
| 163 | metadata: |
|||||||
| 164 | name: nginx-domain-tld |
|||||||
| 165 | namespace: username-vserver |
|||||||
| 166 | spec: |
|||||||
| 167 | selector: |
|||||||
| 168 | matchLabels: |
|||||||
| 169 | app: nginx-domain-tld |
|||||||
| 170 | replicas: 1 |
|||||||
| 171 | template: |
|||||||
| 172 | metadata: |
|||||||
| 173 | labels: |
|||||||
| 174 | app: nginx-domain-tld |
|||||||
| 175 | spec: |
|||||||
| 176 | containers: |
|||||||
| 177 | - name: nginx |
|||||||
| 178 | image: nginx:1.14.2 |
|||||||
| 179 | command: |
|||||||
| 180 | - /bin/sh |
|||||||
| 181 | - -c |
|||||||
| 182 | - | |
|||||||
| 183 | sed -i '/^nginx/d' /etc/passwd |
|||||||
| 184 | sed -i '/^nginx/d' /etc/group |
|||||||
| 185 | echo "nginx:x:101:101:nginx user,,,:/nonexistent:/bin/false" >> /etc/passwd |
|||||||
| 186 | echo "nginx:x:101:" >> /etc/group |
|||||||
| 187 | nginx -g 'daemon off;' |
|||||||
| 188 | ports: |
|||||||
| 189 | - containerPort: 80 |
|||||||
| 190 | volumeMounts: |
|||||||
| 191 | - name: nfs-public-html |
|||||||
| 192 | mountPath: /usr/share/nginx/html |
|||||||
| 193 | volumes: |
|||||||
| 194 | - name: nfs-public-html |
|||||||
| 195 | nfs: |
|||||||
| 196 | server: 10.1.0.2 |
|||||||
| 197 | path: /home/username/public_html/domain.tld |
|||||||
| 198 | --- |
|||||||
| 199 | apiVersion: v1 |
|||||||
| 200 | kind: Service |
|||||||
| 201 | metadata: |
|||||||
| 202 | name: nginx-domain-tld |
|||||||
|
203 | namespace: username-vserver |
||||||
|
204 | spec: |
||||||
| 205 | ports: |
|||||||
| 206 | - port: 80 |
|||||||
| 207 | targetPort: 80 |
|||||||
| 208 | protocol: TCP |
|||||||
| 209 | selector: |
|||||||
| 210 | app: nginx-domain-tld |
|||||||
| 211 | --- |
|||||||
| 212 | apiVersion: networking.k8s.io/v1 |
|||||||
| 213 | kind: Ingress |
|||||||
| 214 | metadata: |
|||||||
| 215 | name: nginx-domain-tld |
|||||||
|
216 | namespace: username-vserver |
||||||
|
217 | annotations: |
||||||
| 218 | cert-manager.io/cluster-issuer: "letsencrypt-production" |
|||||||
| 219 | nginx.ingress.kubernetes.io/ssl-redirect: "true" |
|||||||
| 220 | nginx.ingress.kubernetes.io/server-alias: "www.domain.tld" |
|||||||
| 221 | spec: |
|||||||
| 222 | ingressClassName: "nginx" |
|||||||
| 223 | tls: |
|||||||
| 224 | - hosts: |
|||||||
| 225 | - domain.tld |
|||||||
| 226 | - www.domain.tld |
|||||||
| 227 | secretName: domain-tld-tls |
|||||||
| 228 | rules: |
|||||||
| 229 | - host: domain.tld |
|||||||
| 230 | http: |
|||||||
| 231 | paths: |
|||||||
| 232 | - path: / |
|||||||
| 233 | pathType: Prefix |
|||||||
| 234 | backend: |
|||||||
| 235 | service: |
|||||||
| 236 | name: nginx-domain-tld |
|||||||
| 237 | port: |
|||||||
| 238 | number: 80 |
|||||||
| 239 | ||||||||
| 240 | ``` |
|||||||
