自动化部署java maven项目到多个目标主机的Shell脚本

本文涉及的产品
可观测链路 OpenTelemetry 版,每月50GB免费额度
简介:

本篇是《Linux Shell脚本之远程自动化部署java maven项目》的姊妹篇,但包含了bug、issue修正和添加了更多的支持特性,可以从GitHub上获取最新脚本内容:https://github.com/DingGuodong/AutomaticDeployJavaMavenProject 。

自动化部署java maven项目到多个主机的环境条件假设:

1.java maven项目至多有一个依赖项目

2.多个目标主机上的部署目录是相同的

支持特性:

1.在部署主机上将java maven项目以及依赖项目(当前脚本的编写只假设依赖项目只有一个)编译,将编译后的Class以及配置文件通过ssh上传到单个或多个目标主机的指定目录

2.单个目标主机部署模式支持手动版本回滚和自动回滚,多个目标主机部署模式支持手动回滚(手动回滚的意思就是需要人工选择需要回滚的版本)

3.支持在线更新配置文件,配置文件更新后运行脚本中的backup_manual函数,重新执行deploy[s]操作即可

4,允许用户定义是否跳过网络自检,这个特性在网络管理员禁用ICMP协议以及属于内网部署时有用

使用办法:             
将脚本上传到Linux任意目录,修改以下变量:

1
2
3
4
5
6
7
8
user_defined_project_clone_depends= "ssh://git@git.huntor.cn:18082/core/business-service-base.git"  # java maven项目的相关依赖源码文件所在的git地址,如果没有依赖则可省略
user_defined_project_clone= "ssh://git@git.huntor.cn:18082/core/business-service-core.git"  # java maven项目的源码文件所在的git地址
user_defined_deploy_target_host_ip= "10.6.28.135"  # 如果部署单个目标主机则在此处填写一个IP,无论是否部署多个目标主机,此项不能为空,多个目标主机的部署模式会用到这个主机上的配置文件
user_defined_deploy_targets_host_ip_list= "10.6.28.135 10.6.28.28"  # 如果一次性部署多个目标主机,则填写多个IP,用空格隔开,第一个IP必须与上面的user_defined_deploy_target_host_ip相同
user_defined_project_top_directory_to_target_host= "/tmp/deploy_test_target"  # 部署到目标主机上的哪一个目录
user_defined_docker_container_name= "testcontainer"  # 需要重启的容器名称
user_defined_project_conf_directory= "backup"  # 配置文件目录的绝对路径或者与此脚本相同目录位置的相对路径
user_defined_skip_check_network_and_resolver= "true"  # 如果想跳过网络自检,则设置为true,否则设置为false。

运行脚本和使用方法:           
在任意位置使用下方命令运行即可,脚本一旦运行一次,自动添加可执行权限,无须手动添加。

1
2
3
4
5
bash  /path/to/this .sh deploy  # 部署单个目标主机
bash  /path/to/this .sh deploys  # 部署多个目标主机
bash  /path/to/this .sh rollback_manual  # 手动回滚单个目标主机
bash  /path/to/this .sh rollbacks  # 手动回滚多个目标主机
bash  /path/to/this .sh backup_manual  # 当日志文件发生变更时,需要执行此命令,将配置文件同步到本地配置库

首次执行需要将配置文件的绝对路径准确的放入项目目录中,一次写入后期无须修改,如需修改配置文件,则直接修改部署目标主机上的配置文件(目标主机的第一个IP),每次修改完配置文件后需要执行bash /path/to/this.sh backup_manual命令,将配置文件同步到本地配置库(默认的位置是脚本所在目录下的backup目录)。

脚本内容:

可以从GitHub上获取最新脚本内容:https://github.com/DingGuodong/AutomaticDeployJavaMavenProject

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
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
#!/bin/bash
 
# Name: doDeploy.sh
#Execute this shell script to deploy Java projects built by Maven automatically on remote hosts.
 
# debug option
DEBUG= false
#DEBUG=true
 
if  $DEBUG ;  then
     old_PS4=$PS4
#    export PS4='+${BASH_SOURCE}:${LINENO}:${FUNCNAME[0]}: '
     export  PS4= '+${LINENO}: ${FUNCNAME[0]}: '  # if there is only one bash script, do not display ${BASH_SOURCE}
     _XTRACE_FUNCTIONS=$( set  +o |  grep  xtrace)
     set  -o xtrace
fi
 
# define user friendly messages
header="
Function: Execute this shell script to deploy Java projects built by Maven automatically on remote hosts.
License: Open  source  software
"
 
# user defined variables
# Where to get source code
user_defined_project_clone_depends= "ssh://git@git.huntor.cn:18082/core/business-service-base.git"
user_defined_project_clone= "ssh://git@git.huntor.cn:18082/core/business-service-core.git"
# TODO(Guodong Ding) do deploy once time with multi-hosts support, try using 'for + deploy'
user_defined_deploy_target_host_ip= "10.6.28.135"  # this is a mandatory field, and must be same as the first ip in $user_defined_deploy_targets_host_ip_list
user_defined_deploy_targets_host_ip_list= "10.6.28.135 10.6.28.28"
#user_defined_project_top_directory_to_target_host="/data/docker/business-service/bs-core-01"
#user_defined_docker_container_name="bs-core-01"
user_defined_project_top_directory_to_target_host= "/tmp/deploy_test_target"
user_defined_docker_container_name= "testcontainer"  # if you using a docker container other than a startup script located in sourcecode/bin/startup.sh, then set this to docker container name
user_defined_project_conf_directory= "backup"  # if you do NOT want to use configurations from deploy target, you should set this variable to where pointed to config files
user_defined_skip_check_network_and_resolver= "true"  # if system administrator disable ICMP protocol, set this any content but not null
# Setting how many days do you want save old releases, default is 10 days
save_old_releases_for_days=10
# end define variables
 
# pretreatment
test  -z ${user_defined_project_clone_depends} || project_clone_target_depends_1= "`echo ${user_defined_project_clone_depends} | awk -F '[/.]+' '{ print $(NF-1)}'`"
project_clone_target= "`echo ${user_defined_project_clone} | awk -F '[/.]+' '{ print $(NF-1)}'`"
project_clone_repository_name=${project_clone_target}
deployment_mode= ""
# end pretreatment
 
# Public header
# =============================================================================================================================
# resolve links - $0 may be a symbolic link
# learn from apache-tomcat-6.x.xx/bin/catalina.sh
PRG= "$0"
 
while  [ -h  "$PRG"  ];  do
   ls =` ls  -ld  "$PRG" `
   link=` expr  "$ls"  '.*-> \(.*\)$' `
   if  expr  "$link"  '/.*'  /dev/null then
     PRG= "$link"
   else
     PRG=` dirname  "$PRG" `/ "$link"
   fi
done
 
# Get standard environment variables
PRGDIR=` dirname  "$PRG" `
 
