diff --git a/CHANGELOG.md b/CHANGELOG.md index aac7d88..c507468 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,6 +17,8 @@ - `version` subcommand [e6b24fe](https://git.autonomic.zone/coop-cloud/abra/commit/e6b24fe) - Global `--skip-update` / `--skip-check` options to make things quicker, [37e8b00](https://git.autonomic.zone/coop-cloud/abra/commit/37e8b00) +- `app backup` command; requires per-app definition -- see + [#70](https://git.autonomic.zone/coop-cloud/abra/issues/70) # abra 0.4.1 (2020-12-24) diff --git a/abra b/abra index c1795f8..367d6b6 100755 --- a/abra +++ b/abra @@ -12,21 +12,22 @@ DOC=" The cooperative cloud utility belt 🎩🐇 Usage: - abra [options] app new [--server=] [--domain=] [--app-name=] [--pass] [--auto] abra [options] app (list|ls) [--status] [--server=] - abra [options] app deploy [--skip-check] - abra [options] app undeploy - abra [options] app config - abra [options] app (delete|rm) [--force] - abra [options] app logs [] - abra [options] app cp + abra [options] app new [--server=] [--domain=] [--app-name=] [--pass] [--auto] + abra [options] app backup (|--all) + abra [options] app deploy abra [options] app check + abra [options] app config + abra [options] app cp + abra [options] app logs [] abra [options] app ps + abra [options] app restore (|--all) + abra [options] app (rm|delete) [--force] abra [options] app run [--no-tty] [--user=] ... abra [options] app secret auto [--pass] abra [options] app secret generate [] [--pass] abra [options] app secret insert [--pass] - abra [options] app secret (delete|rm) (|--all) [--pass] [--force] + abra [options] app secret (rm|delete) (|--all) [--pass] [--force] abra [options] app [...] abra [options] server add [] [] abra [options] server (list|ls) @@ -146,94 +147,99 @@ eval "var_$1+=($value)"; else eval "var_$1=$value"; fi; return 0; fi; done return 1; }; stdout() { printf -- "cat <<'EOM'\n%s\nEOM\n" "$1"; }; stderr() { printf -- "cat <<'EOM' >&2\n%s\nEOM\n" "$1"; }; error() { [[ -n $1 ]] && stderr "$1"; stderr "$usage"; _return 1; }; _return() { -printf -- "exit %d\n" "$1"; exit "$1"; }; set -e; trimmed_doc=${DOC:1:1477} -usage=${DOC:40:1206}; digest=859ab -shorts=(-h -e -s '' '' '' '' '' '' '' '' '' '' '') -longs=(--help --env --stack --server --domain --app-name --pass --auto --status --skip-check --force --no-tty --user --all) -argcounts=(0 1 1 1 1 1 0 0 0 0 0 0 1 0); node_0(){ switch __help 0; }; node_1(){ -value __env 1; }; node_2(){ value __stack 2; }; node_3(){ value __server 3; } -node_4(){ value __domain 4; }; node_5(){ value __app_name 5; }; node_6(){ -switch __pass 6; }; node_7(){ switch __auto 7; }; node_8(){ switch __status 8; } -node_9(){ switch __skip_check 9; }; node_10(){ switch __force 10; }; node_11(){ -switch __no_tty 11; }; node_12(){ value __user 12; }; node_13(){ switch __all 13 -}; node_14(){ value _type_ a; }; node_15(){ value _app_ a; }; node_16(){ -value _service_ a; }; node_17(){ value _src_ a; }; node_18(){ value _dst_ a; } -node_19(){ value _args_ a true; }; node_20(){ value _secret_ a; }; node_21(){ -value _version_ a; }; node_22(){ value _cmd_ a; }; node_23(){ value _data_ a; } -node_24(){ value _command_ a; }; node_25(){ value _host_ a; }; node_26(){ -value _user_ a; }; node_27(){ value _port_ a; }; node_28(){ -value _subcommands_ a true; }; node_29(){ _command app; }; node_30(){ -_command new; }; node_31(){ _command list; }; node_32(){ _command ls; } -node_33(){ _command deploy; }; node_34(){ _command undeploy; }; node_35(){ -_command config; }; node_36(){ _command delete; }; node_37(){ _command rm; } -node_38(){ _command logs; }; node_39(){ _command cp; }; node_40(){ -_command check; }; node_41(){ _command ps; }; node_42(){ _command run; } -node_43(){ _command secret; }; node_44(){ _command auto; }; node_45(){ -_command generate; }; node_46(){ _command insert; }; node_47(){ _command server -}; node_48(){ _command add; }; node_49(){ _command init; }; node_50(){ -_command apps; }; node_51(){ _command upgrade; }; node_52(){ _command version; } -node_53(){ _command help; }; node_54(){ optional 0 1 2; }; node_55(){ -optional 54; }; node_56(){ optional 3; }; node_57(){ optional 4; }; node_58(){ -optional 5; }; node_59(){ optional 6; }; node_60(){ optional 7; }; node_61(){ -required 55 29 30 56 57 58 59 60 14; }; node_62(){ either 31 32; }; node_63(){ -required 62; }; node_64(){ optional 8; }; node_65(){ required 55 29 63 64 56; } -node_66(){ optional 9; }; node_67(){ required 55 29 15 33 66; }; node_68(){ -required 55 29 15 34; }; node_69(){ required 55 29 15 35; }; node_70(){ -either 36 37; }; node_71(){ required 70; }; node_72(){ optional 10; } -node_73(){ required 55 29 15 71 72; }; node_74(){ optional 16; }; node_75(){ -required 55 29 15 38 74; }; node_76(){ required 55 29 15 39 17 18; }; node_77(){ -required 55 29 15 40; }; node_78(){ required 55 29 15 41; }; node_79(){ -optional 11; }; node_80(){ optional 12; }; node_81(){ oneormore 19; } -node_82(){ required 55 29 15 42 79 80 16 81; }; node_83(){ -required 55 29 15 43 44 59; }; node_84(){ optional 22; }; node_85(){ -required 55 29 15 43 45 20 21 84 59; }; node_86(){ -required 55 29 15 43 46 20 21 23 59; }; node_87(){ either 20 13; }; node_88(){ -required 87; }; node_89(){ required 55 29 15 43 71 88 59 72; }; node_90(){ -optional 81; }; node_91(){ required 55 29 15 24 90; }; node_92(){ optional 26; } -node_93(){ optional 27; }; node_94(){ required 55 47 48 25 92 93; }; node_95(){ -required 55 47 63; }; node_96(){ required 55 47 25 37; }; node_97(){ -required 55 47 25 49; }; node_98(){ required 55 47 25 50 64; }; node_99(){ -required 55 51; }; node_100(){ required 55 52; }; node_101(){ oneormore 28; } -node_102(){ optional 101; }; node_103(){ required 55 53 102; }; node_104(){ -either 61 65 67 68 69 73 75 76 77 78 82 83 85 86 89 91 94 95 96 97 98 99 100 103 -}; node_105(){ required 104; }; cat <<<' docopt_exit() { -[[ -n $1 ]] && printf "%s\n" "$1" >&2; printf "%s\n" "${DOC:40:1206}" >&2 -exit 1; }'; unset var___help var___env var___stack var___server var___domain \ -var___app_name var___pass var___auto var___status var___skip_check var___force \ -var___no_tty var___user var___all var__type_ var__app_ var__service_ var__src_ \ -var__dst_ var__args_ var__secret_ var__version_ var__cmd_ var__data_ \ -var__command_ var__host_ var__user_ var__port_ var__subcommands_ var_app \ -var_new var_list var_ls var_deploy var_undeploy var_config var_delete var_rm \ -var_logs var_cp var_check var_ps var_run var_secret var_auto var_generate \ -var_insert var_server var_add var_init var_apps var_upgrade var_version var_help -parse 105 "$@"; local prefix=${DOCOPT_PREFIX:-''}; unset "${prefix}__help" \ -"${prefix}__env" "${prefix}__stack" "${prefix}__server" "${prefix}__domain" \ -"${prefix}__app_name" "${prefix}__pass" "${prefix}__auto" "${prefix}__status" \ -"${prefix}__skip_check" "${prefix}__force" "${prefix}__no_tty" \ -"${prefix}__user" "${prefix}__all" "${prefix}_type_" "${prefix}_app_" \ -"${prefix}_service_" "${prefix}_src_" "${prefix}_dst_" "${prefix}_args_" \ -"${prefix}_secret_" "${prefix}_version_" "${prefix}_cmd_" "${prefix}_data_" \ -"${prefix}_command_" "${prefix}_host_" "${prefix}_user_" "${prefix}_port_" \ -"${prefix}_subcommands_" "${prefix}app" "${prefix}new" "${prefix}list" \ -"${prefix}ls" "${prefix}deploy" "${prefix}undeploy" "${prefix}config" \ -"${prefix}delete" "${prefix}rm" "${prefix}logs" "${prefix}cp" "${prefix}check" \ -"${prefix}ps" "${prefix}run" "${prefix}secret" "${prefix}auto" \ -"${prefix}generate" "${prefix}insert" "${prefix}server" "${prefix}add" \ -"${prefix}init" "${prefix}apps" "${prefix}upgrade" "${prefix}version" \ -"${prefix}help"; eval "${prefix}"'__help=${var___help:-false}' +printf -- "exit %d\n" "$1"; exit "$1"; }; set -e; trimmed_doc=${DOC:1:1636} +usage=${DOC:40:1260}; digest=0138f +shorts=(-U -C -e -h -s '' '' '' '' '' '' '' '' '' '') +longs=(--skip-update --skip-check --env --help --stack --status --server --domain --app-name --pass --auto --all --force --no-tty --user) +argcounts=(0 0 1 0 1 0 1 1 1 0 0 0 0 0 1); node_0(){ switch __skip_update 0; } +node_1(){ switch __skip_check 1; }; node_2(){ value __env 2; }; node_3(){ +switch __help 3; }; node_4(){ value __stack 4; }; node_5(){ switch __status 5; } +node_6(){ value __server 6; }; node_7(){ value __domain 7; }; node_8(){ +value __app_name 8; }; node_9(){ switch __pass 9; }; node_10(){ switch __auto 10 +}; node_11(){ switch __all 11; }; node_12(){ switch __force 12; }; node_13(){ +switch __no_tty 13; }; node_14(){ value __user 14; }; node_15(){ value _type_ a +}; node_16(){ value _app_ a; }; node_17(){ value _service_ a; }; node_18(){ +value _src_ a; }; node_19(){ value _dst_ a; }; node_20(){ value _args_ a true; } +node_21(){ value _secret_ a; }; node_22(){ value _version_ a; }; node_23(){ +value _cmd_ a; }; node_24(){ value _data_ a; }; node_25(){ value _command_ a; } +node_26(){ value _host_ a; }; node_27(){ value _user_ a; }; node_28(){ +value _port_ a; }; node_29(){ value _subcommands_ a true; }; node_30(){ +_command app; }; node_31(){ _command list; }; node_32(){ _command ls; } +node_33(){ _command new; }; node_34(){ _command backup; }; node_35(){ +_command deploy; }; node_36(){ _command check; }; node_37(){ _command config; } +node_38(){ _command cp; }; node_39(){ _command logs; }; node_40(){ _command ps +}; node_41(){ _command restore; }; node_42(){ _command rm; }; node_43(){ +_command delete; }; node_44(){ _command run; }; node_45(){ _command secret; } +node_46(){ _command auto; }; node_47(){ _command generate; }; node_48(){ +_command insert; }; node_49(){ _command server; }; node_50(){ _command add; } +node_51(){ _command init; }; node_52(){ _command apps; }; node_53(){ +_command upgrade; }; node_54(){ _command version; }; node_55(){ _command help; } +node_56(){ optional 0 1 2 3 4; }; node_57(){ optional 56; }; node_58(){ +either 31 32; }; node_59(){ required 58; }; node_60(){ optional 5; }; node_61(){ +optional 6; }; node_62(){ required 57 30 59 60 61; }; node_63(){ optional 7; } +node_64(){ optional 8; }; node_65(){ optional 9; }; node_66(){ optional 10; } +node_67(){ required 57 30 33 61 63 64 65 66 15; }; node_68(){ either 17 11; } +node_69(){ required 68; }; node_70(){ required 57 30 16 34 69; }; node_71(){ +required 57 30 16 35; }; node_72(){ required 57 30 16 36; }; node_73(){ +required 57 30 16 37; }; node_74(){ required 57 30 16 38 18 19; }; node_75(){ +optional 17; }; node_76(){ required 57 30 16 39 75; }; node_77(){ +required 57 30 16 40; }; node_78(){ required 57 30 16 41 69; }; node_79(){ +either 42 43; }; node_80(){ required 79; }; node_81(){ optional 12; } +node_82(){ required 57 30 16 80 81; }; node_83(){ optional 13; }; node_84(){ +optional 14; }; node_85(){ oneormore 20; }; node_86(){ +required 57 30 16 44 83 84 17 85; }; node_87(){ required 57 30 16 45 46 65; } +node_88(){ optional 23; }; node_89(){ required 57 30 16 45 47 21 22 88 65; } +node_90(){ required 57 30 16 45 48 21 22 24 65; }; node_91(){ either 21 11; } +node_92(){ required 91; }; node_93(){ required 57 30 16 45 80 92 65 81; } +node_94(){ optional 85; }; node_95(){ required 57 30 16 25 94; }; node_96(){ +optional 27; }; node_97(){ optional 28; }; node_98(){ required 57 49 50 26 96 97 +}; node_99(){ required 57 49 59; }; node_100(){ required 57 49 26 42; } +node_101(){ required 57 49 26 51; }; node_102(){ required 57 49 26 52 60; } +node_103(){ required 57 53; }; node_104(){ required 57 54; }; node_105(){ +oneormore 29; }; node_106(){ optional 105; }; node_107(){ required 57 55 106; } +node_108(){ +either 62 67 70 71 72 73 74 76 77 78 82 86 87 89 90 93 95 98 99 100 101 102 103 104 107 +}; node_109(){ required 108; }; cat <<<' docopt_exit() { +[[ -n $1 ]] && printf "%s\n" "$1" >&2; printf "%s\n" "${DOC:40:1260}" >&2 +exit 1; }'; unset var___skip_update var___skip_check var___env var___help \ +var___stack var___status var___server var___domain var___app_name var___pass \ +var___auto var___all var___force var___no_tty var___user var__type_ var__app_ \ +var__service_ var__src_ var__dst_ var__args_ var__secret_ var__version_ \ +var__cmd_ var__data_ var__command_ var__host_ var__user_ var__port_ \ +var__subcommands_ var_app var_list var_ls var_new var_backup var_deploy \ +var_check var_config var_cp var_logs var_ps var_restore var_rm var_delete \ +var_run var_secret var_auto var_generate var_insert var_server var_add \ +var_init var_apps var_upgrade var_version var_help; parse 109 "$@" +local prefix=${DOCOPT_PREFIX:-''}; unset "${prefix}__skip_update" \ +"${prefix}__skip_check" "${prefix}__env" "${prefix}__help" "${prefix}__stack" \ +"${prefix}__status" "${prefix}__server" "${prefix}__domain" \ +"${prefix}__app_name" "${prefix}__pass" "${prefix}__auto" "${prefix}__all" \ +"${prefix}__force" "${prefix}__no_tty" "${prefix}__user" "${prefix}_type_" \ +"${prefix}_app_" "${prefix}_service_" "${prefix}_src_" "${prefix}_dst_" \ +"${prefix}_args_" "${prefix}_secret_" "${prefix}_version_" "${prefix}_cmd_" \ +"${prefix}_data_" "${prefix}_command_" "${prefix}_host_" "${prefix}_user_" \ +"${prefix}_port_" "${prefix}_subcommands_" "${prefix}app" "${prefix}list" \ +"${prefix}ls" "${prefix}new" "${prefix}backup" "${prefix}deploy" \ +"${prefix}check" "${prefix}config" "${prefix}cp" "${prefix}logs" "${prefix}ps" \ +"${prefix}restore" "${prefix}rm" "${prefix}delete" "${prefix}run" \ +"${prefix}secret" "${prefix}auto" "${prefix}generate" "${prefix}insert" \ +"${prefix}server" "${prefix}add" "${prefix}init" "${prefix}apps" \ +"${prefix}upgrade" "${prefix}version" "${prefix}help" +eval "${prefix}"'__skip_update=${var___skip_update:-false}' +eval "${prefix}"'__skip_check=${var___skip_check:-false}' eval "${prefix}"'__env=${var___env:-}' +eval "${prefix}"'__help=${var___help:-false}' eval "${prefix}"'__stack=${var___stack:-}' +eval "${prefix}"'__status=${var___status:-false}' eval "${prefix}"'__server=${var___server:-}' eval "${prefix}"'__domain=${var___domain:-}' eval "${prefix}"'__app_name=${var___app_name:-}' eval "${prefix}"'__pass=${var___pass:-false}' eval "${prefix}"'__auto=${var___auto:-false}' -eval "${prefix}"'__status=${var___status:-false}' -eval "${prefix}"'__skip_check=${var___skip_check:-false}' +eval "${prefix}"'__all=${var___all:-false}' eval "${prefix}"'__force=${var___force:-false}' eval "${prefix}"'__no_tty=${var___no_tty:-false}' eval "${prefix}"'__user=${var___user:-}' -eval "${prefix}"'__all=${var___all:-false}' eval "${prefix}"'_type_=${var__type_:-}'; eval "${prefix}"'_app_=${var__app_:-}' eval "${prefix}"'_service_=${var__service_:-}' eval "${prefix}"'_src_=${var__src_:-}'; eval "${prefix}"'_dst_=${var__dst_:-}' @@ -249,16 +255,18 @@ eval "${prefix}"'_port_=${var__port_:-}' if declare -p var__subcommands_ >/dev/null 2>&1; then eval "${prefix}"'_subcommands_=("${var__subcommands_[@]}")'; else eval "${prefix}"'_subcommands_=()'; fi; eval "${prefix}"'app=${var_app:-false}' -eval "${prefix}"'new=${var_new:-false}' eval "${prefix}"'list=${var_list:-false}'; eval "${prefix}"'ls=${var_ls:-false}' +eval "${prefix}"'new=${var_new:-false}' +eval "${prefix}"'backup=${var_backup:-false}' eval "${prefix}"'deploy=${var_deploy:-false}' -eval "${prefix}"'undeploy=${var_undeploy:-false}' -eval "${prefix}"'config=${var_config:-false}' -eval "${prefix}"'delete=${var_delete:-false}' -eval "${prefix}"'rm=${var_rm:-false}'; eval "${prefix}"'logs=${var_logs:-false}' -eval "${prefix}"'cp=${var_cp:-false}' eval "${prefix}"'check=${var_check:-false}' -eval "${prefix}"'ps=${var_ps:-false}'; eval "${prefix}"'run=${var_run:-false}' +eval "${prefix}"'config=${var_config:-false}' +eval "${prefix}"'cp=${var_cp:-false}'; eval "${prefix}"'logs=${var_logs:-false}' +eval "${prefix}"'ps=${var_ps:-false}' +eval "${prefix}"'restore=${var_restore:-false}' +eval "${prefix}"'rm=${var_rm:-false}' +eval "${prefix}"'delete=${var_delete:-false}' +eval "${prefix}"'run=${var_run:-false}' eval "${prefix}"'secret=${var_secret:-false}' eval "${prefix}"'auto=${var_auto:-false}' eval "${prefix}"'generate=${var_generate:-false}' @@ -271,18 +279,18 @@ eval "${prefix}"'upgrade=${var_upgrade:-false}' eval "${prefix}"'version=${var_version:-false}' eval "${prefix}"'help=${var_help:-false}'; local docopt_i=1 [[ $BASH_VERSION =~ ^4.3 ]] && docopt_i=2; for ((;docopt_i>0;docopt_i--)); do -declare -p "${prefix}__help" "${prefix}__env" "${prefix}__stack" \ -"${prefix}__server" "${prefix}__domain" "${prefix}__app_name" \ -"${prefix}__pass" "${prefix}__auto" "${prefix}__status" \ -"${prefix}__skip_check" "${prefix}__force" "${prefix}__no_tty" \ -"${prefix}__user" "${prefix}__all" "${prefix}_type_" "${prefix}_app_" \ -"${prefix}_service_" "${prefix}_src_" "${prefix}_dst_" "${prefix}_args_" \ -"${prefix}_secret_" "${prefix}_version_" "${prefix}_cmd_" "${prefix}_data_" \ -"${prefix}_command_" "${prefix}_host_" "${prefix}_user_" "${prefix}_port_" \ -"${prefix}_subcommands_" "${prefix}app" "${prefix}new" "${prefix}list" \ -"${prefix}ls" "${prefix}deploy" "${prefix}undeploy" "${prefix}config" \ -"${prefix}delete" "${prefix}rm" "${prefix}logs" "${prefix}cp" "${prefix}check" \ -"${prefix}ps" "${prefix}run" "${prefix}secret" "${prefix}auto" \ +declare -p "${prefix}__skip_update" "${prefix}__skip_check" "${prefix}__env" \ +"${prefix}__help" "${prefix}__stack" "${prefix}__status" "${prefix}__server" \ +"${prefix}__domain" "${prefix}__app_name" "${prefix}__pass" "${prefix}__auto" \ +"${prefix}__all" "${prefix}__force" "${prefix}__no_tty" "${prefix}__user" \ +"${prefix}_type_" "${prefix}_app_" "${prefix}_service_" "${prefix}_src_" \ +"${prefix}_dst_" "${prefix}_args_" "${prefix}_secret_" "${prefix}_version_" \ +"${prefix}_cmd_" "${prefix}_data_" "${prefix}_command_" "${prefix}_host_" \ +"${prefix}_user_" "${prefix}_port_" "${prefix}_subcommands_" "${prefix}app" \ +"${prefix}list" "${prefix}ls" "${prefix}new" "${prefix}backup" \ +"${prefix}deploy" "${prefix}check" "${prefix}config" "${prefix}cp" \ +"${prefix}logs" "${prefix}ps" "${prefix}restore" "${prefix}rm" \ +"${prefix}delete" "${prefix}run" "${prefix}secret" "${prefix}auto" \ "${prefix}generate" "${prefix}insert" "${prefix}server" "${prefix}add" \ "${prefix}init" "${prefix}apps" "${prefix}upgrade" "${prefix}version" \ "${prefix}help"; done; } @@ -676,6 +684,26 @@ sub_app_new (){ echo " abra app $APP_NAME deploy$(tput sgr0)" } +###### .. app backup +sub_app_backup (){ + load_instance + load_instance_env + + require_app_latest "$TYPE" + + # Add _ if it's defined + FUNCTION="abra_backup${abra__service_:+_}$abra__service_" + + if ! type "$FUNCTION" > /dev/null 2>&1; then + error "'$TYPE' doesn't know how to do ${abra__service_}${abra__service_:+ }backups."\ + "See $GIT_URL$TYPE/issues/" + fi + + mkdir -p "$ABRA_DIR/backups" + + $FUNCTION +} + ###### .. app deploy help_app_deploy (){ echo "abra [options] app deploy [--skip-check]