def setup_method(self, method):
super().setup_method(method)
self.config = self.config_template({
"backup_sites": {
self.test_site: {
"object_storage": {
"storage_type": "local",
"directory": self.temp_dir
},
},
},
})
self.foo_path = os.path.join(self.temp_dir, self.test_site, "xlog", "00000001000000000000000C")
os.makedirs(os.path.join(self.temp_dir, self.test_site, "xlog"))
with open(self.foo_path, "w") as out:
out.write("foo")
self.foo_basebackup_path = os.path.join(self.temp_dir, self.test_site, "basebackup", "2015-04-15_0", "base.tar.xz")
os.makedirs(os.path.join(self.temp_dir, self.test_site, "basebackup", "2015-04-15_0"))
with open(self.foo_basebackup_path, "w") as out:
out.write("foo")
self.compression_queue = Queue()
self.transfer_queue = Queue()
self.transfer_agent = TransferAgent(
config=self.config,
compression_queue=self.compression_queue,
mp_manager=None,
transfer_queue=self.transfer_queue,
metrics=metrics.Metrics(statsd={}),
shared_state_dict={}
)
self.transfer_agent.start()
def test_parse_backup_label(self, tmpdir):
td = str(tmpdir)
fn = os.path.join(td, "backup.tar")
with tarfile.open(fn, "w") as tfile:
with open(os.path.join(td, "backup_label"), "wb") as fp:
fp.write(
b'''\
START WAL LOCATION: 0/4000028 (file 000000010000000000000004)
CHECKPOINT LOCATION: 0/4000060
BACKUP METHOD: streamed
BACKUP FROM: master
START TIME: 2015-02-12 14:07:19 GMT
LABEL: pg_basebackup base backup
'''
)
tfile.add(os.path.join(td, "backup_label"), arcname="backup_label")
pgb = PGBaseBackup(
config=None,
site="foosite",
connection_info=None,
basebackup_path=None,
compression_queue=None,
storage=None,
transfer_queue=None,
metrics=metrics.Metrics(statsd={})
)
start_wal_segment, start_time = pgb.parse_backup_label_in_tar(fn)
assert start_wal_segment == "000000010000000000000004"
assert start_time == "2015-02-12T14:07:19+00:00"
def test_find_and_split_files_to_backup(self, tmpdir):
pgdata = str(tmpdir.mkdir("pgdata"))
top = os.path.join(pgdata, "split_top")
sub = os.path.join(top, "split_sub")
os.makedirs(sub, exist_ok=True)
with open(os.path.join(top, "f1"), "w") as f:
f.write("a" * 50000)
with open(os.path.join(top, "f2"), "w") as f:
f.write("a" * 50000)
with open(os.path.join(top, "f3"), "w") as f:
f.write("a" * 50000)
with open(os.path.join(sub, "f1"), "w") as f:
f.write("a" * 50000)
with open(os.path.join(sub, "f2"), "w") as f:
f.write("a" * 50000)
with open(os.path.join(sub, "f3"), "w") as f:
f.write("a" * 50000)
pgb = PGBaseBackup(
config=None,
site="foosite",
connection_info=None,
basebackup_path=None,
compression_queue=None,
storage=None,
transfer_queue=None,
metrics=metrics.Metrics(statsd={})
)
total_file_count, chunks = pgb.find_and_split_files_to_backup(
pgdata=pgdata, tablespaces={}, target_chunk_size=110000
)
# 6 files and 2 directories
assert total_file_count == 8
assert len(chunks) == 3
print(chunks)
# split_top, split_top/f1, split_top/f2
chunk1 = [c[0] for c in chunks[0]]
assert len(chunk1) == 3
assert chunk1[0] == "pgdata/split_top"
assert chunk1[1] == "pgdata/split_top/f1"
assert chunk1[2] == "pgdata/split_top/f2"
# split_top, split_top/f3, split_top/split_sub, split_top/split_sub/f1
chunk2 = [c[0] for c in chunks[1]]
assert len(chunk2) == 4
assert chunk2[0] == "pgdata/split_top"
assert chunk2[1] == "pgdata/split_top/f3"
assert chunk2[2] == "pgdata/split_top/split_sub"
assert chunk2[3] == "pgdata/split_top/split_sub/f1"
# split_top, split_top/split_sub, split_top/split_sub/f2, split_top/split_sub/f3
chunk3 = [c[0] for c in chunks[2]]
assert len(chunk3) == 4
assert chunk3[0] == "pgdata/split_top"
assert chunk3[1] == "pgdata/split_top/split_sub"
assert chunk3[2] == "pgdata/split_top/split_sub/f2"
assert chunk3[3] == "pgdata/split_top/split_sub/f3"
def load_config(self, _signal=None, _frame=None): # pylint: disable=unused-argument
self.log.debug("Loading JSON config from: %r, signal: %r",
self.config_path, _signal)
try:
new_config = config.read_json_config_file(self.config_path)
except (InvalidConfigurationError, subprocess.CalledProcessError,
UnicodeDecodeError) as ex:
self.log.exception("Invalid config file %r: %s: %s",
self.config_path, ex.__class__.__name__, ex)
# if we were called by a signal handler we'll ignore (and log)
# the error and hope the user fixes the configuration before
# restarting pghoard.
if _signal is not None:
return
if isinstance(ex, InvalidConfigurationError):
raise
raise InvalidConfigurationError(self.config_path)
# clear this objects site transfer storage config
self.site_transfers = {}
self.config = new_config
if self.config.get("syslog") and not self.syslog_handler:
self.syslog_handler = logutil.set_syslog_handler(
address=self.config.get("syslog_address", "/dev/log"),
facility=self.config.get("syslog_facility", "local2"),
logger=logging.getLogger(),
)
# NOTE: getLevelName() also converts level names to numbers
self.log_level = logging.getLevelName(self.config["log_level"])
try:
logging.getLogger().setLevel(self.log_level)
except ValueError:
self.log.exception("Problem with log_level: %r", self.log_level)
# Setup monitoring clients
self.metrics = metrics.Metrics(
statsd=self.config.get("statsd", None),
pushgateway=self.config.get("pushgateway", None),
prometheus=self.config.get("prometheus", None))
# need to refresh the web server config too
if hasattr(self, "webserver") and hasattr(self.webserver, "server"):
self.webserver.server.config = new_config
for thread in self._get_all_threads():
thread.config = new_config
thread.site_transfers = {}
self.log.debug("Loaded config: %r from: %r", self.config,
self.config_path)
def setup_method(self, method):
super().setup_method(method)
self.log = logging.getLogger(str(method))
self.config = self.config_template({
"backup_sites": {
self.test_site: {
"backup_location": self.temp_dir,
"encryption_key_id": None,
"encryption_keys": {
"testkey": {
"public": CONSTANT_TEST_RSA_PUBLIC_KEY,
"private": CONSTANT_TEST_RSA_PRIVATE_KEY
},
},
"object_storage": {
"storage_type": "s3",
},
"pg_version": 90500,
"prefix": "",
},
},
"compression": {
"algorithm": self.algorithm,
},
})
self.compression_queue = Queue()
self.transfer_queue = Queue()
self.incoming_path = os.path.join(
self.config["backup_location"],
self.config["backup_sites"][self.test_site]["prefix"],
"xlog_incoming",
)
os.makedirs(self.incoming_path)
self.handled_path = os.path.join(
self.config["backup_location"],
self.config["backup_sites"][self.test_site]["prefix"],
"xlog",
)
os.makedirs(self.handled_path)
self.compressor = CompressorThread(
config_dict=self.config,
compression_queue=self.compression_queue,
transfer_queue=self.transfer_queue,
metrics=metrics.Metrics(statsd={}),
)
self.compressor.start()
def test_find_files(self, db):
top1 = os.path.join(db.pgdata, "top1.test")
top2 = os.path.join(db.pgdata, "top2.test")
sub1 = os.path.join(db.pgdata, "global", "sub1.test")
sub2 = os.path.join(db.pgdata, "global", "sub2.test")
sub3 = os.path.join(db.pgdata, "global", "sub3.test")
def create_test_files():
# Create two temporary files on top level and one in global/ that we'll unlink while iterating
with open(top1, "w") as t1, open(top2, "w") as t2, \
open(sub1, "w") as s1, open(sub2, "w") as s2, open(sub3, "w") as s3:
t1.write("t1\n")
t2.write("t2\n")
s1.write("s1\n")
s2.write("s2\n")
s3.write("s3\n")
pgb = PGBaseBackup(config=None,
site="foosite",
connection_info=None,
basebackup_path=None,
compression_queue=None,
transfer_queue=None,
metrics=metrics.Metrics(statsd={}))
create_test_files()
files = pgb.find_files_to_backup(pgdata=db.pgdata, tablespaces={})
first_file = next(files)
os.unlink(top1)
os.unlink(top2)
os.unlink(sub1)
os.unlink(sub2)
# Missing files are not accepted at top level
with pytest.raises(FileNotFoundError):
list(files)
# Recreate test files and unlink just the one from a subdirectory
create_test_files()
files = pgb.find_files_to_backup(pgdata=db.pgdata, tablespaces={})
first_file = next(files)
os.unlink(sub1)
# Missing files in sub directories are ok
ftbu = [first_file[:-1]] + list(f[:-1]
for f in files if f[-1] != "leave")
# Check that missing_ok flag is not set for top-level items
for bu_path, local_path, missing_ok in ftbu:
if os.path.dirname(bu_path) == "pgdata":
assert missing_ok is False, (bu_path, local_path, missing_ok)
else:
assert missing_ok is True, (bu_path, local_path, missing_ok)
# files to backup should include both top level items and two sub-level items
bunameset = set(item[0] for item in ftbu)
assert len(bunameset) == len(ftbu)
assert "pgdata/top1.test" in bunameset
assert "pgdata/top2.test" in bunameset
assert "pgdata/global/sub1.test" not in bunameset
assert "pgdata/global/sub2.test" in bunameset
assert "pgdata/global/sub3.test" in bunameset
# Now delete a file on the top level before we have a chance of tarring anything
os.unlink(top2)
class FakeTar:
def __init__(self):
self.items = []
def add(self, local_path, *, arcname, recursive):
assert recursive is False
self.items.append((local_path, arcname, os.stat(local_path)))
# This will fail because top-level items may not be missing
faketar = FakeTar()
with pytest.raises(FileNotFoundError):
pgb.write_files_to_tar(files=ftbu, tar=faketar)
# Recreate test files and unlink just a subdirectory item
create_test_files()
os.unlink(sub2)
# Now adding files should work and we should end up with every file except for sub2 in the archive
faketar = FakeTar()
pgb.write_files_to_tar(files=ftbu, tar=faketar)
arcnameset = set(item[1] for item in faketar.items)
assert len(arcnameset) == len(faketar.items)
expected_items = bunameset - {"pgdata/global/sub2.test"}
assert arcnameset == expected_items
assert "pgdata/global/sub1.test" not in arcnameset # not in set of files to backup
assert "pgdata/global/sub2.test" not in arcnameset # acceptable loss
assert "pgdata/global/sub3.test" in arcnameset # acceptable
def _test_restore_basebackup(self,
db,
pghoard,
tmpdir,
active_backup_mode="archive_command"):
backup_out = tmpdir.join("test-restore").strpath
# Restoring to empty directory works
os.makedirs(backup_out)
Restore().run([
"get-basebackup",
"--config",
pghoard.config_path,
"--site",
pghoard.test_site,
"--target-dir",
backup_out,
])
# Restoring on top of another $PGDATA doesn't
with pytest.raises(RestoreError) as excinfo:
Restore().run([
"get-basebackup",
"--config",
pghoard.config_path,
"--site",
pghoard.test_site,
"--target-dir",
backup_out,
])
assert "--overwrite not specified" in str(excinfo.value)
# Until we use the --overwrite flag
Restore().run([
"get-basebackup",
"--config",
pghoard.config_path,
"--site",
pghoard.test_site,
"--target-dir",
backup_out,
"--overwrite",
])
check_call([os.path.join(db.pgbin, "pg_controldata"), backup_out])
# TODO: check that the backup is valid
# there should only be a single backup so lets compare what was in the metadata with what
# was in the backup label
storage_config = common.get_object_storage_config(
pghoard.config, pghoard.test_site)
storage = get_transfer(storage_config)
backups = storage.list_path(
os.path.join(
pghoard.config["backup_sites"][pghoard.test_site]["prefix"],
"basebackup"))
# lets grab the backup label details for what we restored
pgb = PGBaseBackup(config=None,
site="foosite",
connection_info=None,
basebackup_path=None,
compression_queue=None,
transfer_queue=None,
metrics=metrics.Metrics(statsd={}))
path = os.path.join(backup_out, "backup_label")
with open(path, "r") as myfile:
data = myfile.read()
start_wal_segment, start_time = pgb.parse_backup_label(data)
assert start_wal_segment == backups[0]['metadata']['start-wal-segment']
assert start_time == backups[0]['metadata']['start-time']
# for a standalone hot backup, the start wal file will be in the pg_xlog / pg_wal directory
wal_dir = "pg_xlog"
if float(db.pgver) >= float("10.0"):
wal_dir = "pg_wal"
path = os.path.join(backup_out, wal_dir,
backups[0]['metadata']['start-wal-segment'])
if active_backup_mode == "standalone_hot_backup":
assert os.path.isfile(path) is True
else:
assert os.path.isfile(path) is False