# echo color function, smarter, learn from lnmp.org lnmp install.sh
function  echo_r (){
     # Color red: Error, Failed
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[31m$1\033[0m"
}
function  echo_g (){
     # Color green: Success
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[32m$1\033[0m"
}
function  echo_y (){
     # Color yellow: Warning
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[33m$1\033[0m"
}
function  echo_b (){
     # Color blue: Debug Level 1
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[34m$1\033[0m"
}
 
function  echo_p (){
     # Color purple,magenta: Debug Level 2
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[35m$1\033[0m"
}
 
function  echo_c (){
     # Color cyan: friendly prompt, Level 1
     [ $ # -ne 1 ] && return 1
     echo  -e  "\033[36m$1\033[0m"
}
# end echo color function, smarter
 
#WORKDIR="`realpath ${WORKDIR}`"
WORKDIR= "`readlink -f ${PRGDIR}`"
 
# end public header
# =============================================================================================================================
 
USER= "`id -un`"
LOGNAME= "$USER"
if  [ $UID - ne  0 ];  then
     echo  "WARNING: Running as a non-root user, \"$LOGNAME\". Functionality may be unavailable. Only root can use some commands or options"
fi
 
function  command_exists() {
     # which "$@" >/dev/null 2>&1
     command  - v  "$@"  > /dev/null  2>&1
}
 
function  check_command_can_be_execute(){
     [ $ # -ne 1 ] && return 1
     command_exists $1
}
 
function  check_network_connectivity(){
     echo_b  "checking network connectivity ... "
     network_address_to_check=8.8.4.4
     stable_network_address_to_check=114.114.114.114
     ping_count=2
     ping  -c ${ping_count} ${network_address_to_check} > /dev/null
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         if  ping  -c ${ping_count} ${stable_network_address_to_check} > /dev/null ; then
             echo_g  "Network to $stable_network_address_to_check succeed! "
             echo_y  "Note: network to $network_address_to_check failed once! maybe just some packages loss."
         elif  ! ip route |  grep  default > /dev/null then
             echo_r  "Network is unreachable, gateway is not set."
             exit  1
         elif  ping  -c2 $(ip route |  awk  '/default/ {print $3}' ) > /dev/null then
             echo_r  "Network is unreachable, gateway is unreachable."
             exit  1
         else
             echo_r  "Network is blocked! "
             exit  1
         fi
     elif  [ ${retval} - eq  0 ];  then
         echo_g  "Check network connectivity passed! "
         echo
     fi
}
 
function  check_name_resolve(){
     echo_b  "checking DNS name resolve ... "
     target_name_to_resolve= "github.com"
     stable_target_name_to_resolve= "www.aliyun.com"
     ping_count=1
     if  ping   -c${ping_count} ${target_name_to_resolve} > /dev/null then
         echo_y  "Name lookup failed for $target_name_to_resolve with $ping_count times "
         if  ping   -c${ping_count} ${stable_target_name_to_resolve} > /dev/null then
             echo_g  "Name lookup success for $stable_target_name_to_resolve with $ping_count times "
         fi
         eval_md5sum_of_nameserver_config= "`md5sum /etc/resolv.conf | awk '{ print $1 }'`"
         if  test  ${eval_md5sum_of_nameserver_config} =  "674ea91675cdfac353bffbf49dc593c3" then
             echo_y  "Nameserver config file is validated, but name lookup failed for $target_name_to_resolve with $ping_count times"
             return  0
         fi
         [ -f  /etc/resolv .conf ] &&  cp  /etc/resolv .conf  /etc/resolv .conf_$( date  +%Y%m%d%H%M%S)~
         cat  > /etc/resolv .conf<<eof
nameserver 114.114.114.114
nameserver 8.8.4.4
eof
     check_name_resolve
     else
         echo_g  "Check DNS name resolve passed! "
         echo
         return  0
     fi
}
 
function  check_ssh_can_be_connect(){
     [ $ # -ne 1 ] && return 1
     echo_b  "Check if can ssh to remote host $1 ... "
     check_command_can_be_execute  ssh  ||  return  1
     # TODO(Guodong Ding) ssh can connect to remote host by using /etc/ssh/ssh_host_rsa_key or ~/.ssh/id_rsa
     ssh  -i  /etc/ssh/ssh_host_rsa_key  -p 22 -oStrictHostKeyChecking=no root@$1  "uname -a >/dev/null 2>&1"
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "Check ssh to remote host $1 failed! "
         exit  1
     else
         echo_g  "Check ssh to remote host $1 successfully! "
     fi
}
 
function  check_other_dependencies() {
     echo_b  "Checking other dependencies for deploy procedure... "
 
     echo_b  "\tChecking user customized variables..."
     # Refer:
     # if [ -z ${var+x} ]; then
     #     echo "var is unset"; else echo "var is set to '$var'"
     # fi
     # if [ "$var x" = " x" ]; then
     #     echo "var is empty"; else echo "var is set to '$var'"
     # fi
     # if [ -z $var ]; then
     #     echo "var is empty"; else echo "var is set to '$var'"
     # fi
     if  [[ -z ${user_defined_project_clone} ]];  then
         echo_r  "Error: user_defined_project_clone is undefined! "
         exit  1
     fi
 
     # Note: test command is strongly typed, can recognize string type and integer type
     if  test  ! -z  "$user_defined_deploy_target_host_ip"  -a ! -z  "$user_defined_deploy_targets_host_ip_list"  then
         user_defined_deploy_targets_host_first_ip_in_list= "`echo " $user_defined_deploy_targets_host_ip_list " | awk -F ' ' '{ print $1 }'`"
         if  test  "$user_defined_deploy_target_host_ip"  "$user_defined_deploy_targets_host_first_ip_in_list"  -a  "$deployment_mode"  "0"  then
             echo_g  "Run this shell script in multi-deployment mode, deploy to a group of hosts."
             saved_IFS=$IFS
             IFS= ' '
             for  ipaddress  in  ${user_defined_deploy_targets_host_ip_list};  do
                 check_ssh_can_be_connect $ipaddress
             done
             IFS=$saved_IFS
         else
             echo_r  "$user_defined_deploy_targets_host_ip_list is not equal to $user_defined_deploy_target_host_ip, this is a must! "
             exit  1
         fi
     elif  test  ! -z  "$user_defined_deploy_target_host_ip"  -a -z  "$user_defined_deploy_targets_host_ip_list"  -a  "$deployment_mode"  "1"  ; then
         echo_g  "Run this shell script in standalone-deployment mode, deploy to single host."
     elif  test  -z  "$user_defined_deploy_target_host_ip"  -a -z  "$user_defined_deploy_targets_host_ip_list"  ; then
         echo_r  "Error: both user_defined_deploy_target_host_ip and user_defined_deploy_targets_host_ip_list is undefined! "
         exit  1
     else
         echo_r  "Error: bad user defined parameters, please fix it and try again! "
         exit  1
     fi
     if  [[ -z ${user_defined_project_top_directory_to_target_host} ]];  then
         echo_r  "Error: user_defined_project_top_directory_to_target_host is undefined! "
         exit  1
     fi
 
     if  test  -z $user_defined_project_conf_directory;  then
         echo_y  "Warning: user defined project conf directory is not defined! "
     fi
 
     echo_g  "\tChecking user customized and defined variables passed! "
 
     echo_b  "\tChecking disk space available..."
     disk_space_available=` df  ${WORKDIR} |  tail  -n1 |  awk  '{print $(NF-2)}' `
     if  [[ ${disk_space_available} -lt 2097152 ]];  then
         echo_y  "Warning: Disk space of $WORKDIR is smaller than 2GB"
         #exit 1
     else
         echo_g  "\tChecking disk space available passed! "
     fi
 
     echo_g  "All required dependencies check passed! "
     echo
 
}
 
function  setDirectoryStructureOnLocalHost() {
     if  [ -f ${WORKDIR}/.capistrano_ds_lock ]; then
         echo_g  "Set directory structure has been done, skipping. "
         return
     fi
     echo_b  "Setting directory structure... "
     # learn from capistrano
     # Refer: http://capistranorb.com/documentation/getting-started/structure/
     # Refer: http://capistranorb.com/documentation/getting-started/structure/#
 
     # ├── current -> /var/www/my_app_name/releases/20150120114500/
     # ├── releases
     # │   ├── 20150080072500
     # │   ├── 20150090083000
     # │   ├── 20150100093500
     # │   ├── 20150110104000
     # │   └── 20150120114500
     # ├── repo
     # │   └── <VCS related data>
     # ├── revisions.log
     # └── shared
     #     └── <linked_files and linked_dirs>
 
     # current is a symlink pointing to the latest release. This symlink is updated at the end of a successful deployment. If the deployment fails in any step the current symlink still points to the old release.
     # releases holds all deployments in a timestamped folder. These folders are the target of the current symlink.
     # repo holds the version control system configured. In case of a git repository the content will be a raw git repository (e.g. objects, refs, etc.).
     # revisions.log is used to log every deploy or rollback. Each entry is timestamped and the executing user (username from local machine) is listed. Depending on your VCS data like branch names or revision numbers are listed as well.
     # shared contains the linked_files and linked_dirs which are symlinked into each release. This data persists across deployments and releases. It should be used for things like database configuration files and static and persistent user storage handed over from one release to the next.
     # The application is completely contained within the path of :deploy_to. If you plan on deploying multiple applications to the same server, simply choose a different :deploy_to path.
 
     # Check directories for deploy
     [ ! -d ${WORKDIR} /release  ] &&  mkdir  ${WORKDIR} /release
     [ ! -d ${WORKDIR} /repository  ] &&  mkdir  ${WORKDIR} /repository
     [ ! -d ${WORKDIR} /share  ] &&  mkdir  ${WORKDIR} /share
     # end directories structure
 
     # Additional directories structure for full deploy operation
     # for backup remote host config file
     [ ! -d ${WORKDIR} /backup  ] &&  mkdir  ${WORKDIR} /backup
 
     # set a directories structure lock
     touch  ${WORKDIR}/.capistrano_ds_lock
     echo_g  "Set directory structure successfully! "
     echo
}
 
function  clean_old_releases(){
     echo_b  "Clean old releases... "
     save_days=${save_old_releases_for_days:-10}
     if  [ ! -d ${WORKDIR} /release  ];  then
         echo_b  "Can NOT find release directory, skipping . "
         return
     fi
     need_clean=$( find  ${WORKDIR} /release  -mtime +${save_days} - exec  ls  '{}'  \;)
     if  [ ! -z ${need_clean} ];  then
         echo_c  "Expired releases found and will be removed from project! "
         find  ${WORKDIR} /release  -mtime +${save_days} - exec  rm  -rf  '{}'  \;
         if  [ $? - eq  0 ];  then
             echo_g  "Expired releases have removed from project! "
         else
             echo_r  "Can NOT remove expired releases, please feel free to alter to administrators. "
         fi
     else
         echo_g  "All releases are not expired, skipping. "
     fi
 
}
 
function  clean_old_logs(){
     echo_b  "Clean old logs... "
     save_days=${save_old_releases_for_days:-10}
     need_clean=$( find  ${WORKDIR}/ -name  "*.log"  -mtime +${save_days} - exec  ls  '{}'  \;)
     if  [ ! -z ${need_clean} ];  then
         echo_c  "Expired releases found and will be removed from project! "
         find  -L ${WORKDIR}/ -maxdepth 1 -name  "*.log"  -a ! -name  "^."  -mtime +${save_days} - exec  rm  -rf  '{}'  \;
         if  [ $? - eq  0 ];  then
             echo_g  "Expired logs have removed from project! "
         else
             echo_r  "Can NOT remove expired logs, please feel free to alter to administrators. "
         fi
     else
         echo_g  "All logs are not expired, skipping. "
     fi
 
}
 
# git_project_clone repository branch
function  git_project_clone(){
     set  -o errexit
     [ $ # -ge 1 ] && project_clone_repository="$1"
     project_clone_repository_name= "`echo ${project_clone_repository} | awk -F '[/.]+' '{ print $(NF-1)}'`"
     project_clone_directory=${WORKDIR} /repository/ ${project_clone_repository_name}
     if  test  -n $2;  then
         branch= "$2"
     else
         branch= "develop"
     fi
     if  test  ! -d ${project_clone_directory};  then
         echo_b  "git clone from $project_clone_repository"
         # git clone git@github.com:name/app.git -b master
         git clone ${project_clone_repository} ${project_clone_directory} >>${WORKDIR} /git_ $( date  +%Y%m%d)_$$.log 2>&1
             # TODO(Guodong Ding) get branch names or revision numbers from VCS data
 
         cd  ${project_clone_directory}
         git checkout ${branch} >>${WORKDIR} /git_ $( date  +%Y%m%d)_$$.log 2>&1
         cd  ..
         echo_g  "git clone from $project_clone_repository successfully! "
     else
         echo_b  "git pull from $project_clone_repository"
         cd  ${project_clone_directory}
         git pull >>${WORKDIR} /git_ $( date  +%Y%m%d)_$$.log 2>&1
         git checkout ${branch} >>${WORKDIR} /git_ $( date  +%Y%m%d)_$$.log 2>&1
         # TODO(Guodong Ding) get branch names or revision numbers from VCS data
         cd  ..
         echo_g  "git pull from $project_clone_repository successfully! "
     fi
     set  +o errexit
}
 
function  maven_build_project_deprecated(){
     set  -o errexit
     echo_b  "Do mvn build java project... "
     check_command_can_be_execute mvn
     [ $ # -ge 1 ] && project_clone_repository="$1"
     project_clone_repository_name= "`echo ${project_clone_repository} | awk -F '[/.]+' '{ print $(NF-1)}'`"
     project_clone_directory=${WORKDIR} /repository/ ${project_clone_repository_name}
     cd  ${project_clone_directory}
     mvn  install  >>${WORKDIR} /mvn_build_ $( date  +%Y%m%d)_$$.log 2>&1
     mvn clean package >>${WORKDIR} /mvn_build_ $( date  +%Y%m%d)_$$.log 2>&1
     cd  ..
     echo_g  "Do mvn build java project finished with exit code 0! "
     set  +o errexit
}
 
function  maven_build_project(){
     echo_b  "Do mvn build java project for `echo $1 | awk -F '[/.]+' '{ print $(NF-1)}'`... "
     check_command_can_be_execute mvn
     [ $ # -ge 1 ] && project_clone_repository="$1"
     project_clone_repository_name= "`echo ${project_clone_repository} | awk -F '[/.]+' '{ print $(NF-1)}'`"
     project_clone_directory=${WORKDIR} /repository/ ${project_clone_repository_name}
 
     cd  ${project_clone_directory}
     mvn  install  >>${WORKDIR} /mvn_build_ $( date  +%Y%m%d)_$$.log 2>&1
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "mvn install failed! More details refer to ${WORKDIR}/mvn_build_$(date +%Y%m%d)_$$.log"
         exit  1
     else
         echo_g  "mvn install for ${project_clone_repository_name} successfully! "
     fi
 
     mvn clean package >>${WORKDIR} /mvn_build_ $( date  +%Y%m%d)_$$.log 2>&1
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "mvn clean package for ${project_clone_repository_name} failed! More details refer to ${WORKDIR}/mvn_build_$(date +%Y%m%d)_$$.log"
         exit  1
     else
         echo_g  "mvn clean package for ${project_clone_repository_name} successfully! "
     fi
     cd  ${WORKDIR}
     echo_g  "Do mvn build java project finished for ${project_clone_repository_name} with exit code 0! "
     echo
}
 
# ssh_execute_command_on_remote_host hostname command
function  ssh_execute_command_on_remote_host(){
     [ $ # -ne 2 ] && return 1
     ssh  -i  /etc/ssh/ssh_host_rsa_key  -p 22 -oStrictHostKeyChecking=no root@$1  "$2"  >>${WORKDIR} /ssh_command_ $( date  +%Y%m%d)_$$.log 2>&1
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "ssh execute command on remote host $2 failed! "
         test  -s ${WORKDIR} /ssh_command_ $( date  +%Y%m%d)_$$.log && echo_r  "\tMore details refer to ${WORKDIR}/ssh_command_$(date +%Y%m%d)_$$.log"
         return  1
     else
         echo_g  "ssh execute command on remote host $2 successfully! "
         return  0
     fi
}
 
function  restart_docker_container(){
     echo_b  "Restarting docker container..."
     [ $ # -ne 2 ] && return 1
     # TODO(Guodong Ding) if we need restart more related docker container
     local  user_defined_docker_container_name= ""
     local  remote_host_ip= ""
     test  -n $1 && remote_host_ip= "$1"
     test  -n $1 && user_defined_docker_container_name= "$2"
     ssh_execute_command_on_remote_host  "$remote_host_ip"  "docker restart $user_defined_docker_container_name"
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "restart docker container for  $user_defined_docker_container_name on $remote_host_ip failed! "
         exit  1
     else
         echo_g  "restart docker container for $user_defined_docker_container_name on $remote_host_ip successfully! "
         return  0
     fi
}
 
# scp_local_files_to_remote_host local_path remote_hostname remote_path
function  scp_local_files_to_remote_host(){
     [ $ # -ne 3 ] && return 1
     [ ! -d $1 -a ! -f $1 ] &&  return  1
#    check_ssh_can_be_connect $2
     scp  -i  /etc/ssh/ssh_host_rsa_key  -P 22 -oStrictHostKeyChecking=no -rp $1 root@$2:$3 > /dev/null  2>&1
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "scp local files to remote host failed! "
         exit  1
     else
         echo_g  "scp local files to remote host successfully! "
     fi
 
}
 
# scp_remote_files_to_local_host remote_hostname remote_path local_path
function  scp_remote_files_to_local_host(){
     [ $ # -ne 3 ] && return 1
#    check_ssh_can_be_connect $1
     scp  -i  /etc/ssh/ssh_host_rsa_key  -P 22 -oStrictHostKeyChecking=no -rp root@$1:$2 $3 > /dev/null  2>&1
     retval=$?
     if  [ ${retval} - ne  0 ] ;  then
         echo_r  "scp remote files to local host failed! "
         exit  1
     else
         echo_g  "scp remote files to local host successfully! "
     fi
}
 
function  backup_single_file(){
     set  -o errexit
     if  "$#"  - ne  1 ];  then
         return  1
     fi
     backup_filename_origin= "$1"
     operation_date_time= "`date +" %Y%m%d%H%M%S "`"
     backup_filename_prefix= ".backup_"
     backup_filename_suffix= "_origin_$operation_date_time~"
     backup_filename_target= "$backup_filename_prefix$backup_filename_origin$backup_filename_suffix"
     test  -f $backup_filename_origin &&  cp  $backup_filename_origin $backup_filename_target
     set  +o errexit
}
 
 
# Function description: backup files
# Note: accept $@ parameters
function  backup_files(){
     # TODO(Guodong Ding) improvements here
     set  -o errexit
     if  [ $ # -eq 0 ]; then
         return  1
     fi
     file_list=$@
     operation_date_time= "_`date +" %Y%m%d%H%M%S "`"
     log_filename= ".log_$$_${RANDOM}"
     log_filename_full_path= /tmp/ $log_filename
     touch  $log_filename_full_path
     old_IFS=$IFS
     IFS= " "
     for  file  in  $file_list; do
         real_file=$(realpath $ file )
         [ -f $real_file ] &&  cp  $real_file $ file $operation_date_time~
         [ -f $log_filename_full_path ] &&  echo  "\mv -f $file$operation_date_time~ $file"  >>$log_filename_full_path
     done
     IFS= "$old_IFS"
     set  +o errexit
     return  0
}
 
# Function description:
function  rollback_files(){
     # TODO(Guodong Ding) improvements here
     [ -f $log_filename_full_path ] && . $log_filename_full_path
     \ rm  -f $log_filename_full_path
     exit  2
}
 
function  backup_directories(){
     # TODO(Guodong Ding) continue here
     if  [ $ # -ne 1 ]; then
         return  1
     fi
     backup_filename_origin= "$1"
     operation_date_time= "`date +" %Y%m%d%H%M%S "`"
     backup_filename_prefix= ".backup_"
     backup_filename_suffix= "_origin_$operation_date_time~"
     backup_filename_target= "$backup_filename_prefix$backup_filename_origin$backup_filename_suffix"
     test  -f $backup_filename_origin &&  cp  -r $backup_filename_origin $backup_filename_target
}
 
function  rollback_directories(){
     # TODO(Guodong Ding) continue here
     return
}
 
 
#
function  backup_remote_host_config_files(){
     # TODO(Guodong Ding) did not throw a exception when first deploy and test -z "$user_defined_project_conf_directory"
     echo_b  "backup remote host config files..."
 
     # backup operation only executed once time, using '$0 backup_manual' backup new configuration files.
     # if ${WORKDIR}/backup is not empty then return 0 to exit
     if  "$(ls -A ${WORKDIR}/backup)"  ];  then
         [ -f ${WORKDIR} /backup/ .backup_operation_once.log ] && backup_operation= "`cat ${WORKDIR}/backup/.backup_operation_once.log`"
         echo_g  "Backup remote host config files operation had been done, $backup_operation, now skipping ... "
         return  0
     fi
 
     # TODO(Guodong Ding) if $user_defined_project_conf_directory is empty and remote host target directory is empty(first deploy), will cause exit with 1
     ssh_execute_command_on_remote_host $user_defined_deploy_target_host_ip  "test \"\$(ls -A $user_defined_project_top_directory_to_target_host 2>/dev/null)\""
     if  test  $? - eq  0;  then
         scp_remote_files_to_local_host ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}/* ${WORKDIR} /backup
         # get config files
         "$(ls -A ${WORKDIR}/backup)"  ] &&  find  ${WORKDIR} /backup/ . - type  f ! -name . -a ! -name  '*.xml*'  -a ! -name  '*.properties*'  -a ! -name  '*.version*'  - exec  rm  -f --  '{}'  \;
         # remove empty directory, 'for + rmdir'
         find  ${WORKDIR} /backup/ . -empty - type  d -delete
         # TODO(Guodong Ding) improvements here
         echo_g  "backup remote host config files finished."
         echo  "`date +%Y%m%d`"  > ${WORKDIR} /backup/ .backup_operation_once.log
     else
         echo_y  "This maybe first time to deploy or variable 'user_defined_project_conf_directory' is not defined! "
     fi
}
 
function  rollback_remote_host_config_files(){
     echo_b  "rollback remote host config files..."
     #scp_local_files_to_remote_host ${WORKDIR}/backup ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
     saved_IFS=$IFS
     IFS= ' '
     cd  ${WORKDIR} /current
     for  file  in  ${WORKDIR} /backup/ *; do
         scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
         # override all configuration files to current
         \ cp  -r ${ file } ${WORKDIR} /current
     done
     cd  ${WORKDIR}
     IFS=${saved_IFS}
     # TODO(Guodong Ding) if save remote host config files, if there are no changes on config files
     # some ops
 
     # TODO(Guodong Ding) improvements here
     echo_g  "rollback remote host config files finished."
}
 
function  make_current_workable_source(){
     # check a directories lock, Note: this is redundant
     if  [[ ! -f ${WORKDIR}/.capistrano_ds_lock ]];  then
         setDirectoryStructureOnLocalHost
     fi
     clean_old_releases
     clean_old_logs
     # do dependencies checking
     if  test  ! -z $user_defined_skip_check_network_and_resolver;  then
         echo_g  "skipping checking network connectivity and name resolve."
     else
         check_network_connectivity
         check_name_resolve
     fi
 
     check_other_dependencies
 
     # do core job
     # TODO(Guodong Ding) if we need a git_project_clone "$user_defined_project_clone_depends" here using auto judgment statement
     test  -z ${user_defined_project_clone_depends} || git_project_clone  "$user_defined_project_clone_depends"
     git_project_clone  "$user_defined_project_clone"
     test  -z ${user_defined_project_clone_depends} || maven_build_project  "$user_defined_project_clone_depends"
     maven_build_project  "$user_defined_project_clone"
     cd  ${WORKDIR}
 
     # links_target_directory_to_current
     # Make directory to release directory
     if  test  ! -d ${WORKDIR} /release  -o ! -d ${WORKDIR} /share then
         echo_r  "capistrano directory structure is broken, make sure the file .capistrano_ds_lock is deleted before a new deploy! "
#        test -f ${WORKDIR}/.capistrano_ds_lock && \rm -rf  ${WORKDIR}/.capistrano_ds_lock
         exit  1
     fi
     new_release_just_created= "$WORKDIR/release/$(date +%Y%m%d%H%M%S)"
     [ ! -d ${new_release_just_created} ] &&  mkdir  ${new_release_just_created}
     [ -d ${WORKDIR} /repository/ ${project_clone_repository_name} /target/ ${project_clone_repository_name}/ ] && \
         \ cp  -rf ${WORKDIR} /repository/ ${project_clone_repository_name} /target/ ${project_clone_repository_name}/* ${new_release_just_created}
      # Make source code symbolic link to current
     ( [ -f ${WORKDIR} /current  ] || [ -d ${WORKDIR} /current  ] ) &&  rm  -rf ${WORKDIR} /current
     ln  -s ${new_release_just_created} ${WORKDIR} /current
 
     # Move conf and logs directives from release to share if found
     [ -d ${WORKDIR} /release/conf  ] &&  mv  ${WORKDIR} /release/conf  ${WORKDIR} /share/conf
     [ -d ${WORKDIR} /release/logs  ] &&  mv  ${WORKDIR} /release/logs  ${WORKDIR} /share/logs
 
     # Make conf and logs symbolic link to current
     [ -d ${WORKDIR} /share/conf  ] &&  ln  -s ${WORKDIR} /share/conf  ${WORKDIR} /current/conf
     [ -d ${WORKDIR} /share/logs  ] &&  ln  -s ${WORKDIR} /share/logs  ${WORKDIR} /current/logs
}
 
# distribute current workable files to remote host
function  deploy() {
     # do make_current_workable_source before deploy every time
     make_current_workable_source
 
     echo_b  "Do deploy on $user_defined_deploy_target_host_ip ..."
     # backup remote host config files
     [ -z ${user_defined_project_conf_directory} ] && backup_remote_host_config_files
 
     saved_IFS=$IFS
     IFS= ' '
     cd  ${WORKDIR} /current
     for  file  in  ${WORKDIR} /current/ *; do
         scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
     done
     cd  ${WORKDIR}
     IFS=${saved_IFS}
 
     # rollback remote host config files
     [ -z ${user_defined_project_conf_directory} ] && rollback_remote_host_config_files
     if  test  ! -z  "${user_defined_project_conf_directory}"  -a -d ${user_defined_project_conf_directory} ;  then
         saved_IFS=$IFS
         IFS= ' '
         cd  ${WORKDIR} /current
         for  file  in  ${user_defined_project_conf_directory}/*; do
             scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
             # override all configuration files to current
             \ cp  -rf $ file  ${WORKDIR} /current
         done
         cd  ${WORKDIR}
         IFS=${saved_IFS}
     fi
 
     # backup remote host config files to local again for next using
     [ ! -z ${user_defined_project_conf_directory} ] && backup_remote_host_config_files
 
     # Start service or validate status on remote host
     if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
         ssh_execute_command_on_remote_host $user_defined_deploy_target_host_ip  "$user_defined_project_top_directory_to_target_host/bin/startup.sh start"
         RETVAL=$?
     else
         test  -z ${user_defined_docker_container_name} || restart_docker_container $user_defined_deploy_target_host_ip ${user_defined_docker_container_name}
         # TODO(Guodong Ding) external health check
         RETVAL=$?
     fi
 
     # if started ok, then create a workable program to a file
     if  [[ ${RETVAL} - eq  0 ]];  then
         # Note cat with eof must start at row 0, and with eof end only, such as no blank spaces, etc
         cat  >${WORKDIR} /share/workable_program .log <<eof
${new_release_just_created}
eof
         echo_g  "Deploy successfully for $user_defined_deploy_target_host_ip! "
         echo_g  "Current workable version is $(cat ${WORKDIR}/share/workable_program.log)"
     else
         echo_r  "Error: Deploy failed! "
         ${WORKDIR}/` basename  $0` rollback
     fi
}
 
# Rollback to last right configuration
function  rollback() {
     echo_b  "Rollback to last right configuration... "
     # The key point is find last files which can work
     WORKABLE_PROGRAM=` cat  ${WORKDIR} /share/workable_program .log`
     if  [[ -z ${WORKABLE_PROGRAM} ]];  then
         echo_r  "Error: Can NOT find workable release version! Please check if it is first deployment! "
         exit  1
     fi
     # Stop service if we have
     if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
         ssh_execute_command_on_remote_host ${user_defined_deploy_target_host_ip}  "$user_defined_project_top_directory_to_target_host/bin/startup.sh stop"
     fi
 
     # Remove failed deploy
     rm  -rf ${WORKDIR} /current
 
     # Remake source code symbolic link to current
     ln  -s ${WORKABLE_PROGRAM} ${WORKDIR} /current
 
     # Remake conf and logs symbolic link to current
     [ -d ${WORKDIR} /share/conf  ] &&  ln  -s ${WORKDIR} /share/conf  ${WORKDIR} /current
     [ -d ${WORKDIR} /share/logs  ] &&  ln  -s ${WORKDIR} /share/logs  ${WORKDIR} /current
 
     # backup remote host config files
     [ -z ${user_defined_project_conf_directory} ] && backup_remote_host_config_files
 
#    scp_local_files_to_remote_host ${WORKDIR}/current/ ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
     saved_IFS=$IFS
     IFS= ' '
     cd  ${WORKDIR} /current
     for  file  in  ${WORKDIR} /current/ *; do
         scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
     done
     cd  ${WORKDIR}
     IFS=${saved_IFS}
 
     # rollback remote host config files
     [ -z ${user_defined_project_conf_directory} ] && rollback_remote_host_config_files
     if  test  ! -z  "${user_defined_project_conf_directory}"  -a -d ${user_defined_project_conf_directory};  then
         saved_IFS=$IFS
         IFS= ' '
         cd  ${WORKDIR} /current
         for  file  in  ${user_defined_project_conf_directory}/*; do
             scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
         done
         cd  ${WORKDIR}
         IFS=${saved_IFS}
     fi
 
     # Start service or validate status
     if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
         ssh_execute_command_on_remote_host $user_defined_deploy_target_host_ip  "$user_defined_project_top_directory_to_target_host/bin/startup.sh restart"
         RETVAL=$?
     else
         test  -z ${user_defined_docker_container_name} || restart_docker_container $user_defined_deploy_target_host_ip ${user_defined_docker_container_name}
         # TODO(Guodong Ding) external health check
         RETVAL=$?
     fi
 
     # if started ok, then create a workable program to a file
     if  [[ ${RETVAL} - eq  0 ]];  then
         echo_g  "Rollback successfully! "
         echo_g  "current workable version is $WORKABLE_PROGRAM"
     fi
}
 
# rollback to any workable version which user wished by manually
function  rollback_manual(){
     echo_b  "This function will rollback to any workable version which user wished by manually."
     # TODO(Guodong Ding) linux shell trap command several ctrl+c
     echo_p  "Enter 'reset' command to reset terminal when something go wrong."
     read  -e -s -n 1 -p  "Press any key to continue or Press 'Ctrl+C' exit."
     if  test  -d $WORKDIR /release  -a  "$(ls -A $WORKDIR/release 2>/dev/null)"  ; then  # judge a directory if is empty
         echo_b  "Current workable releases( Latest 5 ) are here: "
         # Alternative implementation: ls -u -1 -d $WORKDIR/release/* | tail -n6 | sed -n '1,4p'
         ls  -u -1 -d $WORKDIR /release/ * |  tail  -n6 |  head  -n4
         read  -p  "Which release do you want rollback? Press Enter after input. "  user_input_release_to_rollback
         if  test  -d $user_input_release_to_rollback;  then
             rm  -rf ${WORKDIR} /current
             ln  -s ${user_input_release_to_rollback} ${WORKDIR} /current
             # Remake conf and logs symbolic link to current
             [ -d ${WORKDIR} /share/conf  ] &&  ln  -s ${WORKDIR} /share/conf  ${WORKDIR} /current
             [ -d ${WORKDIR} /share/logs  ] &&  ln  -s ${WORKDIR} /share/logs  ${WORKDIR} /current
 
             # backup remote host config files
             [ -z ${user_defined_project_conf_directory} ] && backup_remote_host_config_files
 
#            # rollback remote host config files
#            [ -z ${user_defined_project_conf_directory} ] && rollback_remote_host_config_files
 
             if  test  ! -z  "${user_defined_project_conf_directory}"  -a -d ${user_defined_project_conf_directory};  then
                 saved_IFS=$IFS
                 IFS= ' '
                 cd  ${WORKDIR} /current
                 for  file  in  ${user_defined_project_conf_directory}/*; do
                     \ cp  -rf $ file  ${WORKDIR} /current
                 done
                 cd  ${WORKDIR}
                 IFS=${saved_IFS}
             fi
 
             saved_IFS=$IFS
             IFS= ' '
             cd  ${WORKDIR} /current
             for  file  in  ${WORKDIR} /current/ *; do
                 # TODO(Guodong Ding) scp timeout
                 scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
             done
             cd  ${WORKDIR}
             IFS=${saved_IFS}
 
             # Start service or validate status
             if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
#                ${WORKDIR}/current/bin/startup.sh restart
                 ssh_execute_command_on_remote_host $user_defined_deploy_target_host_ip  "$user_defined_project_top_directory_to_target_host/bin/startup.sh restart"
                 RETVAL=$?
             else
                 test  -z ${user_defined_docker_container_name} || restart_docker_container $user_defined_deploy_target_host_ip ${user_defined_docker_container_name}
                 # TODO(Guodong Ding) external health check
                 RETVAL=$?
             fi
 
             # if started ok, then create a workable program to a file
             if  [[ ${RETVAL} - eq  0 ]];  then
                 echo_g  "Rollback successfully! "
                 echo_g  "current workable version is $user_input_release_to_rollback"
                 cat  >${WORKDIR} /share/workable_program .log <<eof
${user_input_release_to_rollback}
eof
     fi
         else
             echo_r  "The release you want to rollback is not present, Please  try again! "
         fi
     else
         echo_r  "Error: Can NOT find workable release version! Please check if it is first deployment! "
         exit  1
     fi
 
}
 
# backup remote hosts config files only,
# use this function when you modify some config files on remote host
function  backup_manual(){
     set  -o errexit
     echo_b  "backup remote host config files..."
     scp_remote_files_to_local_host ${user_defined_deploy_target_host_ip}  "${user_defined_project_top_directory_to_target_host}/*"  ${WORKDIR} /backup
     # get config files
     "$(ls -A ${WORKDIR}/backup)"  ] &&  find  ${WORKDIR} /backup/ . - type  f ! -name . -a ! -name  '*.xml*'  -a ! -name  '*.properties*'  -a ! -name  '*.version*'  - exec  rm  -f --  '{}'  \;
     # remove empty directory, 'for + rmdir'
     find  ${WORKDIR} /backup/ . -empty - type  d -delete
     # TODO(Guodong Ding) improvements here
     echo_g  "backup remote host config files finished."
     echo  "`date +%Y%m%d`"  > ${WORKDIR} /backup/ .backup_operation_once.log
     set  +o errexit
}
 
# distribute current workable files to remote hosts
function  deploys() {
     # do make_current_workable_source before deploy every time
     make_current_workable_source
 
     echo_b  "Do deploy on $user_defined_deploy_targets_host_ip_list ..."
     for  remote_host_ip  in  $user_defined_deploy_targets_host_ip_list; do
         echo_b  "Do deploy on $remote_host_ip ..."
         saved_IFS=$IFS
         IFS= ' '
         cd  ${WORKDIR} /current
         for  file  in  ${WORKDIR} /current/ *; do
             scp_local_files_to_remote_host ${ file } ${remote_host_ip} ${user_defined_project_top_directory_to_target_host}
         done
         cd  ${WORKDIR}
         IFS=${saved_IFS}
 
         # rollback remote host config files
         [ -z ${user_defined_project_conf_directory} ] && rollback_remote_host_config_files
         if  test  ! -z  "${user_defined_project_conf_directory}"  -a -d ${user_defined_project_conf_directory};  then
             saved_IFS=$IFS
             IFS= ' '
             cd  ${WORKDIR} /current
             for  file  in  ${user_defined_project_conf_directory}/*; do
                 scp_local_files_to_remote_host ${ file } ${remote_host_ip} ${user_defined_project_top_directory_to_target_host}
             done
             cd  ${WORKDIR}
             IFS=${saved_IFS}
         fi
 
         # Start service or validate status on remote host
         if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
     #        ${WORKDIR}/current/bin/startup.sh start
             ssh_execute_command_on_remote_host $remote_host_ip  "$user_defined_project_top_directory_to_target_host/bin/startup.sh start"
             RETVAL=$?
         else
             test  -z ${user_defined_docker_container_name} || restart_docker_container $remote_host_ip ${user_defined_docker_container_name}
             # TODO(Guodong Ding) external health check
             RETVAL=$?
         fi
         if  [[ ${RETVAL} - eq  0 ]];  then
             echo_g  "Deploy successfully on $remote_host_ip! "
         else
             echo_r  "Error: Deploy failed! on $remote_host_ip! "
             echo_p  "Try modify $user_defined_deploy_target_host_ip and using standalone deployment mode"
             exit  1
         fi
     done
 
     # if started ok, then create a workable program to a file
     if  [[ ${RETVAL} - eq  0 ]];  then
         # Note cat with eof must start at row 0, and with eof end only, such as no blank spaces, etc
     cat  >${WORKDIR} /share/workable_program .log <<eof
${new_release_just_created}
eof
         echo_g  "Deploy finished! on $user_defined_deploy_targets_host_ip_list "
         echo_g  "current workable version is $(cat ${WORKDIR}/share/workable_program.log)"
     #    ls --color=auto -l ${WORKDIR}/current
     #    ls --color=auto -l ${WORKDIR}/current/
     else
         echo_r  "Error: Deploy failed! "
         ${WORKDIR}/` basename  $0` rollbacks
     fi
}
 
function  rollbacks(){
     echo_b  "This function will rollback to any workable version which user wished by manually."
     # TODO(Guodong Ding) linux shell trap command several ctrl+c
     echo_p  "Enter 'reset' command to reset terminal when something go wrong."
     read  -e -s -n 1 -p  "Press any key to continue or Press 'Ctrl+C' exit. Enter 'reset' command to reset terminal when something go wrong."
     if  test  -d $WORKDIR /release  -a  "$(ls -A $WORKDIR/release 2>/dev/null)"  ; then  # judge a directory if is empty
         echo_b  "Current workable releases( Latest 5 ) are here: "
#        ls -d -1 $WORKDIR/release/*
         ls  -u -1 -d $WORKDIR /release/ * |  tail  -n5
         read  -p  "Which release do you want rollback? Press Enter after input. "  user_input_release_to_rollback
         if  test  -d $user_input_release_to_rollback;  then
             rm  -rf ${WORKDIR} /current
             ln  -s ${user_input_release_to_rollback} ${WORKDIR} /current
             # Remake conf and logs symbolic link to current
             [ -d ${WORKDIR} /share/conf  ] &&  ln  -s ${WORKDIR} /share/conf  ${WORKDIR} /current
             [ -d ${WORKDIR} /share/logs  ] &&  ln  -s ${WORKDIR} /share/logs  ${WORKDIR} /current
 
             # backup remote host config files
             [ -z ${user_defined_project_conf_directory} ] && backup_remote_host_config_files
 
             #    scp_local_files_to_remote_host ${WORKDIR}/current/ ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
             saved_IFS=$IFS
             IFS= ' '
             cd  ${WORKDIR} /current
             for  host_ip  in  $user_defined_deploy_targets_host_ip_list; do
                     for  file  in  ${WORKDIR} /current/ *; do
                         scp_local_files_to_remote_host ${ file } ${user_defined_deploy_target_host_ip} ${user_defined_project_top_directory_to_target_host}
                     done
             done
             cd  ${WORKDIR}
             IFS=${saved_IFS}
 
             # Start service or validate status
             if  [[ -e ${WORKDIR} /current/bin/startup .sh ]];  then
#                ${WORKDIR}/current/bin/startup.sh restart
                 ssh_execute_command_on_remote_host $user_defined_deploy_target_host_ip  "$user_defined_project_top_directory_to_target_host/bin/startup.sh restart"
                 RETVAL=$?
             else
                 test  -z ${user_defined_docker_container_name} || restart_docker_container ${user_defined_docker_container_name}
                 # TODO(Guodong Ding) external health check
                 RETVAL=$?
             fi
 
             # if started ok, then create a workable program to a file
             if  [[ ${RETVAL} - eq  0 ]];  then
                 echo_g  "Rollback successfully on $user_defined_deploy_targets_host_ip_list! "
                 echo_g  "Current workable version is $user_input_release_to_rollback"
                 cat  >${WORKDIR} /share/workable_program .log <<eof
${user_input_release_to_rollback}
eof
     fi
         else
             echo_r  "The release you want to rollback is not present, Please  try again! "
         fi
     else
         echo_r  "Error: Can NOT find workable release version! Please check if it is first deployment! "
         exit  1
     fi
 
}
 
function  destroy() {
     # echo a Warning message
     echo_y  "Warning: This action will destroy all this project, and this is unrecoverable! "
     user_input_answer_want_do_destroy= "n"
     echo_y  "Do you want to destroy this project? "
     read  -p  "(Default no,if you want please input: y ,if not please press the enter button):"  user_input_answer_want_do_destroy
     case  "$user_input_answer_want_do_destroy"  in
         y|Y|Yes|YES| yes |yES|yEs|YeS|yeS )
         # delete all file expect for this script self
         # find: warning: Unix filenames usually don't contain slashes (though pathnames do).  That means that '-name `./deploy.sh'' will probably evaluate to false all the time on this system.  You might find the '-wholename' test more useful, or perhaps '-samefile'.  Alternatively, if you are using GNU grep, you could use 'find ... -print0 | grep -FzZ `./deploy.sh''.
             # echo $WORKDIR/
             #find -L $WORKDIR -type f ! -name "$(basename $0)" -exec ls --color=auto -al {} \;
             # find -L . -type f ! -name "deploy.sh" -exec ls --color=auto -al {} \;
             # find -L . -type d -exec ls --color=auto -al {} \;
             # find -L ./ -maxdepth 1 ! -name "deploy.sh" ! -wholename "./"
         # ls | grep -v "filename" | xargs rm -rf
         find  -L ${WORKDIR} -maxdepth 1 ! -name  "$(basename $0)"  ! -wholename  "$WORKDIR"   - exec  rm  -rf  '{}'  \;
         if  [ $? - eq  0 ]; then
             test  -f ${WORKDIR}/.capistrano_ds_lock && \ rm  -rf  ${WORKDIR}/.capistrano_ds_lock
             echo_g  "Destroy this project successfully! Now will exit with status 0. "
             exit  0
         else
             echo_r  "Error: something go wrong! Please check or alter to Admin user! "
             exit  1
         fi
         ;;
         n|N|No|NO|no|nO)
         echo_g  "destroy action is cancel"
         exit  0
         ;;
         *)
         echo_r  "Are you kidding me? You are a bad kid! "
         exit  1
         ;;
     esac
 
}
 
function  usage(){
     cat  - << eof
"$WORKDIR/` basename  $0` deploy              new deploy/ update one remote target host
"$WORKDIR/` basename  $0` rollback_manual     rollback to any workable version to one remote target host by manual
"$WORKDIR/` basename  $0` deploys             new deploy/ update  more  then  one remote target host
"$WORKDIR/` basename  $0` rollbacks           rollback to any workable version to  more  than one remote target host by manual
"$WORKDIR/` basename  $0` backup_manual       backup conf files to  local  by manual when you add /delete/update  conf files on remote target host
eof
 
}
 
function  main(){
     lock_filename= "lock_$$_${RANDOM}"
#    lock_filename_full_path="/var/lock/subsys/$lock_filename"
     lock_filename_full_path= "/var/lock/$lock_filename"
     if  set  -o noclobber;  echo  "$$"  "$lock_filename_full_path" ) 2>  /dev/null ; then
         trap  'rm -f "$lock_filename_full_path"; exit $?'  INT TERM EXIT
         [ ! -x ${WORKDIR}/` basename  $0` ] &&  chmod  +x ${WORKDIR}/` basename  $0`
         [ -n  "$header"  ] &&  echo  "$header"
 
         # if exist file '.capistrano_ds_lock', then this is not first deployment, and unset
         if  test  -f $WORKDIR/.capistrano_ds_lock;  then
             unset  user_defined_project_conf_directory
             user_defined_project_conf_directory= ""
         fi
 
         if  [[ $ # -ne 1 ]]; then
             ${WORKDIR}/` basename  $0` help
             exit  0
         fi
         case  $1  in
             deploy)
                 deployment_mode= "1"
                 deploy
                 ;;
             rollback)
                 rollback
                 ;;
             rollback_manual|rollbackup_manual)
                 rollback_manual
                 ;;
             backup_manual)
                 backup_manual
                 ;;
             deploys)
                 deployment_mode= "0"
                 deploys;
                 ;;
             rollbacks|rollbackups)
                 rollbacks
                 ;;
             destroy)
                 destroy
                 ;;
             help|*)
                 echo  "Usage: $0 {deploy|rollback_manual|deploys|backup_manual} with $0 itself"
                 usage
                 exit  1
                 ;;
         esac
 
         rm  -f  "$lock_filename_full_ path"
         trap  - INT TERM EXIT
     else
         echo  "Failed to acquire lock: $lock_filename_full_path"
         echo  "held by $(cat ${lock_filename_full_path})"
fi
 
}
 
main $@
 
# debug option
if  $DEBUG ;  then
     export  PS4=$old_PS4
     ${_XTRACE_FUNCTIONS}
fi

--end--           








本文转自 urey_pp 51CTO博客,原文链接:http://blog.51cto.com/dgd2010/1784390,如需转载请自行联系原作者


相关实践学习
基于OpenTelemetry构建全链路追踪与监控
本实验将带领您快速上手可观测链路OpenTelemetry版,包括部署并接入多语言应用、体验TraceId自动注入至日志以实现调用链与日志的关联查询、以及切换调用链透传协议以满足全链路打通的需求。
分布式链路追踪Skywalking
Skywalking是一个基于分布式跟踪的应用程序性能监控系统,用于从服务和云原生等基础设施中收集、分析、聚合以及可视化数据,提供了一种简便的方式来清晰地观测分布式系统,具有分布式追踪、性能指标分析、应用和服务依赖分析等功能。 分布式追踪系统发展很快,种类繁多,给我们带来很大的方便。但在数据采集过程中,有时需要侵入用户代码,并且不同系统的 API 并不兼容,这就导致了如果希望切换追踪系统,往往会带来较大改动。OpenTracing为了解决不同的分布式追踪系统 API 不兼容的问题,诞生了 OpenTracing 规范。OpenTracing 是一个轻量级的标准化层,它位于应用程序/类库和追踪或日志分析程序之间。Skywalking基于OpenTracing规范开发,具有性能好,支持多语言探针,无侵入性等优势,可以帮助我们准确快速的定位到线上故障和性能瓶颈。 在本套课程中,我们将全面的讲解Skywalking相关的知识。从APM系统、分布式调用链等基础概念的学习加深对Skywalking的理解,从0开始搭建一套完整的Skywalking环境,学会对各类应用进行监控,学习Skywalking常用插件。Skywalking原理章节中,将会对Skywalking使用的agent探针技术进行深度剖析,除此之外还会对OpenTracing规范作整体上的介绍。通过对本套课程的学习,不止能学会如何使用Skywalking,还将对其底层原理和分布式架构有更深的理解。本课程由黑马程序员提供。
相关文章
|
1天前
|
存储 Shell Linux
快速上手基于 BaGet 的脚本自动化构建 .net 应用打包
本文介绍了如何使用脚本自动化构建 `.net` 应用的 `nuget` 包并推送到指定服务仓库。首先概述了 `BaGet`——一个开源、轻量级且高性能的 `NuGet` 服务器,支持多种存储后端及配置选项。接着详细描述了 `BaGet` 的安装、配置及使用方法,并提供了 `PowerShell` 和 `Bash` 脚本实例,用于自动化推送 `.nupkg` 文件。最后总结了 `BaGet` 的优势及其在实际部署中的便捷性。
25 10
|
2天前
|
Java Apache Maven
Maven 项目文档
Maven 项目文档
|
1天前
|
Java Apache Maven
Maven 项目文档
Maven 项目文档
|
2天前
|
运维 监控 Devops
自动化运维之路:从脚本到DevOps
【9月更文挑战第4天】本文通过探索自动化在运维中的应用,揭示从简单的shell脚本到复杂的DevOps实践的转变过程。我们将讨论如何利用自动化工具来提升效率、减少错误并优化工作流程,同时分享一些实用的代码示例,帮助读者理解自动化运维的实际应用场景。
20 5
|
2天前
|
机器学习/深度学习 人工智能 运维
自动化运维的演变之路:从脚本到智能
在数字化浪潮中,自动化运维如同一艘船,载着企业乘风破浪。本文将带你穿梭于自动化运维的历史长河,见证它如何从简单的脚本编写,发展成为今天集成了人工智能技术的智能运维平台。我们将探索这一变革背后的原因、影响以及面临的挑战,同时分享一些行业内的成功案例,为你的企业运维之旅提供启示和方向。
|
5天前
|
Java Apache Maven
Maven 项目文档
Maven 项目文档
|
3天前
|
Java Apache Maven
Maven 项目文档
Maven 项目文档
|
4天前
|
Java Apache Maven
Maven 项目文档
Maven 项目文档
|
4天前
|
运维 Linux 测试技术
自动化运维:使用Python脚本简化日常任务
【8月更文挑战第34天】在快节奏的IT环境中,自动化运维成为提升效率、降低错误率的关键。本文以Python脚本为例,展示如何通过编写简单的脚本来自动化日常运维任务,如批量更改文件权限、自动备份数据等。文章不仅提供代码示例,还探讨了自动化运维带来的益处和实施时应注意的问题。
|
5天前
|
运维 监控 网络安全
自动化运维:使用Python脚本简化日常任务
【8月更文挑战第33天】在本文中,我们将深入探讨如何通过Python脚本来自动化执行常见的运维任务。从基础的服务器健康检查到复杂的部署流程,Python因其简洁和功能强大的特性,成为自动化工具的首选。文章将展示编写Python脚本的基本方法,并通过实际示例演示如何应用于真实场景,旨在帮助读者提升效率,减少重复性工作。

推荐镜像

更多
下一篇
DDNS