Skip to content

Commit baa9403

Browse files
committed
OSDOCS-14578: adds ingress control options to MicroShift
1 parent ffec83d commit baa9403

File tree

3 files changed

+137
-12
lines changed

3 files changed

+137
-12
lines changed

modules/microshift-config-yaml-custom.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
:_mod-docs-content-type: CONCEPT
66
[id="microshift-yaml-custom_{context}"]
77
= Using custom settings
8+
89
To create custom configurations, make a copy of the `config.yaml.default` file that is provided in the `/etc/microshift/` directory, renaming it `config.yaml`. Keep this file in the `/etc/microshift/` directory, and then you can change supported settings that are expected to override the defaults before starting or restarting {microshift-short}.
910

1011
[IMPORTANT]

modules/microshift-default-settings.adoc

Lines changed: 37 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,15 @@ apiServer:
3333
subjectAltNames: []
3434
tls:
3535
cipherSuites:
36-
- ""
36+
- TLS_AES_128_GCM_SHA256
37+
- TLS_AES_256_GCM_SHA384
38+
- TLS_CHACHA20_POLY1305_SHA256
39+
- TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
40+
- TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
41+
- TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
42+
- TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
43+
- TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
44+
- TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
3745
minVersion: VersionTLS12
3846
debugging:
3947
logLevel: "Normal"
@@ -42,6 +50,30 @@ dns:
4250
etcd:
4351
memoryLimitMB: 0
4452
ingress:
53+
accessLogging:
54+
destination:
55+
container:
56+
maxLength: 1024
57+
syslog:
58+
address: ""
59+
facility: ""
60+
maxLength: 1024
61+
port: 0
62+
type: ""
63+
httpCaptureCookies:
64+
- matchType: ""
65+
maxLength: 0
66+
name: ""
67+
namePrefix: ""
68+
httpCaptureHeaders:
69+
request:
70+
- maxLength: 0
71+
name: ""
72+
response:
73+
- maxLength: 0
74+
name: ""
75+
httpLogFormat: ""
76+
status: Disabled
4577
certificateSecret: router-certs-default
4678
clientTLS:
4779
allowedSubjectPatterns:
@@ -54,8 +86,9 @@ ingress:
5486
mimeTypes:
5587
- ""
5688
httpEmptyRequestsPolicy: Respond
57-
listenAddress:
58-
- ""
89+
httpErrorCodePages:
90+
name: ""
91+
listenAddress: []
5992
logEmptyRequests: Log
6093
ports:
6194
http: 80
@@ -65,14 +98,7 @@ ingress:
6598
wildcardPolicy: WildcardPolicyAllowed
6699
status: Managed
67100
tlsSecurityProfile:
68-
type: Custom
69-
custom:
70-
ciphers:
71-
- ECDHE-ECDSA-CHACHA20-POLY1305
72-
- ECDHE-RSA-CHACHA20-POLY1305
73-
- ECDHE-RSA-AES128-GCM-SHA256
74-
- ECDHE-ECDSA-AES128-GCM-SHA256
75-
minTLSVersion: VersionTLS12
101+
type: Intermediate
76102
tuningOptions:
77103
clientFinTimeout: "1s"
78104
clientTimeout: "30s"

modules/microshift-ingress-controller-config.adoc

Lines changed: 99 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,30 @@ Configuration snippet YAMLs take precedence over both built-in settings and the
4141
apiServer:
4242
# ...
4343
ingress:
44+
accessLogging:
45+
destination:
46+
container:
47+
maxLength: 1024
48+
syslog:
49+
address: ""
50+
facility: ""
51+
maxLength: 1024
52+
port: 0
53+
type: ""
54+
httpCaptureCookies:
55+
- matchType: ""
56+
maxLength: 0
57+
name: ""
58+
namePrefix: ""
59+
httpCaptureHeaders:
60+
request:
61+
- maxLength: 0
62+
name: ""
63+
response:
64+
- maxLength: 0
65+
name: ""
66+
httpLogFormat: ""
67+
status: Disabled
4468
certificateSecret: router-certs-custom
4569
clientTLS:
4670
allowedSubjectPatterns: []
@@ -53,6 +77,8 @@ ingress:
5377
mimeTypes:
5478
- ""
5579
httpEmptyRequestsPolicy: Respond
80+
httpErrorCodePages:
81+
name: ""
5682
listenAddress: []
5783
logEmptyRequests: Log
5884
ports:
@@ -91,7 +117,79 @@ ingress:
91117
|Parameter |Description
92118

93119
|`ingress`
94-
|The `ingress` section of the {microshift-short} `config.yaml` file defines the configurable parameters for the implemented portions of the {OCP} Ingress Control Operator. All parameters in the rest of this table are subsections in the `ingress` section of the `config.yaml`.
120+
|The `ingress` section of the {microshift-short} `config.yaml` file defines the configurable parameters for the implemented portions of the {OCP} Ingress Control Operator. All of the following parameters in this table are subsections in the `ingress` section of the `config.yaml`.
121+
122+
|`accessLogging`
123+
|
124+
125+
|`accessLogging.destination`
126+
|
127+
128+
|`accessLogging.destination.container`
129+
|
130+
131+
|`accessLogging.destination.container.maxLength`
132+
|Default value is 1024.
133+
134+
|`accessLogging.destination.syslog`
135+
|
136+
137+
|`accessLogging.destination.syslog.address`
138+
|
139+
140+
|`accessLogging.destination.syslog.facility`
141+
|
142+
143+
|`accessLogging.destination.syslog.maxLength`
144+
|Default value is 1024.
145+
146+
|`accessLogging.destination.syslog.port`
147+
|Default value is 0.
148+
149+
|`accessLogging.destination.type`
150+
|Default value is 0.
151+
152+
|`httpCaptureCookies`
153+
|
154+
155+
|`httpCaptureCookiesmatchType`
156+
|
157+
158+
|`httpCaptureCookiesmaxLength`
159+
|
160+
161+
|`httpCaptureCookiesname`
162+
|
163+
164+
|`httpCaptureCookiesnamePrefix`
165+
|
166+
167+
|`httpCaptureHeaders`
168+
|
169+
170+
|`httpCaptureHeaders.request`
171+
|
172+
173+
|`httpCaptureHeaders.request.maxLength`
174+
|
175+
176+
|`httpCaptureHeaders.request.name`
177+
|
178+
179+
|`httpCaptureHeaders.response`
180+
|
181+
182+
|`httpCaptureHeaders.responsemaxLength`
183+
|
184+
185+
|`httpCaptureHeaders.responsename`
186+
|
187+
188+
|`httpLogFormat`
189+
|
190+
191+
|`status`
192+
|Default value is `Disabled`.
95193

96194
|`certificateSecret`
97195
|A reference to a `kubernetes.io/tls` type of secret that contains the default certificate that is served by the {microshift-short} ingress controller. When routes do not specify their own certificate, the `certificateSecret` parameter is used. All secrets used must contain `tls.key` key file contents and `tls.crt` certificate file contents.

0 commit comments

Comments
 (0)