-
Notifications
You must be signed in to change notification settings - Fork 1
/
ethd
executable file
·1067 lines (927 loc) · 34.6 KB
/
ethd
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
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
#!/usr/bin/env bash
set -Eeuo pipefail
__project_name="Era Docker"
__app_name="zkSync Era node"
__sample_service="era-node"
__docker_exe="docker"
__compose_exe="docker compose"
__compose_upgraded=0
version() {
# script version
grep "^This is" README.md
echo
__var="COMPOSE_FILE"
__value=$(__get_value_from_env "${__var}" "${__env_file}")
# Client versions
case "${__value}" in
*era.yml* )
echo "NODE_DOCKER_TAG: $(grep -E '^NODE_DOCKER_TAG=' .env | cut -d '=' -f2)"
docompose exec era-node zksync_external_node --version
;;&
*psql.yml* )
echo
docompose exec postgres pg_config --version
;;&
esac
}
__env_migrate() {
if [ ! -f "${__env_file}" ]; then
return 0
fi
__all_vars=( COMPOSE_FILE L1_RPC L1_CHAIN_ID L2_CHAIN_ID MAIN_NODE_URL PG_SNAPSHOT RUSTLOG DOMAIN RPC_HOST RPC_LB \
WS_HOST WS_LB RPC_PORT WS_PORT METRICS_PORT SCRIPT_TAG NODE_DOCKER_TAG PG_DOCKER_TAG CALL_TRACES API_NAMESPACES \
SQL_NODE SHARE_IP PG_PARAMS PRUNING PRUNING_RETENTION RUST_LOG )
__old_vars=( )
__new_vars=( )
__var=ENV_VERSION
__target_ver=$(__get_value_from_env "${__var}" "default.env")
__source_ver=$(__get_value_from_env "${__var}" "${__env_file}")
if [[ "${__target_ver}" -le "${__source_ver}" ]]; then # No changes in template, do nothing
return 0
fi
echo "Migrating ${__env_file} to version ${__target_ver}"
${__as_owner} cp "${__env_file}" "${__env_file}".source
__during_migrate=1
__migrated=1
${__as_owner} cp default.env "${__env_file}"
# Migrate over user settings
for __var in "${__all_vars[@]}"; do
__value=$(__get_value_from_env "${__var}" "${__env_file}.source")
if [ -n "${__value}" ] || [ "${__var}" = "PG_SNAPSHOT" ] || [ "${__var}" = "METRICS_PORT" ]; then
# Handle & gracefully, as well as multi-line
__update_value_in_env "${__var}" "$__value" "${__env_file}"
fi
done
# Move value from old variable name(s) to new one(s)
for __index in "${!__old_vars[@]}"; do
__var=${__old_vars[__index]}
__value=$(__get_value_from_env "${__var}" "${__env_file}.source")
if [ -n "${__value}" ]; then
__update_value_in_env "${__new_vars[__index]}" "$__value" "${__env_file}"
fi
done
__during_migrate=0
}
__upgrade_postgres() {
__source_vol="$(basename "$(pwd)")_erapg-data"
if [ -z "$(__dodocker volume ls -q -f "name=${__source_vol}")" ]; then
return 0
fi
__target_pg=16
__during_postgres=1
__source_pg="$(__dodocker run --rm -v "${__source_vol}":"/var/lib/postgresql/data" \
alpine:3 cat /var/lib/postgresql/data/PG_VERSION)"
if [ "${__source_pg}" -lt "${__target_pg}" ]; then
echo "Era is using PostgreSQL ${__source_pg}. The current version is PostgreSQL ${__target_pg}."
echo
while true; do
read -rp "Would you like to migrate to PostgreSQL ${__target_pg}? (Y/n) " yn
case $yn in
[Nn]o | [Nn] ) echo "Keeping PostgreSQL at version ${__source_pg}"; return 0;;
* ) break;;
esac
done
else
return 0
fi
__source_size="$(__dodocker run --rm -v "${__source_vol}":"/var/lib/postgresql/data" \
alpine:3 du -s /var/lib/postgresql/data/ | awk '{print $1}')"
re='^[0-9]+$'
if ! [[ "${__source_size}" =~ $re ]] ; then
echo "Unable to determine database size. This is likely a bug."
echo "__source_size is ${__source_size}"
return 70
fi
__get_docker_free_space
if [[ "${__free_space}" -lt $(( (__source_size * 2) + 10485760 )) ]]; then
echo
echo "You don't have enough free space to migrate the database."
echo "It is $(( __source_size / 1024 / 1024 )) GiB in size and you need twice as much free again."
echo
__display_docker_dir
echo
return
fi
__migrated_vol="$(basename "$(pwd)")_erapg-data-pg${__target_pg}-migrated"
__backup_vol="$(basename "$(pwd)")_erapg-data-pg${__source_pg}-backup"
echo "Stopping ${__app_name}"
__docompose stop era-node && __docompose rm -f era-node
echo "Stopping PostgreSQL"
__docompose stop postgres && __docompose rm -f postgres
echo
echo "Migrating database from PostgreSQL ${__source_pg} to PostgreSQL ${__target_pg}"
echo "If this step fails, the ${__app_name} database is likely corrupted."
echo
__dodocker pull "pats22/postgres-upgrade:${__source_pg}-to-${__target_pg}"
__dodocker volume create "${__migrated_vol}"
__dodocker run --rm -v "${__source_vol}":"/var/lib/postgresql/${__source_pg}/data" \
-v "${__migrated_vol}":"/var/lib/postgresql/${__target_pg}/data" \
"pats22/postgres-upgrade:${__source_pg}-to-${__target_pg}"
# Adjust ownership. We use 70; postgres-upgrade creates it with 999
__dodocker run --rm -v "${__migrated_vol}":"/var/lib/postgres" \
alpine:3 chown -R 70:70 /var/lib/postgres
# Conversion can leave us with a pg_hba.conf that does not allow connections
__dodocker run --rm -v "${__migrated_vol}":"/var/lib/postgres" \
alpine:3 sh -c 'grep -qxE "host\s+all\s+all\s+all\s+scram-sha-256" /var/lib/postgres/pg_hba.conf \
|| echo "host all all all scram-sha-256" \
>> /var/lib/postgres/pg_hba.conf'
echo
echo "Migration complete, moving data in erapg-data volume to backup"
__during_migrate=1
__dodocker volume create "${__backup_vol}"
__dodocker run --rm -v "${__source_vol}":"/var/lib/postgresql/data" \
-v "${__backup_vol}":"/var/lib/postgresql/${__source_pg}/data" \
alpine:3 mv /var/lib/postgresql/data/. "/var/lib/postgresql/${__source_pg}/data/"
echo "Moving migrated data to erapg-data volume"
__dodocker run --rm -v "${__source_vol}":"/var/lib/postgresql/data" \
-v "${__migrated_vol}":"/var/lib/postgresql/${__target_pg}/data" \
alpine:3 mv "/var/lib/postgresql/${__target_pg}/data/." /var/lib/postgresql/data/
__migrated=1
__dodocker volume remove "${__migrated_vol}"
echo
echo "Adjusting PostgreSQL Docker tag"
__var="PG_DOCKER_TAG"
# This gets used, but shellcheck doesn't recognize that
# shellcheck disable=SC2034
PG_DOCKER_TAG=${__target_pg}-bookworm
__update_value_in_env "${__var}" "${!__var}" "${__env_file}"
echo "${__app_name} has been stopped. You'll need to run \"$__me up\" to start it again."
echo
echo "A copy of your old Era database is in the Docker volume ${__backup_vol}."
echo "Confirm that everything works, and then delete it with \"docker volume rm ${__backup_vol}\"."
__during_postgres=0
}
__dodocker() {
$__docker_sudo $__docker_exe "$@"
}
__docompose() {
# I want word splitting here
# shellcheck disable=SC2086
$__docker_sudo $__compose_exe "$@"
}
__get_value_from_env() {
local __var_name="$1"
local __env_file="$2"
local __value
__value=$(awk -v var="$__var_name" '
BEGIN { __found = 0; __value = "" }
# Skip empty lines and comments
/^#|^\s*$/ {
next
}
# Match single-line unquoted value
$0 ~ "^[ \t]*"var"=[^\"].*$" {
gsub("^[ \t]*"var"=", "")
gsub(/^[ \t]*|[ \t]*$/, "", $0)
__value = $0
__found = 1
exit
}
# Match a quoted single-line value
$0 ~ "^[ \t]*"var"=\"[^\"]*\"[ \t]*$" {
gsub("^[ \t]*"var"=\"", "")
gsub(/"[ \t]*$/, "", $0)
__value = "\"" $0 "\""
__found = 1
exit
}
# Match the start of a multi-line value (with opening quote)
$0 ~ "^[ \t]*"var"=\"[^\"]*$" {
gsub("^[ \t]*"var"=\"", "")
__value = "\"" $0 "\n"
__found = 1
next
}
# Continue collecting lines for a multi-line value
__found && !/"[ \t]*$/ {
__value = __value $0 "\n"
next
}
# End of a multi-line value (with closing quote)
__found && /"[ \t]*$/ {
gsub(/[ \t]*"[ \t]*$/, "")
__value = __value $0 "\""
__found = 1
exit
}
END {
if (__found) {
# Print the value as is, including quotes for multi-line
print __value
}
}
' "$__env_file")
printf "%s" "$__value"
}
__update_value_in_env() {
# Call as __update_value_in_env "$__var" "$__value" "$__env_file"
local __var_name="$1"
local __new_value="$2"
local __env_file="$3"
# Escape backslashes for safety
local __escaped_value
__escaped_value=$(printf '%s' "${__new_value}" | sed 's/\\/\\\\/g')
# Check if the variable already exists in the .env file
if grep -q "^[ \t]*${__var_name}=" "${__env_file}"; then
# Variable exists, update it
awk -v var="$__var_name" -v new_value="$__escaped_value" '
BEGIN { in_block = 0; multi_line = 0 }
# Match the line that starts with the variable name
$0 ~ "^[ \t]*" var "=" {
# If the value starts with a quote, it may be a multi-line
if ($0 ~ "^[ \t]*" var "=\"") {
# Start of multi-line value
multi_line = 1
# Print the variable name with the new value, replacing & safely
gsub(/&/, "\\&", new_value)
print var "=" new_value
} else {
# Single-line value
gsub(/&/, "\\&", new_value)
print var "=" new_value
}
# Set the flag to indicate we are processing the target variable block
in_block = 1
next
}
# If we encounter a new variable definition, stop skipping lines
/^[A-Z_][A-Z0-9_]*=/ && in_block {
in_block = 0
multi_line = 0
}
# Continue to skip lines in a multi-line block if multi_line is true
multi_line && !/"[ \t]*$/ {
next
}
# If we reach the end of a multi-line value, reset flags
multi_line && /"[ \t]*$/ {
in_block = 0
multi_line = 0
next
}
# Print all lines if not in the target variable block
{ print }
' "$__env_file" > "${__env_file}.tmp" && mv "${__env_file}.tmp" "$__env_file"
else
# Variable does not exist, append it
printf "%s=%s\n" "$__var_name" "$__escaped_value" >> "$__env_file"
fi
}
__determine_distro() {
# Determine OS platform
__uname=$(uname | tr "[:upper:]" "[:lower:]")
# If Linux, try to determine specific distribution
if [ "$__uname" == "linux" ]; then
# If available, use LSB to identify distribution
if [ -n "$(which lsb_release 2>/dev/null)" ]; then
__distro=$(lsb_release -i | cut -d: -f2 | sed s/'^\t'//)
# Otherwise, use release info file
else
__distro=$(find /etc -maxdepth 1 -type f -name '[A-Za-z]*[_-][rv]e[lr]*' | grep -v "lsb" | cut -d'/' -f3 | cut -d'-' -f1 | cut -d'_' -f1)
fi
else
__distro=""
fi
# For everything else (or if above failed), just use generic identifier
[ "$__distro" == "" ] && __distro=$__uname
unset __uname
__distro=$(echo "$__distro" | tr "[:upper:]" "[:lower:]")
if [[ "$__distro" = "ubuntu" ]]; then
if [ "$__cannot_sudo" -eq 0 ]; then
if ! dpkg-query -W -f='${Status}' lsb-release 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-get update && ${__auto_sudo} apt-get -y install lsb-release
fi
fi
if [ -n "$(command -v lsb_release 2>/dev/null)" ]; then
__os_major_version=$(lsb_release -r | cut -d: -f2 | sed s/'^\t'// | cut -d. -f1)
else
__os_major_version=24 # Without sudo and lsb_release let's just skip the check
fi
elif [[ "$__distro" =~ "debian" ]]; then
if [ "$__cannot_sudo" -eq 0 ]; then
if ! dpkg-query -W -f='${Status}' lsb-release 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-get update && ${__auto_sudo} apt-get -y install lsb-release
fi
fi
if [ -n "$(command -v lsb_release 2>/dev/null)" ]; then
__os_major_version=$(lsb_release -r | cut -f2)
else
__os_major_version=12 # Without sudo and lsb_release let's just skip the check
fi
fi
}
__handle_docker_sudo() {
if [[ "$__distro" =~ "debian" || "$__distro" = "ubuntu" ]] && ! grep -qi microsoft /proc/version; then
systemctl status docker >/dev/null
__result=$?
if [ ! "${__result}" -eq 0 ]; then
echo "The Docker daemon is not running. Please check Docker installation."
echo "\"sudo systemctl status docker\" and \"sudo journalctl -fu docker\" will be helpful."
echo "Aborting."
exit 1
fi
fi
__docker_version=$(docker --version | awk '{ gsub(/,/, "", $3); print $3 }')
__docker_major_version=$(docker --version | awk '{ split($3, version, "."); print version[1]; }')
if [ "${__docker_major_version}" -lt 23 ]; then
__old_docker=1
echo "Docker ${__docker_version} detected"
else
__old_docker=0
fi
__docker_sudo=""
if ! docker images >/dev/null 2>&1; then
if [ "$__cannot_sudo" -eq 1 ]; then
echo "Cannot call Docker and cannot use sudo. Please make your user part of the docker group"
exit 1
fi
echo "Will use sudo to access Docker"
__docker_sudo="sudo"
fi
}
__handle_root() {
__cannot_sudo=0
if [ "${EUID}" -eq 0 ]; then
__as_owner="sudo -u ${OWNER}"
__auto_sudo=""
else
__as_owner=""
if groups | grep -q '\bsudo\b' || groups | grep -q '\badmin\b'; then
__auto_sudo="sudo"
else
__auto_sudo=""
__cannot_sudo=1
fi
fi
}
__check_compose_version() {
# Check for Compose V2 (docker compose) vs Compose V1 (docker-compose)
if docker compose version >/dev/null 2>&1; then
__old_compose=0
else
__old_compose=1
__compose_version=$($__docker_sudo docker-compose --version | sed -n -E -e "s/.*version [v]?([0-9.-]*).*/\1/ip")
if [ -n "${ETHDSECUNDO-}" ] || [ ! "${__command}" = "update" ]; then # Don't run this twice
echo
echo "You are using docker-compose ${__compose_version}, which is unsupported by Docker, Inc."
echo "${__project_name} only supports Compose V2."
echo
echo "It is recommended that you replace Compose V1 with Compose V2."
while true; do
read -rp "Do you want to update Docker Compose to V2? (yes/no) " __yn
case $__yn in
[Nn]* ) echo "Please be sure to update Docker Compose yourself!"; break;;
* ) __upgrade_compose; break;;
esac
done
fi
fi
}
__upgrade_compose() {
if ! type -P docker-compose >/dev/null 2>&1; then
echo "Docker Compose has already been updated to V2"
return
fi
echo "Updating Docker Compose to V2"
if [[ "$__distro" = "ubuntu" ]]; then
if [ "${__os_major_version}" -lt 22 ]; then
echo "${__project_name} cannot update Docker Compose on Ubuntu ${__os_major_version}."
echo "Consider upgrading to 22.04 and then 24.04."
exit 1
fi
if dpkg-query -W -f='${Status}' docker.io 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-mark manual docker.io
elif dpkg-query -W -f='${Status}' docker-ce 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-mark manual docker-ce
fi
${__auto_sudo} apt-get remove -y docker-compose
echo "Removed docker-compose"
${__auto_sudo} apt-get update
${__auto_sudo} apt-get install -y docker-compose-v2 docker-buildx
echo "Installed docker-compose-v2"
__old_compose=0
__compose_upgraded=1
elif [[ "$__distro" =~ "debian" ]]; then
${__auto_sudo} apt-get update && ${__auto_sudo} apt-get -y install ca-certificates curl gnupg
if [ "${__os_major_version}" -lt 11 ]; then
echo "${__project_name} cannot update Docker Compose on Debian ${__os_major_version}."
echo "Consider upgrading to 11 and then 12."
exit 1
fi
if dpkg-query -W -f='${Status}' docker.io 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-mark manual docker.io
elif dpkg-query -W -f='${Status}' docker-ce 2>/dev/null | grep -q "ok installed"; then
${__auto_sudo} apt-mark manual docker-ce
fi
${__auto_sudo} apt-get remove -y docker-compose
echo "Removed docker-compose"
${__auto_sudo} mkdir -p /etc/apt/keyrings
${__auto_sudo} curl -fsSL https://download.docker.com/linux/debian/gpg | ${__auto_sudo} gpg --dearmor --yes -o /etc/apt/keyrings/docker.gpg
${__auto_sudo} echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
$(lsb_release -cs) stable" | ${__auto_sudo} tee /etc/apt/sources.list.d/docker.list > /dev/null
${__auto_sudo} apt-get update
${__auto_sudo} apt-get install -y docker-compose-plugin docker-buildx-plugin
echo "Installed docker-compose-plugin"
__old_compose=0
__compose_upgraded=1
else
echo "${__project_name} does not know how to update Docker Compose on $__distro"
fi
}
__check_for_snap() {
if [[ "$__distro" = "ubuntu" && -n "$(which snap)" ]] && snap list 2>/dev/null | grep -qw 'docker'; then
echo
echo "WARNING! Snap Docker package detected. This WILL result in issues."
echo "Removing the package will delete volumes and require a resync."
echo
echo "Doing so is still highly recommended however."
echo
echo "The exact steps depend a little on whether there already is an apt version of Docker installed as well,"
echo "but in a nutshell \"$__me stop\" followed by \"sudo snap remove --purge docker\" followed by a reboot,"
echo "and as needed install docker-ce or docker.io with apt."
echo
echo "Do join us on CryptoManufaktur Discord to work through this issue."
echo
echo "Aborting, this is not safe"
exit 1
fi
}
install() {
if [ "$__cannot_sudo" -eq 1 ]; then
echo "The install command requires the user to be part of the sudo group, or on macOS the admin group"
exit 1
fi
while true; do
read -rp "This will attempt to install Docker and make your user part of the docker group. Do you wish to continue? (no/yes) " __yn
case $__yn in
[Yy]* ) break;;
* ) echo "Aborting, no changes made"; exit 130;;
esac
done
if [[ "$__distro" = "ubuntu" ]]; then
if [ "${__os_major_version}" -lt 22 ]; then
echo "${__project_name} cannot install Docker on Ubuntu ${__os_major_version}."
echo "Consider upgrading to 22.04 and then 24.04."
exit 1
fi
if [ -z "$(which docker)" ]; then
${__auto_sudo} apt-get update && ${__auto_sudo} apt-get install -y ca-certificates curl gnupg \
chrony pkg-config
${__auto_sudo} mkdir -p /etc/apt/keyrings
${__auto_sudo} curl -fsSL https://download.docker.com/linux/ubuntu/gpg | ${__auto_sudo} gpg --dearmor -o /etc/apt/keyrings/docker.gpg
${__auto_sudo} echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | ${__auto_sudo} tee /etc/apt/sources.list.d/docker.list > /dev/null
${__auto_sudo} apt-get update
${__auto_sudo} apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin \
docker-buildx-plugin
echo "Installed docker-ce and docker-compose-plugin"
else
echo "Docker is already installed"
fi
__groups=$(${__as_owner} groups)
if [[ ! "$__groups" =~ "docker" ]]; then
echo "Making your user part of the docker group"
${__auto_sudo} usermod -aG docker "${OWNER}"
echo "Please run newgrp docker or log out and back in"
else
echo "Your user is already part of the docker group"
fi
elif [[ "$__distro" =~ "debian" ]]; then
if [ -z "$(which docker)" ]; then
${__auto_sudo} apt-get update
${__auto_sudo} apt-get -y install ca-certificates curl gnupg chrony pkg-config
if [ "${__os_major_version}" -lt 11 ]; then
echo "${__project_name} cannot install Docker on Debian ${__os_major_version}."
echo "Consider upgrading to 11 and then 12."
exit 1
fi
${__auto_sudo} mkdir -p /etc/apt/keyrings
${__auto_sudo} curl -fsSL https://download.docker.com/linux/debian/gpg | ${__auto_sudo} gpg --dearmor -o /etc/apt/keyrings/docker.gpg
${__auto_sudo} echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
$(lsb_release -cs) stable" | ${__auto_sudo} tee /etc/apt/sources.list.d/docker.list > /dev/null
${__auto_sudo} apt-get update
${__auto_sudo} apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin \
docker-buildx-plugin
echo "Installed docker-ce and docker-compose-plugin"
else
echo "Docker is already installed"
fi
__groups=$(${__as_owner} groups)
if [[ ! "$__groups" =~ "docker" ]]; then
echo "Making your user part of the docker group"
${__auto_sudo} usermod -aG docker "${OWNER}"
echo "Please run newgrp docker or log out and back in"
else
echo "Your user is already part of the docker group"
fi
else
echo "${__project_name} does not know how to install Docker on $__distro"
exit 1
fi
return 0
}
__get_docker_free_space() { # set __free_space to what's available to Docker
if [[ "$OSTYPE" == "darwin"* ]]; then # macOS doesn't expose docker root dir to the OS
__free_space=$(__dodocker run --rm -v macos-space-check:/dummy busybox df -P /dummy | awk '/[0-9]%/{print $(NF-2)}')
else
__docker_dir=$(__dodocker system info --format '{{.DockerRootDir}}')
__free_space=$(df -P "${__docker_dir}" | awk '/[0-9]%/{print $(NF-2)}')
fi
__regex='^[0-9]+$'
if ! [[ "${__free_space}" =~ $__regex ]] ; then
echo "Unable to determine free disk space. This is likely a bug."
if [[ "$OSTYPE" == "darwin"* ]]; then
echo "df reports $(__dodocker run --rm -v macos-space-check:/dummy busybox df -P /dummy) and __free_space is ${__free_space}"
else
echo "df reports $(df -P "${__docker_dir}") and __free_space is ${__free_space}"
fi
exit 70
fi
}
__display_docker_dir() {
if [[ "$OSTYPE" == "darwin"* ]]; then # macOS doesn't expose docker root dir to the OS
echo "Here's total and used space on Docker's virtual volume"
__dodocker run --rm -v macos-space-check:/dummy busybox df -h /dummy
else
echo "Here's total and used space on ${__docker_dir}"
df -h "${__docker_dir}"
fi
}
__display_docker_volumes() {
echo
if [ -z "$(__dodocker volume ls -q -f "name=^$(basename "$(realpath .)")_[^_]+")" ]; then
echo "There are no Docker volumes for this copy of ${__project_name}"
echo
else
echo "Here are the Docker volumes used by this copy of ${__project_name} and their space usage:"
__dodocker system df -v | grep -A 50 "VOLUME NAME" | grep "^$(basename "$(dirname "$(realpath "${BASH_SOURCE[0]}")")")"
echo
fi
echo "If there is some mystery space being taken up, try \"sudo ncdu /\"."
echo
}
space() {
__get_docker_free_space
echo
if [[ "$OSTYPE" == "darwin"* ]]; then # macOS doesn't expose docker root dir to the OS
echo "You have $(( __free_space / 1024 / 1024 )) GiB free for Docker volumes"
else
echo "You have $(( __free_space / 1024 / 1024 )) GiB free on ${__docker_dir}"
fi
echo
__display_docker_dir
__display_docker_volumes
}
# Warn user if space is low, so they can prune
__check_disk_space() {
__get_docker_free_space
if [[ "${__free_space}" -lt 52428800 ]]; then
echo
echo "You have less than 50 GiB of free disk space:"
echo
__display_docker_dir
echo
echo "Pruning does not appear an option for your client mix."
echo "If total space is less than 1.8 TiB, consider cloning to a larger drive."
__display_docker_volumes
fi
}
__nag_os_version() {
if [[ "$__distro" = "ubuntu" ]]; then
if [ "${__os_major_version}" -lt 22 ]; then
echo
echo "Ubuntu ${__os_major_version} is older than the recommended 24.04 or 22.04 version."
echo
echo "Updating is neither urgent nor required, merely recommended."
fi
elif [[ "$__distro" =~ "debian" ]]; then
if [ "${__os_major_version}" -lt 11 ]; then
echo
echo "Debian ${__os_major_version} is older than the recommended 12 or 11 version."
echo
echo "Updating is neither urgent nor required, merely recommended."
fi
fi
}
__pull_and_build() {
__dodocker system prune --force
__docompose --profile tools pull
__docompose --profile tools build --pull
}
# Arguments are passed, but shellcheck doesn't recognize that
# shellcheck disable=SC2120
update() {
__during_update=1
if [[ $(${__as_owner} git status --porcelain) ]]; then
__dirty=1
else
__dirty=0
fi
__free_space=$(df -P "$(pwd)" | awk '/[0-9]%/{print $(NF-2)}')
__regex='^[0-9]+$'
if ! [[ "${__free_space}" =~ $__regex ]] ; then
echo "Unable to determine free disk space. This is likely a bug."
echo "df reports $(df -P "$(pwd)") and __free_space is ${__free_space}"
exit 70
elif [ "$(df -P "$(pwd)" | awk '/[0-9]%/{print $(NF-2)}')" -lt 1024 ]; then
echo "You have less than 1 MiB of space left on $(pwd)."
echo "Aborting, as an update is not safe."
exit 1
fi
__get_docker_free_space
if [ "${__free_space}" -lt 1048576 ]; then
echo "You have less than 1 GiB of space left for Docker volumes."
echo "Aborting, as an update is not safe."
exit 1
fi
if [ -z "${ETHDSECUNDO-}" ]; then
set +e
${__as_owner} git config pull.rebase false
__var="SCRIPT_TAG"
__value=$(__get_value_from_env "${__var}" "${__env_file}")
if [ -z "${__value}" ] || [ "${__value}" = "latest" ]; then
export ETHDPINNED=""
__branch=$(git rev-parse --abbrev-ref HEAD)
if [[ "${__branch}" =~ ^tag-v[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
git checkout main
fi
${__as_owner} git pull
else
export ETHDPINNED="${__value}"
${__as_owner} git fetch --tags
${__as_owner} git checkout -B "tag-${__value}" "tags/${__value}"
fi
export GITEXITCODE=$?
set -e
# BASH_SOURCE so newer code gets to do the update. Use an ENV var
# to avoid infinite loop
export ETHDSECUNDO=1
exec "${BASH_SOURCE[0]}" update "$@"
fi
__env_migrate
__pull_and_build
if [ "${__migrated}" -eq 1 ] && ! cmp -s "${__env_file}" "${__env_file}".source; then
cp "${__env_file}".source "${__env_file}".bak
rm "${__env_file}".source
echo "Your ${__env_file} configuration settings have been migrated to a fresh copy. You can \
find the original contents in ${__env_file}.bak."
echo
echo "List of changes made to ${__env_file} during migration - current on left, original on right:"
echo
diff -y --suppress-common-lines "${__env_file}" "${__env_file}".bak || true
else
echo "No changes made to ${__env_file} during update"
if [ -f "${__env_file}".source ]; then
${__as_owner} rm "${__env_file}".source || true
fi
fi
echo
if [ -z "${GITEXITCODE+x}" ] || [ "${GITEXITCODE}" -eq 0 ]; then
echo "A \"$__me up\" command will start using the new images and configuration."
else
echo "WARNING"
echo
echo "Updating ${__project_name} failed during \"git pull\""
echo
echo "Please try \"git pull\" manually."
echo "Do not run \"$__me up\" until git can update ${__project_name}."
echo "The current partial update risks startup failure."
fi
__nag_os_version
__upgrade_postgres
unset ETHDSECUNDO
unset GITEXITCODE
if [ "${__dirty}" -eq 1 ]; then
echo
echo "WARNING"
echo
echo "You have uncommitted local changes to ${__project_name}, which may interfere with updates."
echo "Please undo these changes or \"git commit\" them."
echo "These are the files with local changes:"
echo
${__as_owner} git status --porcelain
fi
if [ -n "${ETHDPINNED:-}" ]; then
echo "${__project_name} version is pinned to ${ETHDPINNED} in \".env\"."
echo "Please make sure to run compatible client versions."
fi
__during_update=0
}
__prep_conffiles() {
# Create ext-network.yml if it doesn't exist
if [ ! -f "ext-network.yml" ]; then
${__as_owner} cp ext-network.yml.sample ext-network.yml
fi
}
upgrade() {
update
}
start() {
__docompose up -d --remove-orphans "$@"
}
up() {
start "$@"
}
run() {
start "$@"
}
stop() {
__docompose down --remove-orphans "$@"
}
# Passed by user
# shellcheck disable=SC2120
down() {
stop "$@"
}
restart() {
stop "$@"
start "$@"
}
logs() {
__docompose logs "$@"
}
cmd() {
__docompose "$@"
}
terminate() {
if [ -z "$(__dodocker volume ls -q -f "name=^$(basename "$(realpath .)")_.+")" ]; then
echo "There are no data stores - Docker volumes - left to remove for this ${__app_name}."
stop
exit 0
fi
while true; do
read -rp "WARNING - this action will destroy all data stores for this ${__app_name}. Do you wish to continue? (No/Yes) " __yn
case $__yn in
[Yy]es ) break;;
* ) echo "Aborting, no changes made"; exit 130;;
esac
done
down
# In this case I want the word splitting, so rm can remove all volumes
# shellcheck disable=SC2046
__dodocker volume rm $(__dodocker volume ls -q -f "name=^$(basename "$(realpath .)")_.+")
echo
echo "All containers stopped and all volumes deleted"
echo
}
__handle_error() {
if [[ ! $- =~ e ]]; then
# set +e, do nothing
return 0
fi
local __exit_code=$1
local __line_no=$2
if [ "$__exit_code" -eq 130 ]; then
echo "$__me terminated by user"
else
echo "$__me terminated with exit code $__exit_code on line $__line_no"
if [ -n "${__command}" ]; then
echo "This happened during $__me ${__command} ${__params}"
fi
fi
if [ "$__during_update" -eq 1 ] && [ "$__during_migrate" -eq 1 ]; then
cp "${__env_file}" "${__env_file}".partial
cp "${__env_file}".source "${__env_file}"
echo
echo "Restored your ${__env_file} file, to undo partial migration. Please verify it looks correct."
echo "The partially migrated file is in ${__env_file}.partial for troubleshooting."
fi
if [ "$__during_postgres" -eq 1 ]; then
echo
if [ "$__during_migrate" -eq 1 ] && [ "$__migrated" -eq 0 ]; then
echo "Era database migration failed, while switching to the migrated data."
echo
echo "The Era database is likely corrupted at this point."
echo "The backup volume can be seen with \"docker volume ls\"."
elif [ "$__migrated" -eq 1 ]; then
echo "Era database migration failed, after switching to the migrated data."
echo
echo "The Era database itself is likely fine, but somewhere in the switch to PostgreSQL ${__target_pg}"
echo "an error occured, which is likely to keep your node from functioning correctly."
else
echo "Era database migration failed, but before removing the original data."
echo
echo "Your original Era database remains in place."
echo "You can safely update the node again, this time without migration, and start it."
fi
fi
}
help() {
echo "usage: ${__me} [-h|--help] <command>"
echo
echo "commands:"
echo " install"
echo " attempts to install Docker and Docker Compose for you"
echo " update "
echo " updates all client versions and ${__project_name} itself"
echo " up|start [service-name]"
echo " starts the ${__app_name}, or restarts containers that had their image or"
echo " configuration changed. Can also start a specific service by name"
echo " down|stop [service-name]"
echo " stops the ${__app_name}, or a specific service by name"
echo " restart [service-name]"
echo " restarts the ${__app_name}, or a specific service by name, a combination of down and up"
echo " version"
echo " prints the version(s) of currently running client(s)"
echo " logs"
echo " shows logs"
echo " cmd <command>"
echo " executes an arbitrary Docker Compose command. Use \"cmd help\" to list them"
echo " terminate"
echo " stops the ${__app_name} and destroys all data stores"
echo " space"
echo " show Docker volume space usage"
echo " help"
echo " print this help screen"
echo
echo "The logs command can be appended by flags and specify the container(s). example: "
echo
echo " $__me logs -f --tail 50 ${__sample_service}"
echo " shows logs only for ${__sample_service} service"
echo
echo "$__me will attempt to use sudo as needed for Docker commands"
echo
}
# Main body from here
__env_file=.env
__during_update=0
__during_migrate=0
__migrated=0
__command=""
__me="./$(basename "${BASH_SOURCE[0]}")"
trap '__handle_error $? $LINENO' ERR
if [[ "$#" -eq 0 || "$1" == "-h" || "$1" == "--help" ]]; then
help
exit 0
fi
cd "$(dirname "$(realpath "${BASH_SOURCE[0]}")")"
# Use this to make sure root doesn't end up owning files
# shellcheck disable=SC2012
OWNER=$(ls -ld . | awk '{print $3}')
if [ "${OWNER}" == "root" ]; then
echo "Please install ${__project_name} as a non-root user."
exit 0
fi
__command="$1"
shift
__params=$*