forked from kiali/kiali
-
Notifications
You must be signed in to change notification settings - Fork 0
/
k8s-minikube.sh
executable file
·799 lines (728 loc) · 29.7 KB
/
k8s-minikube.sh
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
#!/bin/bash
##############################################################################
# k8s-minikube.sh
#
# This script can be used to help run Kubernetes via minikube.
# The typical order of commands used is the following:
# start - starts the Kubernetes cluster via minikube
# istio - installs Istio using Kiali's install hack script
# docker - shows what is needed to put images in minikube's image registry
# podman - shows what is needed to put images in minikube's image registry
# (at this point, you can install Kiali into your Kubernetes environment)
# dashboard - shows the Kubernetes GUI console
# port-forward - forward a local port to the Kiali server
# ingress - shows the Ingress URL which can get you to the Kiali GUI
# bookinfo - installs bookinfo demo into your cluster
# stop - shuts down the Kubernetes cluster, you can start it up again
# delete - if you don't want your cluster anymore, this deletes it
#
##############################################################################
set -u
DEFAULT_CLIENT_EXE="kubectl"
DEFAULT_DEX_ENABLED="false"
DEFAULT_DEX_REPO="https://github.com/dexidp/dex"
DEFAULT_DEX_VERSION="v2.30.2"
DEFAULT_DEX_USER_NAMESPACES="bookinfo"
DEFAULT_INSECURE_REGISTRY_IP=""
DEFAULT_K8S_CNI="auto"
DEFAULT_K8S_CPU="4"
DEFAULT_K8S_DISK="40g"
DEFAULT_K8S_DRIVER="kvm2"
DEFAULT_K8S_MEMORY="8g"
DEFAULT_K8S_VERSION="stable"
DEFAULT_LB_ADDRESSES="" # example: "'192.168.99.70-192.168.99.84'"
DEFAULT_MINIKUBE_EXE="minikube"
DEFAULT_MINIKUBE_PROFILE="minikube"
DEFAULT_MINIKUBE_START_FLAGS=""
DEFAULT_OLM_ENABLED="false"
DEFAULT_OLM_VERSION="latest"
DEFAULT_OUTPUT_PATH="/tmp/k8s-minikube-tmpdir"
_VERBOSE="false"
debug() {
if [ "$_VERBOSE" == "true" ]; then
echo "DEBUG: $1"
fi
}
ensure_minikube_is_running() {
if ! ${MINIKUBE_EXEC_WITH_PROFILE} status > /dev/null 2>&1 ; then
echo 'Minikube must be running in order to continue. Aborting.'
exit 1
fi
}
get_gateway_url() {
if [ "$1" == "" ] ; then
INGRESS_PORT="<port>"
else
jsonpath="{.spec.ports[?(@.name==\"$1\")].nodePort}"
INGRESS_PORT=$(${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- -n istio-system get service istio-ingressgateway -o jsonpath=${jsonpath})
fi
INGRESS_HOST=$(${MINIKUBE_EXEC_WITH_PROFILE} ip)
GATEWAY_URL=$INGRESS_HOST:${INGRESS_PORT:-?}
}
print_all_gateway_urls() {
echo "Gateway URLs for all known ports are:"
allnames=$(${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- -n istio-system get service istio-ingressgateway -o jsonpath={.spec.ports['*'].name})
for n in ${allnames}
do
get_gateway_url ${n}
echo ${n}: ${GATEWAY_URL}
done
}
check_insecure_registry() {
if which podman > /dev/null 2>&1; then
# looks like this machine is using podman - ignore this check
return
fi
local _registry="$(${MINIKUBE_EXEC_WITH_PROFILE} ip):5000"
pgrep -a dockerd | grep "[-]-insecure-registry.*${_registry}" > /dev/null 2>&1
if [ "$?" != "0" ]; then
grep "OPTIONS=.*--insecure-registry.*${_registry}" /etc/sysconfig/docker > /dev/null 2>&1
if [ "$?" != "0" ]; then
grep "insecure-registries.*${_registry}" /etc/docker/daemon.json > /dev/null 2>&1
if [ "$?" != "0" ]; then
echo "WARNING: You must tell Docker about the insecure image registry (e.g. --insecure-registry ${_registry})."
else
debug "/etc/docker/daemon.json has the insecure-registry setting. This is good."
fi
else
debug "/etc/sysconfig/docker has defined the insecure-registry setting. This is good."
fi
else
debug "Docker daemon is running with --insecure-registry setting. This is good."
fi
}
install_dex() {
echo 'Installing Dex for OpenID Connect support...'
# Download dex - prepare a clean copy
DEX_VERSION_PATH="${OUTPUT_PATH}/dex/${DEX_VERSION}"
rm -rf ${DEX_VERSION_PATH}
if [ ! -d "${DEX_VERSION_PATH}" ]; then
echo "Will download Dex version [${DEX_VERSION}] to [${DEX_VERSION_PATH}]"
mkdir -p ${DEX_VERSION_PATH}
if command -v wget >/dev/null 2>&1; then
wget ${DEX_REPO}/archive/${DEX_VERSION}.tar.gz -O - | tar -C ${DEX_VERSION_PATH} --strip-components 1 -zxf -
else
curl -L -o - | tar -C ${DEX_VERSION_PATH} --strip-components 1 -zxf -
fi
else
echo "Will use existing Dex version [${DEX_VERSION}] found at [${DEX_VERSION_PATH}]"
fi
# Find minikube ip
MINIKUBE_IP=$(${MINIKUBE_EXEC_WITH_PROFILE} ip)
echo "Minikube IP is ${MINIKUBE_IP}"
MINIKUBE_IP_DASHED=$(echo -n ${MINIKUBE_IP} | sed 's/\./-/g')
KUBE_HOSTNAME="${MINIKUBE_IP_DASHED}.nip.io"
echo "Hostname will be ${KUBE_HOSTNAME}"
# Generate certs for the minikube instance, if we still don't have them
CERTS_PATH="${DEX_VERSION_PATH}/examples/k8s/ssl_${KUBE_HOSTNAME}"
if [ ! -d "${CERTS_PATH}" ]; then
# Patch gencert.sh script from dex
rm -f ${DEX_VERSION_PATH}/examples/k8s/kiali.gencert.sh
rm -rf ${DEX_VERSION_PATH}/examples/k8s/ssl
patch -i - -o ${DEX_VERSION_PATH}/examples/k8s/kiali.gencert.sh ${DEX_VERSION_PATH}/examples/k8s/gencert.sh <<EOF
18c18
< DNS.1 = dex.example.com
---
> DNS.1 = ${KUBE_HOSTNAME}
EOF
[ "$?" != "0" ] && echo "ERROR: Failed to patch gencert.sh" && exit 1
$(cd ${DEX_VERSION_PATH}/examples/k8s/; bash ./kiali.gencert.sh)
mv ${DEX_VERSION_PATH}/examples/k8s/ssl ${CERTS_PATH}
fi
# Copy certificates to minikube cluster
# Because the user may destroy and create many minikube VMs, expect the VM fingerprint to change (i.e. avoid known_hosts checks)
mkdir -p ${OUTPUT_PATH}
local tmp_known_hosts="${OUTPUT_PATH}/minikube-known-hosts"
rm -f ${tmp_known_hosts}
${MINIKUBE_EXEC_WITH_PROFILE} ssh -- mkdir dex_certs
scp -o StrictHostKeyChecking=no -o UserKnownHostsFile=${tmp_known_hosts} -i $(${MINIKUBE_EXEC_WITH_PROFILE} ssh-key) ${CERTS_PATH}/* docker@$(${MINIKUBE_EXEC_WITH_PROFILE} ip):dex_certs/
${MINIKUBE_EXEC_WITH_PROFILE} ssh -- sudo mkdir -p /var/lib/minikube/certs/
${MINIKUBE_EXEC_WITH_PROFILE} ssh -- sudo cp /home/docker/dex_certs/* /var/lib/minikube/certs/
# Patch dex file
rm -rf ${DEX_VERSION_PATH}/examples/k8s/dex.kiali.yaml
patch -i - -o ${DEX_VERSION_PATH}/examples/k8s/dex.kiali.yaml ${DEX_VERSION_PATH}/examples/k8s/dex.yaml << EOF
15c15
< replicas: 3
---
> replicas: 1
26c26
< - image: dexidp/dex:v2.27.0 #or quay.io/dexidp/dex:v2.26.0
---
> - image: docker.io/dexidp/dex:${DEX_VERSION}
41c41
< - name: GITHUB_CLIENT_ID
---
> - name: KUBERNETES_POD_NAMESPACE
43,50c43,44
< secretKeyRef:
< name: github-client
< key: client-id
< - name: GITHUB_CLIENT_SECRET
< valueFrom:
< secretKeyRef:
< name: github-client
< key: client-secret
---
> fieldRef:
> fieldPath: metadata.namespace
75c69
< issuer: https://dex.example.com:32000
---
> issuer: https://${KUBE_HOSTNAME}:32000
85,92d78
< - type: github
< id: github
< name: GitHub
< config:
< clientID: \$GITHUB_CLIENT_ID
< clientSecret: \$GITHUB_CLIENT_SECRET
< redirectURI: https://dex.example.com:32000/callback
< org: kubernetes
94a81
> responseTypes: ["code", "id_token"]
96a84,89
> - id: kiali-app
> redirectURIs:
> - 'http://${MINIKUBE_IP}/kiali'
> - 'http://kiali-proxy.${MINIKUBE_IP}.nip.io:30805/oauth2/callback'
> name: 'Kiali'
> secret: dontTellAnyone
EOF
[ "$?" != "0" ] && echo "ERROR: Failed to patch dex file" && exit 1
cat <<EOF > ${DEX_VERSION_PATH}/examples/k8s/oauth2.proxy
apiVersion: v1
kind: Namespace
metadata:
name: oauth2-proxy
spec: {}
---
apiVersion: v1
kind: ConfigMap
metadata:
name: oauth2-proxy
namespace: oauth2-proxy
data:
oauth2-proxy.conf: |-
http_address="0.0.0.0:4180"
cookie_secret="secretxxsecretxx"
provider="oidc"
email_domains="example.com"
oidc_issuer_url="https://${KUBE_HOSTNAME}:32000"
client_id="kiali-app"
cookie_secure="false"
redirect_url="http://kiali-proxy.${MINIKUBE_IP}.nip.io:30805/oauth2/callback"
upstreams="http://kiali.istio-system.svc:20001"
pass_authorization_header = true
set_authorization_header = true
ssl_insecure_skip_verify = true
client_secret="dontTellAnyone"
---
apiVersion: apps/v1
kind: Deployment
metadata:
labels:
k8s-app: oauth2-proxy
name: oauth2-proxy
namespace: oauth2-proxy
spec:
replicas: 1
selector:
matchLabels:
k8s-app: oauth2-proxy
template:
metadata:
labels:
k8s-app: oauth2-proxy
spec:
containers:
- args:
- --config
- /etc/oauthproxy/oauth2-proxy.conf
env: []
image: quay.io/oauth2-proxy/oauth2-proxy:latest
imagePullPolicy: Always
livenessProbe:
httpGet:
path: /ping
port: 4180
initialDelaySeconds: 10
periodSeconds: 20
name: oauth2-proxy
ports:
- containerPort: 4180
protocol: TCP
volumeMounts:
- mountPath: /etc/oauthproxy
name: config
volumes:
- configMap:
name: oauth2-proxy
name: config
---
apiVersion: v1
kind: Service
metadata:
labels:
k8s-app: oauth2-proxy
name: oauth2-proxy
namespace: oauth2-proxy
spec:
ports:
- name: http
port: 4180
protocol: TCP
targetPort: 4180
nodePort: 30805
type: NodePort
selector:
k8s-app: oauth2-proxy
EOF
# Install dex
echo "Deploying dex..."
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create namespace dex
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create secret tls dex.example.com.tls --cert=${CERTS_PATH}/cert.pem --key=${CERTS_PATH}/key.pem -n dex
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- apply -n dex -f ${DEX_VERSION_PATH}/examples/k8s/dex.kiali.yaml
[ "$?" != "0" ] && echo "ERROR: Failed to install dex" && exit 1
echo "Deploying oauth2 proxy..."
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create -f ${DEX_VERSION_PATH}/examples/k8s/oauth2.proxy
[ "$?" != "0" ] && echo "ERROR: Failed to deploy oauth2 proxy" && exit 1
# Restart minikube
echo "Restarting minikube with proper flags for API server and the autodetected registry IP..."
${MINIKUBE_EXEC_WITH_PROFILE} stop
${MINIKUBE_EXEC_WITH_PROFILE} start \
${MINIKUBE_START_FLAGS} \
${INSECURE_REGISTRY_START_ARG} \
--insecure-registry ${MINIKUBE_IP}:5000 \
--cni=${K8S_CNI} \
--cpus=${K8S_CPU} \
--memory=${K8S_MEMORY} \
--disk-size=${K8S_DISK} \
--driver=${K8S_DRIVER} \
--kubernetes-version=${K8S_VERSION} \
--extra-config=apiserver.oidc-issuer-url=https://${KUBE_HOSTNAME}:32000 \
--extra-config=apiserver.oidc-username-claim=email \
--extra-config=apiserver.oidc-ca-file=/var/lib/minikube/certs/ca.pem \
--extra-config=apiserver.oidc-client-id=kiali-app \
--extra-config=apiserver.oidc-groups-claim=groups
[ "$?" != "0" ] && echo "ERROR: Failed to restart minikube in preparation for dex" && exit 1
echo "Need to create the OpenID secret now - assuming Kiali will eventually be installed in istio-system"
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create namespace istio-system
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create secret generic kiali --from-literal="oidc-secret=dontTellAnyone" -n istio-system
echo "Minikube should now be configured with OpenID connect. Just wait for all pods to start."
cat <<EOF
Commands to query Dex deployments and pods:
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- get deployments -n dex
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- get pods -n dex
OpenID configuration for Kiali CR:
auth:
strategy: openid
openid:
client_id: "kiali-app"
insecure_skip_verify_tls: true
issuer_uri: "https://${KUBE_HOSTNAME}:32000"
username_claim: "email"
OpenID user is:
Username: admin@example.com
Password: password
Kiali reverse proxy URL: http://kiali-proxy.${MINIKUBE_IP}.nip.io:30805
The Kiali OIDC secret named 'kiali' has been created in istio-system namespace.
If you need to recreate this OIDC secret, run this command:
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create secret generic kiali --from-literal="oidc-secret=dontTellAnyone" -n istio-system
EOF
if [ "${DEX_USER_NAMESPACES}" != "none" ]; then
if [ "${DEX_USER_NAMESPACES}" == "all" ]; then
echo "!!!CAUTION!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
echo "!! The user 'admin@example.com' will be granted cluster-admin permissions ! "
echo "!!!CAUTION!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create clusterrolebinding dex-rolebinding-admin --clusterrole=cluster-admin --user="admin@example.com"
else
echo "After you install Kiali, execute these commands to grant the user 'admin@example.com' permission to see specific namespaces:"
for ns in ${DEX_USER_NAMESPACES}; do
echo ${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- create rolebinding dex-rolebinding-${ns} --clusterrole=kiali --user="admin@example.com" --namespace=${ns}
done
fi
fi
}
install_olm() {
echo 'Installing OLM...'
if [ "${OLM_VERSION}" == "latest" ]; then
OLM_VERSION="$(curl -s https://api.github.com/repos/operator-framework/operator-lifecycle-manager/releases 2> /dev/null | grep "tag_name" | sed -e 's/.*://' -e 's/ *"//' -e 's/",//' | grep -v "snapshot" | sort -t "." -k 1.2g,1 -k 2g,2 -k 3g | tail -n 1)"
if [ -z "${OLM_VERSION}" ]; then
echo "Failed to obtain the latest OLM version from Github. You will need to specify an explicit version via --olm-version."
exit 1
else
echo "Github reports the latest OLM version is: ${OLM_VERSION}"
fi
fi
# force the install.sh script to go through minikube kubectl when it executes kubectl commands
kubectl() {
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- $@
}
export MINIKUBE_EXEC_WITH_PROFILE
export -f kubectl
curl -sL https://github.com/operator-framework/operator-lifecycle-manager/releases/download/${OLM_VERSION}/install.sh | bash -s ${OLM_VERSION}
[ "$?" != "0" ] && echo "ERROR: Failed to install OLM" && exit 1
unset -f kubectl
echo "OLM ${OLM_VERSION} is installed."
}
determine_full_lb_range() {
local host_ip=$(${MINIKUBE_EXEC_WITH_PROFILE} ip)
local subnet=$(echo ${host_ip} | sed -E 's/([0-9]+\.[0-9]+\.[0-9]+)\.[0-9]+/\1/')
local first_ip="${subnet}.$(echo "${LB_ADDRESSES}" | cut -d '-' -f 1)"
local last_ip="${subnet}.$(echo "${LB_ADDRESSES}" | cut -d '-' -f 2)"
LB_ADDRESSES="'${first_ip}-${last_ip}'"
echo "Full Load Balancer addresses: ${LB_ADDRESSES}"
}
# Change to the directory where this script is and set our env
cd "$(dirname "${BASH_SOURCE[0]}")"
_CMD=""
while [[ $# -gt 0 ]]; do
key="$1"
case $key in
start|up) _CMD="start"; shift ;;
stop|down) _CMD="stop"; shift ;;
status) _CMD="status"; shift ;;
delete) _CMD="delete"; shift ;;
docker) _CMD="docker"; shift ;;
podman) _CMD="podman"; shift ;;
dashboard) _CMD="dashboard"; shift ;;
port-forward) _CMD="port-forward"; shift ;;
ingress) _CMD="ingress"; shift ;;
istio) _CMD="istio"; shift ;;
bookinfo) _CMD="bookinfo"; shift ;;
gwurl)
_CMD="gwurl"
if [ "${2:-}" != "" ]; then
_CMD_OPT="$2"
shift
else
_CMD_OPT="all"
fi
shift
;;
resetclock) _CMD="resetclock"; shift ;;
olm) _CMD="olm"; shift ;;
-ce|--client-exe) CLIENT_EXE="$2"; shift;shift ;;
-de|--dex-enabled) DEX_ENABLED="$2"; shift;shift ;;
-dr|--dex-repo) DEX_REPO="$2"; shift;shift ;;
-dun|--dex-user-namespaces) DEX_USER_NAMESPACES="$2"; shift;shift ;;
-dv|--dex-version) DEX_VERSION="$2"; shift;shift ;;
-iri|--insecure-registry-ip) INSECURE_REGISTRY_IP="$2"; shift;shift ;;
-kc|--kubernetes-cpu) K8S_CPU="$2"; shift;shift ;;
-kcni|--kubernetes-cni) K8S_CNI="$2"; shift;shift ;;
-kd|--kubernetes-disk) K8S_DISK="$2"; shift;shift ;;
-kdr|--kubernetes-driver) K8S_DRIVER="$2"; shift;shift ;;
-km|--kubernetes-memory) K8S_MEMORY="$2"; shift;shift ;;
-kv|--kubernetes-version) K8S_VERSION="$2"; shift;shift ;;
-lba|--load-balancer-addrs) LB_ADDRESSES="$2"; shift;shift ;;
-me|--minikube-exe) MINIKUBE_EXE="$2"; shift;shift ;;
-mf|--minikube-flags) MINIKUBE_START_FLAGS="$2"; shift;shift ;;
-mp|--minikube-profile) MINIKUBE_PROFILE="$2"; shift;shift ;;
-oe|--olm-enabled) OLM_ENABLED="$2"; shift;shift ;;
-op|--output-path) OUTPUT_PATH="$2"; shift;shift ;;
-ov|--olm-version) OLM_VERSION="$2"; shift;shift ;;
-v|--verbose) _VERBOSE=true; shift ;;
-h|--help)
cat <<HELPMSG
$0 [option...] command
Valid options:
-ce|--client-exe
The kubectl client to use.
Only used for needing to install Istio or the Bookinfo demo. The "minikube kubectl" command will be used instead when possible.
Default: ${DEFAULT_CLIENT_EXE}
-de|--dex-enabled
If true, install and configure Dex. This provides an OpenID Connect implementation.
Only used for the 'start' command.
Default: ${DEFAULT_DEX_ENABLED}
-dr|--dex-repo
The github repo where the Dex archive is to be found.
Only used for the 'start' command and when Dex is to be installed (--dex-enabled=true).
Default: ${DEFAULT_DEX_REPO}
-dun|--dex-user-namespaces
A space-separated list of namespaces that you would like the admin@example.com user to be able to see.
If this value is set to "all", the admin@example.com user will immediately be granted cluster-admin permissions.
If this value is set to "none", nothing is done.
Any other value and this will not trigger actual creation of role bindings but instead the script merely
outputs the commands in the final summary that you should then execute in order to grant those permissions.
This is because the namespaces may not exist yet (such as "bookinfo") nor will the Kiali role exist.
Only used for the 'start' command and when Dex is to be installed (--dex-enabled=true).
Default: ${DEFAULT_DEX_USER_NAMESPACES}
-dv|--dex-version
The version of Dex to be installed.
Only used for the 'start' command and when Dex is to be installed (--dex-enabled=true).
Default: ${DEFAULT_DEX_VERSION}
-iri|--insecure-registry-ip
This is used for the setting up an insecure registry IP within the minikube docker daemon.
This is needed to easily authenticate and push images to the docker daemon.
This IP is usually the minikube IP, but that IP varies depending on the driver being used.
This IP is needed during startup, but it cannot be determined until after minikube starts;
hence that is why this script cannot auto-detect what you need. If the default is incorrect
for the driver you are using, you can set this value if you know what it will be. Otherwise,
you will need to obtain the minikube IP, then 'stop' and then 'start' minikube with this
value appropriately set.
Only used for the 'start' commmand.
Default: ${DEFAULT_INSECURE_REGISTRY_IP}
-kc|--kubernetes-cpu
The number of CPUs to give to Kubernetes at startup.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_CPU}
-kcni|--kubernetes-cni
The CNI implementation used by minikube. See 'minikube start --help' for the --cni options.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_CNI}
-kd|--kubernetes-disk
The amount of disk space to give to Kubernetes at startup.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_DISK}
-kdr|--kubernetes-driver
The hypervisor to use. Examples of valid values: virtualbox, hyperkit, kvm2, none.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_DRIVER}
-km|--kubernetes-memory
The amount of memory to give to Kubernetes at startup.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_MEMORY}
-kv|--kubernetes-version
The version of Kubernetes to start.
Only used for the 'start' command.
Default: ${DEFAULT_K8S_VERSION}
-lba|--load-balancer-addrs
When specified, the "metallb" addon is enabled and these are the load balancer addresses it uses.
The format for this value is simply two numbers, dash-separated such as "70-84". This means the
load balancer will use IPs in that range, using the subnet determined by "minikube ip". So if
the "minikube ip" is 192.168.99.100, the load balancer addrs will be "192.168.99.70-192.168.99.84".
Only used for the 'start' command.
Default: ${DEFAULT_LB_ADDRESSES}
-me|--minikube-exe
The minikube executable.
Default: ${DEFAULT_MINIKUBE_EXE}
-mf|--minikube-flags
Additional flags to pass to the 'minikube start' command.
Only used for the 'start' command.
Default: ${DEFAULT_MINIKUBE_START_FLAGS}
-mp|--minikube-profile
The profile which minikube will be started with.
Default: ${DEFAULT_MINIKUBE_PROFILE}
-oe|--olm-enabled
If true, OLM will be installed in the minikube cluster allowing you to install operators using the OLM API.
Only used for the 'start' command.
Default: ${DEFAULT_OLM_ENABLED}
-op|--output-path
A path this script can use to store files it needs or generates.
This path will be created if it does not exist, but it will
only be created if it is needed by the script.
Default: ${DEFAULT_OUTPUT_PATH}
-ov|--olm-version
If OLM is enabled, this is the version of OLM to install.
If set to "latest", github will be queried to determine the latest release, and that version will be installed.
Only used for the 'start' command.
Default: ${DEFAULT_OLM_VERSION}
-v|--verbose
Enable logging of debug messages from this script.
The command must be either:
start: starts the minikube cluster (alias: up)
stop: stops the minikube cluster (alias: down)
status: gets the status of the minikube cluster
delete: completely removes the minikube cluster VM destroying all state
docker: information on the minikube docker environment
podman: information on the minikube podman environment
dashboard: enables access to the Kubernetes GUI within minikube
port-forward: forward a local port to the Kiali server
ingress: enables access to the Kubernetes ingress URL within minikube
istio: installs Istio into the minikube cluster
bookinfo: installs Istio's bookinfo demo (make sure Istio is installed first)
gwurl [<portName>|'all']:
displays the Ingress Gateway URL. If a port name is given, the gateway port is also shown.
If the port name is "all" then all the URLs for all known ports are shown.
resetclock: If the VM's clock gets skewed (e.g. by sleeping) run this to reset it to the current time.
olm: Install OLM.
HELPMSG
exit 1
;;
*)
echo "Unknown argument [$key]. Aborting."
exit 1
;;
esac
done
# Prepare some env vars
: ${CLIENT_EXE:=${DEFAULT_CLIENT_EXE}}
: ${DEX_ENABLED:=${DEFAULT_DEX_ENABLED}}
: ${DEX_REPO:=${DEFAULT_DEX_REPO}}
: ${DEX_USER_NAMESPACES:=${DEFAULT_DEX_USER_NAMESPACES}}
: ${DEX_VERSION:=${DEFAULT_DEX_VERSION}}
: ${INSECURE_REGISTRY_IP:=${DEFAULT_INSECURE_REGISTRY_IP}}
: ${K8S_CNI:=${DEFAULT_K8S_CNI}}
: ${K8S_CPU:=${DEFAULT_K8S_CPU}}
: ${K8S_DISK:=${DEFAULT_K8S_DISK}}
: ${K8S_DRIVER:=${DEFAULT_K8S_DRIVER}}
: ${K8S_VERSION:=${DEFAULT_K8S_VERSION}}
: ${K8S_MEMORY:=${DEFAULT_K8S_MEMORY}}
: ${LB_ADDRESSES:=${DEFAULT_LB_ADDRESSES}}
: ${MINIKUBE_EXE:=${DEFAULT_MINIKUBE_EXE}}
: ${MINIKUBE_START_FLAGS:=${DEFAULT_MINIKUBE_START_FLAGS}}
: ${MINIKUBE_PROFILE:=${DEFAULT_MINIKUBE_PROFILE}}
: ${OLM_ENABLED:=${DEFAULT_OLM_ENABLED}}
: ${OLM_VERSION:=${DEFAULT_OLM_VERSION}}
: ${OUTPUT_PATH:=${DEFAULT_OUTPUT_PATH}}
MINIKUBE_EXEC_WITH_PROFILE="${MINIKUBE_EXE} -p ${MINIKUBE_PROFILE}"
if [ ! -z "${INSECURE_REGISTRY_IP}" ]; then
INSECURE_REGISTRY_START_ARG="--insecure-registry ${INSECURE_REGISTRY_IP}:5000"
else
INSECURE_REGISTRY_START_ARG=""
fi
debug "CLIENT_EXE=$CLIENT_EXE"
debug "DEX_ENABLED=$DEX_ENABLED"
debug "DEX_REPO=$DEX_REPO"
debug "DEX_USER_NAMESPACES=$DEX_USER_NAMESPACES"
debug "DEX_VERSION=$DEX_VERSION"
debug "INSECURE_REGISTRY_IP=$INSECURE_REGISTRY_IP"
debug "INSECURE_REGISTRY_START_ARG=$INSECURE_REGISTRY_START_ARG"
debug "K8S_CNI=$K8S_CNI"
debug "K8S_CPU=$K8S_CPU"
debug "K8S_DISK=$K8S_DISK"
debug "K8S_DRIVER=$K8S_DRIVER"
debug "K8S_MEMORY=$K8S_MEMORY"
debug "K8S_VERSION=$K8S_VERSION"
debug "LB_ADDRESSES=$LB_ADDRESSES"
debug "MINIKUBE_EXE=$MINIKUBE_EXE"
debug "MINIKUBE_START_FLAGS=$MINIKUBE_START_FLAGS"
debug "MINIKUBE_PROFILE=$MINIKUBE_PROFILE"
debug "OLM_ENABLED=$OLM_ENABLED"
debug "OLM_VERSION=$OLM_VERSION"
debug "OUTPUT_PATH=$OUTPUT_PATH"
# If minikube executable is not found, abort.
if ! which ${MINIKUBE_EXE} > /dev/null 2>&1 ; then
echo "You do not have minikube installed [${MINIKUBE_EXE}]. Aborting."
exit 1
fi
debug "This script is located at $(pwd)"
debug "minikube is located at $(which ${MINIKUBE_EXE})"
if [ "$_CMD" = "start" ]; then
echo 'Starting minikube...'
# Check if no-kubernetes flag is present. If so, we shouldn't try to provide a kube version,
# start addons, or apply additional yaml
if grep -q 'no-kubernetes' <<< "${MINIKUBE_START_FLAGS}"
then
${MINIKUBE_EXEC_WITH_PROFILE} start \
${MINIKUBE_START_FLAGS} \
${INSECURE_REGISTRY_START_ARG} \
--cni=${K8S_CNI} \
--cpus=${K8S_CPU} \
--memory=${K8S_MEMORY} \
--disk-size=${K8S_DISK} \
--driver=${K8S_DRIVER}
[ "$?" != "0" ] && echo "ERROR: Failed to start minikube" && exit 1
exit 0
fi
${MINIKUBE_EXEC_WITH_PROFILE} start \
${MINIKUBE_START_FLAGS} \
${INSECURE_REGISTRY_START_ARG} \
--cni=${K8S_CNI} \
--cpus=${K8S_CPU} \
--memory=${K8S_MEMORY} \
--disk-size=${K8S_DISK} \
--driver=${K8S_DRIVER} \
--kubernetes-version=${K8S_VERSION}
[ "$?" != "0" ] && echo "ERROR: Failed to start minikube" && exit 1
echo 'Enabling the ingress addon'
${MINIKUBE_EXEC_WITH_PROFILE} addons enable ingress
[ "$?" != "0" ] && echo "ERROR: Failed to enable ingress addon" && exit 1
echo 'Enabling the image registry'
${MINIKUBE_EXEC_WITH_PROFILE} addons enable registry
[ "$?" != "0" ] && echo "ERROR: Failed to enable registry addon" && exit 1
if [ ! -z "${LB_ADDRESSES}" ]; then
echo 'Enabling the metallb load balancer'
${MINIKUBE_EXEC_WITH_PROFILE} addons enable metallb
[ "$?" != "0" ] && echo "ERROR: Failed to enable metallb addon" && exit 1
determine_full_lb_range
cat <<LBCONFIGMAP | ${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- apply -f -
apiVersion: v1
kind: ConfigMap
metadata:
namespace: metallb-system
name: config
data:
config: |
address-pools:
- name: default
protocol: layer2
addresses: [${LB_ADDRESSES}]
LBCONFIGMAP
[ "$?" != "0" ] && echo "ERROR: Failed to configure metallb addon" && exit 1
fi
if [ "${DEX_ENABLED}" == "true" ]; then
install_dex
fi
if [ "${OLM_ENABLED}" == "true" ]; then
install_olm
fi
echo 'Minikube has started.'
elif [ "$_CMD" = "stop" ]; then
ensure_minikube_is_running
echo 'Stopping minikube'
${MINIKUBE_EXEC_WITH_PROFILE} stop
elif [ "$_CMD" = "status" ]; then
ensure_minikube_is_running
check_insecure_registry
echo 'Status report for minikube'
${MINIKUBE_EXEC_WITH_PROFILE} status
elif [ "$_CMD" = "delete" ]; then
echo 'Deleting the entire minikube VM'
${MINIKUBE_EXEC_WITH_PROFILE} delete
elif [ "$_CMD" = "dashboard" ]; then
ensure_minikube_is_running
echo 'Accessing the Kubernetes console GUI. This runs in foreground, press Control-C to kill it.'
${MINIKUBE_EXEC_WITH_PROFILE} dashboard
elif [ "$_CMD" = "port-forward" ]; then
ensure_minikube_is_running
echo 'Forwarding port 20001 to the Kiali server. This runs in foreground, press Control-C to kill it.'
echo 'To access Kiali, point your browser to http://localhost:20001/kiali/console'
${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- -n istio-system port-forward $(${MINIKUBE_EXEC_WITH_PROFILE} kubectl -- -n istio-system get pod -l app.kubernetes.io/name=kiali -o jsonpath='{.items[0].metadata.name}') 20001:20001
elif [ "$_CMD" = "ingress" ]; then
ensure_minikube_is_running
echo 'Accessing the Kubernetes Ingress URL.'
gio open "http://$(${MINIKUBE_EXEC_WITH_PROFILE} ip)"
elif [ "$_CMD" = "istio" ]; then
ensure_minikube_is_running
echo 'Installing Istio'
./istio/install-istio-via-istioctl.sh -c ${CLIENT_EXE}
elif [ "$_CMD" = "bookinfo" ]; then
ensure_minikube_is_running
echo 'Installing Bookinfo'
./istio/install-bookinfo-demo.sh --mongo -tg -c ${CLIENT_EXE} -mp ${MINIKUBE_PROFILE}
get_gateway_url http2
echo 'To access the Bookinfo application, access this URL:'
echo "http://${GATEWAY_URL}/productpage"
echo 'To push requests into the Bookinfo application, execute this command:'
echo "watch -n 1 curl -o /dev/null -s -w '%{http_code}' http://${GATEWAY_URL}/productpage"
elif [ "$_CMD" = "gwurl" ]; then
ensure_minikube_is_running
if [ "${_CMD_OPT}" == "all" ]; then
print_all_gateway_urls
else
get_gateway_url $_CMD_OPT
echo 'The Gateway URL is:'
echo "${GATEWAY_URL}"
fi
elif [ "$_CMD" = "docker" ]; then
ensure_minikube_is_running
echo 'Your current minikube docker environment is the following:'
${MINIKUBE_EXEC_WITH_PROFILE} docker-env
echo 'Run the above command in your shell before building container images so your images will go in the minikube image registry'
elif [ "$_CMD" = "podman" ]; then
ensure_minikube_is_running
echo 'Your current minikube podman environment is the following:'
${MINIKUBE_EXEC_WITH_PROFILE} podman-env
echo 'Run the above command in your shell before building container images so your images will go in the minikube image registry'
elif [ "$_CMD" = "resetclock" ]; then
ensure_minikube_is_running
echo "Resetting the clock in the minikube VM"
${MINIKUBE_EXEC_WITH_PROFILE} ssh -- sudo date -u $(date -u +%m%d%H%M%Y.%S)
elif [ "$_CMD" = "olm" ]; then
ensure_minikube_is_running
install_olm
else
echo "ERROR: Missing required command"
exit 1
fi