Skip to content

Commit dc623bf

Browse files
authored
Add backup.config-example
1 parent 653dd1e commit dc623bf

File tree

1 file changed

+132
-0
lines changed

1 file changed

+132
-0
lines changed

backup.config-example

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
# GitHub Enterprise Server backup configuration file
2+
3+
# The hostname of the GitHub Enterprise Server appliance to back up. The host
4+
# must be reachable via SSH from the backup host.
5+
GHE_HOSTNAME="github.example.com"
6+
7+
# Path to where backup data is stored. By default this is the "data"
8+
# directory next to this file but can be set to an absolute path
9+
# elsewhere for backing up to a separate partition / mount point.
10+
GHE_DATA_DIR="data"
11+
12+
# The number of backup snapshots to retain. Old snapshots are pruned after each
13+
# successful ghe-backup run. This option should be tuned based on the frequency
14+
# of scheduled backup runs. If backups are scheduled hourly, snapshots will be
15+
# available for the past N hours; if backups are scheduled daily, snapshots will
16+
# be available for the past N days ...
17+
GHE_NUM_SNAPSHOTS=10
18+
19+
# Pruning snapshots can be scheduled outside of the backup process.
20+
# If set to 'yes', snapshots will not be pruned by ghe-backup.
21+
# Instead, ghe-pruning-snapshots will need to be invoked separately via cron
22+
#GHE_PRUNING_SCHEDULED=yes
23+
24+
# If --incremental is used to generate incremental MySQL backups with ghe-backup,
25+
# then you need to specify how many cycles of full and incremental backups will be
26+
# performed before the next full backup is created.
27+
# For example, if `GHE_INCREMENTAL_BACKUP_MAX` is set to 14, backup-utils will
28+
# run 1 full backup and then 13 incremental backups before performing another full backup on the next cycle.
29+
#GHE_INCREMENTAL_MAX_BACKUPS=14
30+
31+
# If GHE_ROUTE_VERIFICATION is set to true then ghe-repository-backup and
32+
# ghe-storage-backup will issue a warning if the repositories and objects in
33+
# the backup do not match the pre-backup inventory of routes.
34+
#GHE_ROUTE_VERIFICATION=false
35+
36+
# If GHE_SKIP_CHECKS is set to true (or if --skip-checks is used with ghe-backup) then ghe-host-check
37+
# disk space validation and software version checks on the backup-host will be disabled.
38+
#GHE_SKIP_CHECKS=false
39+
40+
# Cluster filesystem to check if it's writable as part of ghe-host-check
41+
# By default it is /data/user/tmp but can be updated if needed
42+
#GHE_FILE_SYSTEM_WRITE_CHECK="/data/user/tmp"
43+
44+
# The hostname of the GitHub appliance to restore. If you've set up a separate
45+
# GitHub appliance to act as a standby for recovery, specify its IP or hostname
46+
# here. The host to restore to may also be specified directly when running
47+
# ghe-restore so use of this variable isn't strictly required.
48+
#
49+
#GHE_RESTORE_HOST="github-standby.example.com"
50+
51+
# If set to 'yes', ghe-restore will omit the restore of audit logs.
52+
#
53+
#GHE_RESTORE_SKIP_AUDIT_LOGS=no
54+
55+
# When verbose output is enabled with `-v`, it's written to stdout by default. If
56+
# you'd prefer it to be written to a separate file, set this option.
57+
#
58+
#GHE_VERBOSE_LOG="/var/log/backup-verbose.log"
59+
60+
# Any extra options passed to the SSH command.
61+
# In a single instance environment, nothing is required by default.
62+
# In a clustering environment, "-i abs-path-to-ssh-private-key" is required.
63+
#
64+
#GHE_EXTRA_SSH_OPTS=""
65+
66+
# Any extra options passed to the rsync command. Nothing required by default.
67+
#
68+
#GHE_EXTRA_RSYNC_OPTS=""
69+
70+
# If set to 'yes', rsync will be set to use compression during backups and restores transfers. Defaults to 'no'.
71+
#
72+
#GHE_RSYNC_COMPRESSION_ENABLED=yes
73+
74+
# If enabled and set to 'no', rsync warning message during backups will be suppressed.
75+
#RSYNC_WARNING=no
76+
77+
78+
# If set to 'yes', logging output will be colorized.
79+
#
80+
#OUTPUT_COLOR=no
81+
82+
# If set to 'no', GHE_DATA_DIR will not be created automatically
83+
# and restore/backup will exit 8
84+
#
85+
#GHE_CREATE_DATA_DIR=yes
86+
87+
# If set to 'yes', git fsck will run on the repositories
88+
# and print some additional info.
89+
#
90+
# WARNING: do not enable this, only useful for debugging/development
91+
#GHE_BACKUP_FSCK=no
92+
93+
# Cadence of MSSQL backups
94+
# <full>,<differential>,<transactionlog> all in minutes
95+
# e.g.
96+
# - Full backup every week (10080 minutes)
97+
# - Differential backup every day (1440 minutes)
98+
# - Transactionlog backup every 15 minutes
99+
#
100+
#GHE_MSSQL_BACKUP_CADENCE=10080,1440,15
101+
102+
# If set to 'yes', ghe-backup jobs will run in parallel. Defaults to 'no'.
103+
#
104+
#GHE_PARALLEL_ENABLED=yes
105+
106+
# Sets the maximum number of jobs to run in parallel. Defaults to the number
107+
# of available processing units on the machine.
108+
#
109+
#GHE_PARALLEL_MAX_JOBS=2
110+
111+
# Sets the maximum number of rsync jobs to run in parallel. Defaults to the
112+
# configured GHE_PARALLEL_MAX_JOBS, or the number of available processing
113+
# units on the machine.
114+
#
115+
# GHE_PARALLEL_RSYNC_MAX_JOBS=3
116+
117+
# When jobs are running in parallel wait as needed to avoid starting new jobs
118+
# when the system's load average is not below the specified percentage. Defaults to
119+
# unrestricted.
120+
#
121+
#GHE_PARALLEL_MAX_LOAD=50
122+
123+
# When running an external mysql database, run this script to trigger a MySQL backup
124+
# rather than attempting to backup via backup-utils directly.
125+
#EXTERNAL_DATABASE_BACKUP_SCRIPT="/bin/false"
126+
127+
# When running an external mysql database, run this script to trigger a MySQL restore
128+
# rather than attempting to backup via backup-utils directly.
129+
#EXTERNAL_DATABASE_RESTORE_SCRIPT="/bin/false"
130+
131+
# If set to 'yes', Pages data will be included in backup and restore. Defaults to 'yes'
132+
#GHE_BACKUP_PAGES=no

0 commit comments

Comments
 (0)