-
-
Notifications
You must be signed in to change notification settings - Fork 112
/
ss-dump-files.txt
138 lines (106 loc) · 7.63 KB
/
ss-dump-files.txt
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
#!/bin/bash
####################################################################################################
#### author: SlickStack ############################################################################
#### link: https://slickstack.io ###################################################################
#### mirror: littlebizzy/slickstack/blob/master/bash/ss-dump-files.txt #############################
#### path: /var/www/ss-dump-files ##################################################################
#### destination: n/a (not a boilerplate) ##########################################################
#### purpose: Dumps files to /var/www/backups/html/production.tar.gz (SFTP user can access) ########
#### module version: Ubuntu 24.04 LTS ##############################################################
#### sourced by: n/a ###############################################################################
#### bash aliases: ss dump files ###################################################################
####################################################################################################
####################################################################################################
#### TABLE OF CONTENTS (SS-Dump-Files) #############################################################
####################################################################################################
## this is a brief summary of the different code snippets you will find in this script ##
## each section should be commented so you understand what is being accomplished ##
## A. Source SS-Config + SS-Functions
## B. Touch Timestamp File
## C. Message (Begin Script)
## D. Dump Public HTML Directory
## E. Reset Permissions (HTML Dump Files)
####################################################################################################
#### A. SS-Dump-Files: Source SS-Config + SS-Functions #############################################
####################################################################################################
## before anything else we must source the critical variables that power this script ##
## ss-config is setup during ss-install wizard but ss-functions is hardcoded ##
## source ss-config ##
source /var/www/ss-config
## source ss-functions ##
source /var/www/ss-functions
## BELOW THIS RELIES ON SS-CONFIG AND SS-FUNCTIONS
####################################################################################################
#### B. SS-Dump-Files: Touch Timestamp File ########################################################
####################################################################################################
## this is a dummy timestamp file that will remember the last time this script was run ##
## it can be useful for developer reference and is sometimes used by SlickStack ##
ss_touch "${TIMESTAMP_SS_DUMP_FILES}"
####################################################################################################
#### C. SS-Dump-Files: Message (Begin Script) ######################################################
####################################################################################################
## this is a simple message that announces to the shell the purpose of this bash script ##
## it will only be seen by sudo users who manually run this script in the shell ##
ss_echo "${COLOR_INFO}Running ss-dump-files... ${COLOR_RESET}"
####################################################################################################
#### D. SS-Dump-Files: Dump Public HTML Directory ##################################################
####################################################################################################
## NEEDED: calculate free space and if free space is less than used space display error and exit
## this is to avoid exhausting disk space and crashing the server
## if free space is okay then dump TAR ball of /html/ to /var/www/backups/html/production.tar.gz (must overwrite each time to save space)
## production ##
ss_targz "${PATH_DUMP_FILES_PRODUCTION}" --exclude="staging" --exclude="dev" -C /var/www/html . ## ending period required
## staging ##
if [[ "${STAGING_SITE}" == "true" ]]; then
ss_targz "${PATH_DUMP_FILES_STAGING}" -C /var/www/html/staging . ## ending period required
fi
## development ##
if [[ "${DEV_SITE}" == "true" ]]; then
ss_targz "${PATH_DUMP_FILES_DEVELOPMENT}" -C /var/www/html/dev . ## ending period required
fi
####################################################################################################
#### E. SS-Dump-Files: Reset Permissions (HTML Dump Files) #########################################
####################################################################################################
## here we do a quick permissions reset to ensure SFTP users can access the dump file ##
## keep in mind that root/sudo users will have access to this file regardless ##
## production ##
chown -R "${SFTP_USER}":www-data "${PATH_DUMP_FILES_PRODUCTION}"
chmod 0440 "${PATH_DUMP_FILES_PRODUCTION}"
## staging ##
if [[ "${STAGING_SITE}" == "true" ]]; then
chown -R "${SFTP_USER}":www-data "${PATH_DUMP_FILES_STAGING}"
chmod 0440 "${PATH_DUMP_FILES_STAGING}"
fi
## development ##
if [[ "${DEV_SITE}" == "true" ]]; then
chown -R "${SFTP_USER}":www-data "${PATH_DUMP_FILES_DEVELOPMENT}"
chmod 0440 "${PATH_DUMP_FILES_DEVELOPMENT}"
fi
####################################################################################################
#### SlickStack: Reset Permissions (SlickStack Scripts) ############################################
####################################################################################################
## we include this permissions reset in all cron jobs and bash scripts for redundancy ##
## chmod 0700 means only the root/sudo users can execute any SlickStack scripts ##
## THIS SNIPPET DOES NOT RELY ON SS-CONFIG OR SS-FUNCTIONS
## SNIPPET: ss bash scripts, ss cron jobs
## UPDATED: 02JUL2022
chown root:root /var/www/ss* ## must be root:root
chown root:root /var/www/crons/*cron* ## must be root:root
chown root:root /var/www/crons/custom/*cron* ## must be root:root
chmod 0700 /var/www/ss* ## 0700 means only root/sudo can execute
chmod 0700 /var/www/crons/*cron* ## 0700 means only root/sudo can execute
chmod 0700 /var/www/crons/custom/*cron* ## 0700 means only root/sudo can execute
####################################################################################################
#### SlickStack: External References Used To Improve This Script (Thanks, Interwebz) ###############
####################################################################################################
## Ref: https://www.cyberciti.biz/faq/how-do-i-compress-a-whole-linux-or-unix-directory/
## Ref: https://stackoverflow.com/questions/984204/shell-command-to-tar-directory-excluding-certain-files-folders
## Ref: https://stackoverflow.com/questions/20841727/exclude-directory-while-using-tar
## Ref: https://stackoverflow.com/questions/13341702/how-do-i-turn-off-the-output-from-tar-commands-on-unix
## Ref: https://unix.stackexchange.com/questions/59243/tar-removing-leading-from-member-names/59244
## Ref: https://askubuntu.com/questions/811081/how-do-i-use-tar-to-exclude-all-files-of-a-certain-directory
## Ref: https://www.computerhope.com/unix/utar.htm
## Ref: https://stackoverflow.com/questions/18681595/tar-a-directory-but-dont-store-full-absolute-paths-in-the-archive
## Ref: https://unix.stackexchange.com/questions/627540/tar-gz-a-directory-in-another-location-into-a-destination-directory
## Ref: https://stackoverflow.com/questions/939982/how-do-i-tar-a-directory-of-files-and-folders-without-including-the-directory-it
## SS_EOF