yannstatic/static/2023/10/31/BorgBackup_vers-Boite_de_stockage.html

2588 lines
233 KiB
HTML
Raw Normal View History

2024-10-31 20:18:37 +01:00
<!DOCTYPE html><html lang="fr">
<head><meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
2024-11-07 22:37:17 +01:00
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no"><title>BorgBackup vers boîte de stockage BX11 Hetzner - sftp - YannStatic</title>
2024-10-31 20:18:37 +01:00
<meta name="description" content="Sauvegarder via borg des serveurs VPS sur une “boîte de stockage” BX11 Hetzner">
<link rel="canonical" href="https://static.rnmkcy.eu/2023/10/31/BorgBackup_vers-Boite_de_stockage.html"><link rel="alternate" type="application/rss+xml" title="YannStatic" href="/feed.xml">
<!-- - include head/favicon.html - -->
<link rel="shortcut icon" type="image/png" href="/assets/favicon/favicon.png"><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.13/css/all.css" ><!-- start custom head snippets --><link rel="stylesheet" href="/assets/css/expand.css">
<!-- end custom head snippets --><script>(function() {
window.isArray = function(val) {
return Object.prototype.toString.call(val) === '[object Array]';
};
window.isString = function(val) {
return typeof val === 'string';
};
window.hasEvent = function(event) {
return 'on'.concat(event) in window.document;
};
window.isOverallScroller = function(node) {
return node === document.documentElement || node === document.body || node === window;
};
window.isFormElement = function(node) {
var tagName = node.tagName;
return tagName === 'INPUT' || tagName === 'SELECT' || tagName === 'TEXTAREA';
};
window.pageLoad = (function () {
var loaded = false, cbs = [];
window.addEventListener('load', function () {
var i;
loaded = true;
if (cbs.length > 0) {
for (i = 0; i < cbs.length; i++) {
cbs[i]();
}
}
});
return {
then: function(cb) {
cb && (loaded ? cb() : (cbs.push(cb)));
}
};
})();
})();
(function() {
window.throttle = function(func, wait) {
var args, result, thisArg, timeoutId, lastCalled = 0;
function trailingCall() {
lastCalled = new Date;
timeoutId = null;
result = func.apply(thisArg, args);
}
return function() {
var now = new Date,
remaining = wait - (now - lastCalled);
args = arguments;
thisArg = this;
if (remaining <= 0) {
clearTimeout(timeoutId);
timeoutId = null;
lastCalled = now;
result = func.apply(thisArg, args);
} else if (!timeoutId) {
timeoutId = setTimeout(trailingCall, remaining);
}
return result;
};
};
})();
(function() {
var Set = (function() {
var add = function(item) {
var i, data = this._data;
for (i = 0; i < data.length; i++) {
if (data[i] === item) {
return;
}
}
this.size ++;
data.push(item);
return data;
};
var Set = function(data) {
this.size = 0;
this._data = [];
var i;
if (data.length > 0) {
for (i = 0; i < data.length; i++) {
add.call(this, data[i]);
}
}
};
Set.prototype.add = add;
Set.prototype.get = function(index) { return this._data[index]; };
Set.prototype.has = function(item) {
var i, data = this._data;
for (i = 0; i < data.length; i++) {
if (this.get(i) === item) {
return true;
}
}
return false;
};
Set.prototype.is = function(map) {
if (map._data.length !== this._data.length) { return false; }
var i, j, flag, tData = this._data, mData = map._data;
for (i = 0; i < tData.length; i++) {
for (flag = false, j = 0; j < mData.length; j++) {
if (tData[i] === mData[j]) {
flag = true;
break;
}
}
if (!flag) { return false; }
}
return true;
};
Set.prototype.values = function() {
return this._data;
};
return Set;
})();
window.Lazyload = (function(doc) {
var queue = {js: [], css: []}, sources = {js: {}, css: {}}, context = this;
var createNode = function(name, attrs) {
var node = doc.createElement(name), attr;
for (attr in attrs) {
if (attrs.hasOwnProperty(attr)) {
node.setAttribute(attr, attrs[attr]);
}
}
return node;
};
var end = function(type, url) {
var s, q, qi, cbs, i, j, cur, val, flag;
if (type === 'js' || type ==='css') {
s = sources[type], q = queue[type];
s[url] = true;
for (i = 0; i < q.length; i++) {
cur = q[i];
if (cur.urls.has(url)) {
qi = cur, val = qi.urls.values();
qi && (cbs = qi.callbacks);
for (flag = true, j = 0; j < val.length; j++) {
cur = val[j];
if (!s[cur]) {
flag = false;
}
}
if (flag && cbs && cbs.length > 0) {
for (j = 0; j < cbs.length; j++) {
cbs[j].call(context);
}
qi.load = true;
}
}
}
}
};
var load = function(type, urls, callback) {
var s, q, qi, node, i, cur,
_urls = typeof urls === 'string' ? new Set([urls]) : new Set(urls), val, url;
if (type === 'js' || type ==='css') {
s = sources[type], q = queue[type];
for (i = 0; i < q.length; i++) {
cur = q[i];
if (_urls.is(cur.urls)) {
qi = cur;
break;
}
}
val = _urls.values();
if (qi) {
callback && (qi.load || qi.callbacks.push(callback));
callback && (qi.load && callback());
} else {
q.push({
urls: _urls,
callbacks: callback ? [callback] : [],
load: false
});
for (i = 0; i < val.length; i++) {
node = null, url = val[i];
if (s[url] === undefined) {
(type === 'js' ) && (node = createNode('script', { src: url }));
(type === 'css') && (node = createNode('link', { rel: 'stylesheet', href: url }));
if (node) {
node.onload = (function(type, url) {
return function() {
end(type, url);
};
})(type, url);
(doc.head || doc.body).appendChild(node);
s[url] = false;
}
}
}
}
}
};
return {
js: function(url, callback) {
load('js', url, callback);
},
css: function(url, callback) {
load('css', url, callback);
}
};
})(this.document);
})();
</script><script>
(function() {
var TEXT_VARIABLES = {
version: '2.2.6',
sources: {
font_awesome: 'https://use.fontawesome.com/releases/v5.0.13/css/all.css',
jquery: '/assets/js/jquery.min.js',
leancloud_js_sdk: '//cdn.jsdelivr.net/npm/leancloud-storage@3.13.2/dist/av-min.js',
chart: 'https://cdn.bootcss.com/Chart.js/2.7.2/Chart.bundle.min.js',
gitalk: {
js: 'https://cdn.bootcss.com/gitalk/1.2.2/gitalk.min.js',
css: 'https://cdn.bootcss.com/gitalk/1.2.2/gitalk.min.css'
},
valine: 'https://unpkg.com/valine/dist/Valine.min.js'
},
site: {
toc: {
selectors: 'h1,h2,h3'
}
},
paths: {
search_js: '/assets/search.js'
}
};
window.TEXT_VARIABLES = TEXT_VARIABLES;
})();
</script>
</head>
<body>
<div class="root" data-is-touch="false">
<div class="layout--page js-page-root"><!----><div class="page__main js-page-main page__viewport hide-footer has-aside has-aside cell cell--auto">
<div class="page__main-inner"><div class="page__header d-print-none"><header class="header"><div class="main">
<div class="header__title">
<div class="header__brand"><svg id="svg" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="400" height="478.9473684210526" viewBox="0, 0, 400,478.9473684210526"><g id="svgg"><path id="path0" d="M308.400 56.805 C 306.970 56.966,303.280 57.385,300.200 57.738 C 290.906 58.803,278.299 59.676,269.200 59.887 L 260.600 60.085 259.400 61.171 C 258.010 62.428,256.198 63.600,255.645 63.600 C 255.070 63.600,252.887 65.897,252.598 66.806 C 252.460 67.243,252.206 67.600,252.034 67.600 C 251.397 67.600,247.206 71.509,247.202 72.107 C 247.201 72.275,246.390 73.190,245.400 74.138 C 243.961 75.517,243.598 76.137,243.592 77.231 C 243.579 79.293,241.785 83.966,240.470 85.364 C 239.176 86.740,238.522 88.365,237.991 91.521 C 237.631 93.665,236.114 97.200,235.554 97.200 C 234.938 97.200,232.737 102.354,232.450 104.472 C 232.158 106.625,230.879 109.226,229.535 110.400 C 228.933 110.926,228.171 113.162,226.434 119.500 C 226.178 120.435,225.795 121.200,225.584 121.200 C 225.373 121.200,225.200 121.476,225.200 121.813 C 225.200 122.149,224.885 122.541,224.500 122.683 C 223.606 123.013,223.214 123.593,223.204 124.600 C 223.183 126.555,220.763 132.911,219.410 134.562 C 218.443 135.742,217.876 136.956,217.599 138.440 C 217.041 141.424,215.177 146.434,214.532 146.681 C 214.240 146.794,214.000 147.055,214.000 147.261 C 214.000 147.467,213.550 148.086,213.000 148.636 C 212.450 149.186,212.000 149.893,212.000 150.208 C 212.000 151.386,208.441 154.450,207.597 153.998 C 206.319 153.315,204.913 150.379,204.633 147.811 C 204.365 145.357,202.848 142.147,201.759 141.729 C 200.967 141.425,199.200 137.451,199.200 135.974 C 199.200 134.629,198.435 133.224,196.660 131.311 C 195.363 129.913,194.572 128.123,193.870 125.000 C 193.623 123.900,193.236 122.793,193.010 122.540 C 190.863 120.133,190.147 118.880,188.978 115.481 C 188.100 112.928,187.151 111.003,186.254 109.955 C 185.358 108.908,184.518 107.204,183.847 105.073 C 183.280 103.273,182.497 101.329,182.108 100.753 C 181.719 100.177,180.904 98.997,180.298 98.131 C 179.693 97.265,178.939 95.576,178.624 94.378 C 178.041 92.159,177.125 90.326,175.023 87.168 C 174.375 86.196,173.619 84.539,173.342 83.486 C 172.800 81.429,171.529 79.567,170.131 78.785 C 169.654 78.517,168.697 77.511,168.006 76.549 C 167.316 75.587,166.594 74.800,166.402 74.800 C 166.210 74.800,164.869 73.633,163.421 72.206 C 160.103 68.936,161.107 69.109,146.550 69.301 C 133.437 69.474,128.581 70.162,126.618 72.124 C 126.248 72.495,125.462 72.904,124.872 73.033 C 124.282 73.163,123.088 73.536,122.219 73.863 C 121.349 74.191,119.028 74.638,117.061 74.858 C 113.514 75.254,109.970 76.350,108.782 77.419 C 107.652 78.436,100.146 80.400,97.388 80.400 C 95.775 80.400,93.167 81.360,91.200 82.679 C 90.430 83.195,89.113 83.804,88.274 84.031 C 85.875 84.681,78.799 90.910,74.400 96.243 L 73.400 97.456 73.455 106.028 C 73.526 117.055,74.527 121.238,77.820 124.263 C 78.919 125.273,80.400 127.902,80.400 128.842 C 80.400 129.202,81.075 130.256,81.900 131.186 C 83.563 133.059,85.497 136.346,86.039 138.216 C 86.233 138.886,87.203 140.207,88.196 141.153 C 89.188 142.098,90.000 143.104,90.000 143.388 C 90.000 144.337,92.129 148.594,92.869 149.123 C 93.271 149.410,93.600 149.831,93.600 150.059 C 93.600 150.286,93.932 150.771,94.337 151.136 C 94.743 151.501,95.598 153.004,96.237 154.475 C 96.877 155.947,97.760 157.351,98.200 157.596 C 98.640 157.841,99.900 159.943,101.000 162.267 C 102.207 164.817,103.327 166.644,103.825 166.876 C 104.278 167.087,105.065 168.101,105.573 169.130 C 107.658 173.348,108.097 174.093,110.006 176.647 C 111.103 178.114,112.000 179.725,112.000 180.227 C 112.000 181.048,113.425 183.163,114.678 184.200 C 115.295 184.711,117.396 188.733,117.720 190.022 C 117.855 190.562,118.603 191.633,119.381 192.402 C 120.160 193.171,121.496 195.258,122.351 197.039 C 123.206 198.820,124.167 200.378,124.487 200.501 C 124.807 200.624,125.953 202.496,127.034 204.662 C 128.114 206.828,129.676 209.299,130.505 210.153 C 131.333 211.007,132.124 212.177,132.262 212.753 C 132.618 214.239,134.291 217.048,136.288 219.5
" href="/">YannStatic</a></div><!--<button class="button button--secondary button--circle search-button js-search-toggle"><i class="fas fa-search"></i></button>--><!-- <li><button class="button button--secondary button--circle search-button js-search-toggle"><i class="fas fa-search"></i></button></li> -->
<!-- Champ de recherche -->
<div id="searchbox" class="search search--dark" style="visibility: visible">
<div class="main">
<div class="search__header"></div>
<div class="search-bar">
<div class="search-box js-search-box">
<div class="search-box__icon-search"><i class="fas fa-search"></i></div>
<input id="search-input" type="text" />
<!-- <div class="search-box__icon-clear js-icon-clear">
<a><i class="fas fa-times"></i></a>
</div> -->
</div>
</div>
</div>
</div>
<!-- Script pointing to search-script.js -->
<script>/*!
* Simple-Jekyll-Search
* Copyright 2015-2020, Christian Fei
* Licensed under the MIT License.
*/
(function(){
'use strict'
var _$Templater_7 = {
compile: compile,
setOptions: setOptions
}
const options = {}
options.pattern = /\{(.*?)\}/g
options.template = ''
options.middleware = function () {}
function setOptions (_options) {
options.pattern = _options.pattern || options.pattern
options.template = _options.template || options.template
if (typeof _options.middleware === 'function') {
options.middleware = _options.middleware
}
}
function compile (data) {
return options.template.replace(options.pattern, function (match, prop) {
const value = options.middleware(prop, data[prop], options.template)
if (typeof value !== 'undefined') {
return value
}
return data[prop] || match
})
}
'use strict';
function fuzzysearch (needle, haystack) {
var tlen = haystack.length;
var qlen = needle.length;
if (qlen > tlen) {
return false;
}
if (qlen === tlen) {
return needle === haystack;
}
outer: for (var i = 0, j = 0; i < qlen; i++) {
var nch = needle.charCodeAt(i);
while (j < tlen) {
if (haystack.charCodeAt(j++) === nch) {
continue outer;
}
}
return false;
}
return true;
}
var _$fuzzysearch_1 = fuzzysearch;
'use strict'
/* removed: const _$fuzzysearch_1 = require('fuzzysearch') */;
var _$FuzzySearchStrategy_5 = new FuzzySearchStrategy()
function FuzzySearchStrategy () {
this.matches = function (string, crit) {
return _$fuzzysearch_1(crit.toLowerCase(), string.toLowerCase())
}
}
'use strict'
var _$LiteralSearchStrategy_6 = new LiteralSearchStrategy()
function LiteralSearchStrategy () {
this.matches = function (str, crit) {
if (!str) return false
str = str.trim().toLowerCase()
crit = crit.trim().toLowerCase()
return crit.split(' ').filter(function (word) {
return str.indexOf(word) >= 0
}).length === crit.split(' ').length
}
}
'use strict'
var _$Repository_4 = {
put: put,
clear: clear,
search: search,
setOptions: __setOptions_4
}
/* removed: const _$FuzzySearchStrategy_5 = require('./SearchStrategies/FuzzySearchStrategy') */;
/* removed: const _$LiteralSearchStrategy_6 = require('./SearchStrategies/LiteralSearchStrategy') */;
function NoSort () {
return 0
}
const data = []
let opt = {}
opt.fuzzy = false
opt.limit = 10
opt.searchStrategy = opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = NoSort
opt.exclude = []
function put (data) {
if (isObject(data)) {
return addObject(data)
}
if (isArray(data)) {
return addArray(data)
}
return undefined
}
function clear () {
data.length = 0
return data
}
function isObject (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Object]'
}
function isArray (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Array]'
}
function addObject (_data) {
data.push(_data)
return data
}
function addArray (_data) {
const added = []
clear()
for (let i = 0, len = _data.length; i < len; i++) {
if (isObject(_data[i])) {
added.push(addObject(_data[i]))
}
}
return added
}
function search (crit) {
if (!crit) {
return []
}
return findMatches(data, crit, opt.searchStrategy, opt).sort(opt.sort)
}
function __setOptions_4 (_opt) {
opt = _opt || {}
opt.fuzzy = _opt.fuzzy || false
opt.limit = _opt.limit || 10
opt.searchStrategy = _opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = _opt.sort || NoSort
opt.exclude = _opt.exclude || []
}
function findMatches (data, crit, strategy, opt) {
const matches = []
for (let i = 0; i < data.length && matches.length < opt.limit; i++) {
const match = findMatchesInObject(data[i], crit, strategy, opt)
if (match) {
matches.push(match)
}
}
return matches
}
function findMatchesInObject (obj, crit, strategy, opt) {
for (const key in obj) {
if (!isExcluded(obj[key], opt.exclude) && strategy.matches(obj[key], crit)) {
return obj
}
}
}
function isExcluded (term, excludedTerms) {
for (let i = 0, len = excludedTerms.length; i < len; i++) {
const excludedTerm = excludedTerms[i]
if (new RegExp(excludedTerm).test(term)) {
return true
}
}
return false
}
/* globals ActiveXObject:false */
'use strict'
var _$JSONLoader_2 = {
load: load
}
function load (location, callback) {
const xhr = getXHR()
xhr.open('GET', location, true)
xhr.onreadystatechange = createStateChangeListener(xhr, callback)
xhr.send()
}
function createStateChangeListener (xhr, callback) {
return function () {
if (xhr.readyState === 4 && xhr.status === 200) {
try {
callback(null, JSON.parse(xhr.responseText))
} catch (err) {
callback(err, null)
}
}
}
}
function getXHR () {
return window.XMLHttpRequest ? new window.XMLHttpRequest() : new ActiveXObject('Microsoft.XMLHTTP')
}
'use strict'
var _$OptionsValidator_3 = function OptionsValidator (params) {
if (!validateParams(params)) {
throw new Error('-- OptionsValidator: required options missing')
}
if (!(this instanceof OptionsValidator)) {
return new OptionsValidator(params)
}
const requiredOptions = params.required
this.getRequiredOptions = function () {
return requiredOptions
}
this.validate = function (parameters) {
const errors = []
requiredOptions.forEach(function (requiredOptionName) {
if (typeof parameters[requiredOptionName] === 'undefined') {
errors.push(requiredOptionName)
}
})
return errors
}
function validateParams (params) {
if (!params) {
return false
}
return typeof params.required !== 'undefined' && params.required instanceof Array
}
}
'use strict'
var _$utils_9 = {
merge: merge,
isJSON: isJSON
}
function merge (defaultParams, mergeParams) {
const mergedOptions = {}
for (const option in defaultParams) {
mergedOptions[option] = defaultParams[option]
if (typeof mergeParams[option] !== 'undefined') {
mergedOptions[option] = mergeParams[option]
}
}
return mergedOptions
}
function isJSON (json) {
try {
if (json instanceof Object && JSON.parse(JSON.stringify(json))) {
return true
}
return false
} catch (err) {
return false
}
}
var _$src_8 = {};
(function (window) {
'use strict'
let options = {
searchInput: null,
resultsContainer: null,
json: [],
success: Function.prototype,
searchResultTemplate: '<li><a href="{url}" title="{desc}">{title}</a></li>',
templateMiddleware: Function.prototype,
sortMiddleware: function () {
return 0
},
noResultsText: 'No results found',
limit: 10,
fuzzy: false,
debounceTime: null,
exclude: []
}
let debounceTimerHandle
const debounce = function (func, delayMillis) {
if (delayMillis) {
clearTimeout(debounceTimerHandle)
debounceTimerHandle = setTimeout(func, delayMillis)
} else {
func.call()
}
}
const requiredOptions = ['searchInput', 'resultsContainer', 'json']
/* removed: const _$Templater_7 = require('./Templater') */;
/* removed: const _$Repository_4 = require('./Repository') */;
/* removed: const _$JSONLoader_2 = require('./JSONLoader') */;
const optionsValidator = _$OptionsValidator_3({
required: requiredOptions
})
/* removed: const _$utils_9 = require('./utils') */;
window.SimpleJekyllSearch = function (_options) {
const errors = optionsValidator.validate(_options)
if (errors.length > 0) {
throwError('You must specify the following required options: ' + requiredOptions)
}
options = _$utils_9.merge(options, _options)
_$Templater_7.setOptions({
template: options.searchResultTemplate,
middleware: options.templateMiddleware
})
_$Repository_4.setOptions({
fuzzy: options.fuzzy,
limit: options.limit,
sort: options.sortMiddleware,
exclude: options.exclude
})
if (_$utils_9.isJSON(options.json)) {
initWithJSON(options.json)
} else {
initWithURL(options.json)
}
const rv = {
search: search
}
typeof options.success === 'function' && options.success.call(rv)
return rv
}
function initWithJSON (json) {
_$Repository_4.put(json)
registerInput()
}
function initWithURL (url) {
_$JSONLoader_2.load(url, function (err, json) {
if (err) {
throwError('failed to get JSON (' + url + ')')
}
initWithJSON(json)
})
}
function emptyResultsContainer () {
options.resultsContainer.innerHTML = ''
}
function appendToResultsContainer (text) {
options.resultsContainer.innerHTML += text
}
function registerInput () {
options.searchInput.addEventListener('input', function (e) {
if (isWhitelistedKey(e.which)) {
emptyResultsContainer()
debounce(function () { search(e.target.value) }, options.debounceTime)
}
})
}
function search (query) {
if (isValidQuery(query)) {
emptyResultsContainer()
render(_$Repository_4.search(query), query)
}
}
function render (results, query) {
const len = results.length
if (len === 0) {
return appendToResultsContainer(options.noResultsText)
}
for (let i = 0; i < len; i++) {
results[i].query = query
appendToResultsContainer(_$Templater_7.compile(results[i]))
}
}
function isValidQuery (query) {
return query && query.length > 0
}
function isWhitelistedKey (key) {
return [13, 16, 20, 37, 38, 39, 40, 91].indexOf(key) === -1
}
function throwError (message) {
throw new Error('SimpleJekyllSearch --- ' + message)
}
})(window)
}());
</script>
<!-- Configuration -->
<script>
SimpleJekyllSearch({
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
json: '/search.json',
//searchResultTemplate: '<li><a href="https://static.rnmkcy.eu{url}">{date}&nbsp;{title}</a></li>'
searchResultTemplate: '<li><a href="{url}">{date}&nbsp;{title}</a></li>'
})
</script>
<!-- Fin déclaration champ de recherche --></div><nav class="navigation">
2024-11-28 11:42:23 +01:00
<ul><li class="navigation__item"><a href="/archive.html">Etiquettes</a></li><li class="navigation__item"><a href="/htmldoc.html">Documents</a></li><li class="navigation__item"><a href="/liens_ttrss.html">Liens</a></li><li class="navigation__item"><a href="/syntaxe-markdown.html">Aide</a></li></ul>
2024-10-31 20:18:37 +01:00
</nav></div>
</header>
</div><div class="page__content"><div class ="main"><div class="grid grid--reverse">
<div class="col-main cell cell--auto"><!-- start custom main top snippet --><div id="results-container" class="search-result js-search-result"></div><!-- end custom main top snippet -->
2024-11-07 22:37:17 +01:00
<article itemscope itemtype="http://schema.org/Article"><div class="article__header"><header><h1 style="color:Tomato;">BorgBackup vers boîte de stockage BX11 Hetzner - sftp</h1></header></div><meta itemprop="headline" content="BorgBackup vers boîte de stockage BX11 Hetzner - sftp"><div class="article__info clearfix"><ul class="left-col menu"><li>
2024-11-08 14:10:33 +01:00
<a class="button button--secondary button--pill button--sm" style="color:#00FFFF" href="/archive.html?tag=borgbackup">borgbackup</a>
2024-10-31 20:18:37 +01:00
</li><li>
2024-11-08 14:10:33 +01:00
<a class="button button--secondary button--pill button--sm" style="color:#00FFFF" href="/archive.html?tag=yunohost">yunohost</a>
2024-10-31 20:18:37 +01:00
</li></ul><ul class="right-col menu"><li>
<i class="far fa-calendar-alt"></i>&nbsp;<span title="Création" style="color:#FF00FF">31&nbsp;oct.&nbsp;&nbsp;2023</span>
2024-11-07 22:37:17 +01:00
<span title="Modification" style="color:#00FF7F">&nbsp;2&nbsp;nov.&nbsp;&nbsp;2024</span></li></ul></div><meta itemprop="datePublished" content="2024-11-02T00:00:00+01:00">
2024-10-31 20:18:37 +01:00
<meta itemprop="keywords" content="borgbackup,yunohost"><div class="js-article-content">
<div class="layout--article"><!-- start custom article top snippet -->
<style>
#myBtn {
display: none;
position: fixed;
bottom: 10px;
right: 10px;
z-index: 99;
font-size: 12px;
font-weight: bold;
border: none;
outline: none;
background-color: white;
color: black;
cursor: pointer;
padding: 5px;
border-radius: 4px;
}
#myBtn:hover {
background-color: #555;
}
</style>
<button onclick="topFunction()" id="myBtn" title="Haut de page">&#8679;</button>
<script>
//Get the button
var mybutton = document.getElementById("myBtn");
// When the user scrolls down 20px from the top of the document, show the button
window.onscroll = function() {scrollFunction()};
function scrollFunction() {
if (document.body.scrollTop > 20 || document.documentElement.scrollTop > 20) {
mybutton.style.display = "block";
} else {
mybutton.style.display = "none";
}
}
// When the user clicks on the button, scroll to the top of the document
function topFunction() {
document.body.scrollTop = 0;
document.documentElement.scrollTop = 0;
}
</script>
<!-- end custom article top snippet -->
<div class="article__content" itemprop="articleBody"><details>
<summary><b>Afficher/cacher Sommaire</b></summary>
<!-- affichage sommaire -->
<div class="toc-aside js-toc-root"></div>
</details><p><em>Sauvegarder via borg des serveurs VPS sur une “boîte de stockage” BX11 Hetzner</em></p>
<p>Stockage disponible : 1 TB<br />
Trafic : illimité <code class="language-plaintext highlighter-rouge">*</code><br />
Emplacement :FSN1 (Falkenstein) Allemagne<br />
Instantanés 10<br />
à partir de 3.81 € par mois + 0,00 € de frais dinstallation unique<br />
Prix incluant la TVA de 19 %.</p>
<p class="info">Les boîtes de stockage vous offrent un stockage en ligne sûr et pratique pour vos données.</p>
<h2 id="bx11---caractéristiques-de-base">BX11 - Caractéristiques de base</h2>
<p>Après la souscription, accéder à la boîte de stockage <a href="https://robot.hetzner.com/storage">https://robot.hetzner.com/storage</a><br />
<img src="/images/bx11-001.png" alt="bx11" width="600" /><br />
Donner un nom : <strong>bx11-yann</strong></p>
<p>Détails, double-clic sur <strong>u326239</strong>, activer <strong>SSH</strong> et Reset password<br />
<img src="/images/bx11-001a.png" alt="bx11" width="600" /></p>
<h2 id="authentification-par-clé-ssh">Authentification par clé SSH</h2>
<p><strong>Authentification par clé SSH pour Backup Spaces et Storage Boxes</strong></p>
<p><em>Si vous utilisez SCP, SFTP, rsync ou BorgBackup, vous pouvez vous connecter en utilisant lauthentification par clé SSH sans saisir de mot de passe.</em></p>
<p><code class="language-plaintext warning highlighter-rouge">Remarque importante :</code> selon le port SSH du compte de sauvegarde/boîte de stockage que vous utilisez, vous devrez peut-être utiliser un format spécifique pour la clé SSH publique.</p>
<ul>
<li>Pour le port SSH 22 (SFTP et SCP uniquement), vous devez utiliser une clé publique SSH au format RFC4716.</li>
<li>Pour le port SSH 23 (SFTP, SCP, rsync et BorgBackup), vous devez utiliser une clé publique SSH commune au format OpenSSH.</li>
</ul>
<p class="info">Si vous souhaitez utiliser les services sur les deux ports, vous devez stocker la clé publique SSH dans les deux formats.</p>
<p class="warning">Lutilisation dune clé ed25519 nest pas prise en charge sur le port SSH 22.</p>
<p>Chaque <strong>sous-compte</strong> nécessite son propre fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code>.</p>
<h3 id="générer-clé-curve25519">Générer clé curve25519</h3>
<p>Générer une paire de clé curve25519-sha256 (ECDH avec Curve25519 et SHA2) pour une liaison SSH avec le serveur.</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen <span class="nt">-t</span> ed25519 <span class="nt">-o</span> <span class="nt">-a</span> 100 <span class="nt">-f</span> ~/.ssh/bx11-yann-ed25519
</code></pre></div></div>
<h3 id="créer-authorized_keys">Créer authorized_keys</h3>
<p>Insérer les clés publiques SSH requises dans un nouveau fichier local <code class="language-plaintext highlighter-rouge">authorized_keys</code> nommé <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code></p>
<p>Pour SSH sur le port 23 (SCP, SFTP, Rsync et Borg Backup), ajoutez la clé publique SSH au format OpenSSH :</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat</span> .ssh/bx11-yann-ed25519.pub <span class="o">&gt;&gt;</span> storagebox_authorized_keys
</code></pre></div></div>
<p>Maintenant vous devez envoyer le fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> généré vers le compte Storage Box <strong>bx11-yann</strong> <br />
Créer le répertoire <code class="language-plaintext highlighter-rouge">.ssh</code> avec les droits de fichier <code class="language-plaintext highlighter-rouge">0700 (rwx------)</code> et créer le fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> avec les clés SSH publiques et les droits de fichier <code class="language-plaintext highlighter-rouge">0600 (rw-------)</code></p>
<p>Vous pouvez exécuter toutes ses opérations avec la commande suivante, il faut <strong>saisir le mot de passe</strong></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"mkdir .ssh </span><span class="se">\n</span><span class="s2"> chmod 700 .ssh </span><span class="se">\n</span><span class="s2"> put storagebox_authorized_keys .ssh/authorized_keys </span><span class="se">\n</span><span class="s2"> chmod 600 .ssh/authorized_keys"</span> | sftp u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Résultat de la commande</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>The authenticity of host 'u326239.your-storagebox.de (116.202.54.25)' can't be established.
RSA key fingerprint is SHA256:EMlfI8GsRIfpVkoW1H2u0zYVpFGKkIMKHFZIRkf2ioI.
This host key is known by the following other names/addresses:
~/.ssh/known_hosts:109: u277865.your-storagebox.de
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'u326239.your-storagebox.de' (RSA) to the list of known hosts.
u326239@u326239.your-storagebox.de's password:
Connected to u326239.your-storagebox.de.
sftp&gt; mkdir .ssh
sftp&gt; chmod 700 .ssh
Changing mode on /.ssh
sftp&gt; put storagebox_authorized_keys .ssh/authorized_keys
Uploading storagebox_authorized_keys to /.ssh/authorized_keys
storagebox_authorized_keys 100% 94 1.3KB/s 00:00
sftp&gt; chmod 600 .ssh/authorized_keys
Changing mode on /.ssh/authorized_keys
</code></pre></div></div>
<h3 id="modifier-authorized_keys">Modifier authorized_keys</h3>
<p><em>Ajouter une autre clé publique au fichier authorized_keys de la boîte de stockage</em></p>
<p>On télécharge le fichier existant <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage <strong>bx11-yann</strong> dans un fichier local nommé <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"get .ssh/authorized_keys storagebox_authorized_keys"</span> | sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Ajout clé publique</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat</span> <span class="o">&gt;&gt;</span> storagebox_authorized_keys
</code></pre></div></div>
<p>Copier/coller la clé publique dans ce terminal (commande : <code class="language-plaintext highlighter-rouge">cat /root/.ssh/id_borg_ed25519.pub</code>) de la machine à sauvegarder <strong>Yunohost xoyaz.xyz</strong> ), et presser <strong>[Ctrl]+[D]</strong> pour valider.</p>
<p>On renvoie le fichier modifié <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code> dans le fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage <strong>bx11-yann</strong></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"put storagebox_authorized_keys .ssh/authorized_keys"</span> | sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<h3 id="connexion-sftp-sans-mot-de-passe">Connexion SFTP sans mot de passe</h3>
<p>En fonction du format de clé SSH que vous avez téléchargé, vous devriez pouvoir vous connecter sans mot de passe sur le port 23</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Résultat de la commande</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>The authenticity of host '[u326239.your-storagebox.de]:23 ([116.202.54.25]:23)' can't be established.
ED25519 key fingerprint is SHA256:XqONwb1S0zuj5A1CDxpOSuD2hnAArV1A3wKY7Z3sdgM.
This host key is known by the following other names/addresses:
~/.ssh/known_hosts:110: [u277865.your-storagebox.de]:23
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[u326239.your-storagebox.de]:23' (ED25519) to the list of known hosts.
Connected to u326239.your-storagebox.de.
sftp&gt;
</code></pre></div></div>
<p>Saisir <em>quit</em> pour sortir…</p>
<h3 id="filezilla">Filezilla</h3>
<p>Paramétrer filezilla pour une connexion vers la boîte de stockage</p>
<p><img src="/images/bx20-yann01.png" alt="" /><br />
Renseigner avant connexion</p>
<p>Connexion</p>
<p><img src="/images/bx20-yann02.png" alt="" /><br />
Nos dossiers sont dans le /home de la boîte de stockage</p>
<h2 id="borg---yunohost">Borg - Yunohost</h2>
<p><strong>Créer le répertoire pour le référentiel de sauvegarde dans la boîte de stockage</strong>.<br />
Créer un dossier <code class="language-plaintext highlighter-rouge">backup/borg</code><code class="language-plaintext highlighter-rouge">
Sous </code>backup/borg`, vous pouvez ensuite créer dautres répertoires pour les autres serveurs à sauvegarder.</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"mkdir backup </span><span class="se">\n</span><span class="s2"> mkdir backup/borg </span><span class="se">\n</span><span class="s2"> chmod 775 backup/borg"</span> | sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Résultat de la commande</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Connected to u326239.your-storagebox.de.
sftp&gt; mkdir backup
sftp&gt; mkdir backup/borg
sftp&gt; chmod 775 backup/borg
Changing mode on /home/backup/borg
</code></pre></div></div>
<p>Exemple de dépôt Borg pour la sauvegarde du VPS xoyaz.xyz:</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/xoyaz.xyz
</code></pre></div></div>
<p><strong>borg yunohost xoyize.xyz est installé et paramétré pour la boîte de stockag</strong>e<br />
<img src="/images/bx11-002.png" alt="" width="600" /><br />
Dépôt : <code class="language-plaintext highlighter-rouge">ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/xoyaz_xyz</code></p>
<p><em>Ajouter la clé publique borg <code class="language-plaintext highlighter-rouge">ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPuVXP+pUjvedC/htJmKXamAotLESDCRqU0MOoD7vqCA root@422x.l.time4vps.cloud</code> au fichier authorized_keys de la boîte de stockage</em></p>
<h3 id="modifier-authorized_keys-bx11">Modifier authorized_keys bx11</h3>
<p><em>Cette opération va se dérouler sur poste ayant accès à la boîte de stockage avec clés SSH</em></p>
<p>On télécharge le fichier existant <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage <strong>bx11-yann</strong> dans un fichier local nommé <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"get .ssh/authorized_keys storagebox_authorized_keys"</span> | sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Ajout clé publique</p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">cat</span> <span class="o">&gt;&gt;</span> storagebox_authorized_keys
</code></pre></div></div>
<p>Copier/coller la clé publique dans ce terminal (commande : <code class="language-plaintext highlighter-rouge">cat /root/.ssh/id_borg_ed25519.pub</code>) de la machine à sauvegarder <strong>Yunohost xoyize.xyz</strong> ), et presser <strong>[Ctrl]+[D]</strong> pour valider.</p>
<p>On renvoie le fichier modifié <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code> dans le fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage <strong>bx11-yann</strong></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"put storagebox_authorized_keys .ssh/authorized_keys"</span> | sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<h3 id="tester-la-configuration-borg">Tester la configuration borg</h3>
<p>Tester la connexion SSH avec la clé privée borg située sous /root/.ssh</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sftp -P 23 -i /root/.ssh/id_borg__2_ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p class="info">À cette étape, votre sauvegarde devrait se dérouler à lheure prévue (tous les jours à 3h20). Notez que la première sauvegarde peut être très longue, car de nombreuses données doivent être copiées via ssh. Les sauvegardes suivantes sont incrémentielles : seules les données nouvellement générées depuis la dernière sauvegarde seront copiées.</p>
<p>Si vous voulez tester la configuration correcte de Borg Apps avant lheure prévue, vous pouvez lancer une sauvegarde manuellement sur le serveur xoyaz.xyz (cx21) :</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>systemctl start borg
</code></pre></div></div>
<p>Si tout démarre correctement, un message est envoyé<br />
<img src="/images/bx11-003.png" alt="" /></p>
<p>Visualiser les logs en cours sur un autre terminal</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>journalctl -f -u borg
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[...]
Nov 21 18:11:55 xoyaz.xyz sudo[264670]: root : PWD=/ ; USER=root ; COMMAND=/usr/bin/test ! -f /etc/yunohost/apps/my_webapp__2/scripts/backup
Nov 21 18:11:55 xoyaz.xyz sudo[264670]: pam_unix(sudo:session): session opened for user root(uid=0) by (uid=0)
Nov 21 18:11:55 xoyaz.xyz sudo[264670]: pam_unix(sudo:session): session closed for user root
Nov 21 18:11:55 xoyaz.xyz sudo[264672]: root : PWD=/ ; USER=root ; COMMAND=/usr/bin/yunohost backup create -n auto_my_webapp__2 --method borg__2_app --apps my_webapp__2
Nov 21 18:11:55 xoyaz.xyz sudo[264672]: pam_unix(sudo:session): session opened for user root(uid=0) by (uid=0)
Nov 21 18:12:10 xoyaz.xyz sudo[264672]: pam_unix(sudo:session): session closed for user root
Nov 21 18:12:10 xoyaz.xyz sudo[265126]: root : PWD=/ ; USER=root ; COMMAND=/usr/bin/test ! -f /etc/yunohost/apps/nextcloud/scripts/backup
Nov 21 18:12:10 xoyaz.xyz sudo[265126]: pam_unix(sudo:session): session opened for user root(uid=0) by (uid=0)
Nov 21 18:12:10 xoyaz.xyz sudo[265126]: pam_unix(sudo:session): session closed for user root
[...]
</code></pre></div></div>
<p>A la fin de la sauvegarde borg<br />
<img src="/images/bx11-004.png" alt="" /></p>
<p>Avec les apps borg un email est envoyé pour dire si la sauvegarde échoue ou si le repo distant na rien reçu. On peut toutefois analyser manuellement pour sassurer que tout va bien de façon plus complète.</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># Dépôt borg sur storage box : ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/&lt;Nom du dépôt&gt; </span>
<span class="c"># Dépôt borg yunohost : $(yunohost app setting $app repository)</span>
<span class="c"># Lister les fichiers</span>
<span class="nv">app</span><span class="o">=</span>borg<span class="p">;</span> <span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg list <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">"</span> | less
<span class="c"># Lister les exports de base de données</span>
<span class="nv">app</span><span class="o">=</span>borg<span class="p">;</span> <span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg list <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">"</span> | <span class="nb">grep</span> <span class="s2">"(db|dump)</span><span class="se">\.</span><span class="s2">sql"</span>
<span class="c"># Lister les fichiers de l'archive</span>
<span class="nv">app</span><span class="o">=</span>borg<span class="p">;</span> <span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg list <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">::ARCHIVE"</span> | less
<span class="c"># Voir les infos de l'archive</span>
<span class="nv">app</span><span class="o">=</span>borg<span class="p">;</span> <span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg info <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">::ARCHIVE"</span>
<span class="c"># Vérifier l'intégrité des données</span>
<span class="nv">app</span><span class="o">=</span>borg<span class="p">;</span> <span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg check <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">::ARCHIVE"</span> <span class="nt">--verify-data</span>
<span class="c"># Supprimer une archive</span>
<span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> passphrase<span class="si">)</span><span class="s2">"</span> <span class="nv">BORG_RSH</span><span class="o">=</span><span class="s2">"ssh -i /root/.ssh/id_</span><span class="k">${</span><span class="nv">app</span><span class="k">}</span><span class="s2">_ed25519 -oStrictHostKeyChecking=yes "</span> <span class="se">\</span>
borg delete <span class="s2">"</span><span class="si">$(</span>yunohost app setting <span class="nv">$app</span> repository<span class="si">)</span><span class="s2">::ARCHIVE"</span>
</code></pre></div></div>
<h3 id="vérification-sauvegarde-borg">Vérification sauvegarde borg</h3>
<p>Lister les fichiers</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list --short "$(yunohost app setting $app repository)"
</code></pre></div></div>
<p>Résultat</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_auto_conf-2021-10-04_13:56
_auto_data-2021-10-04_13:56
_auto_borg-2021-10-04_13:57
_auto_calibreweb-2021-10-04_13:58
_auto_gitea-2021-10-04_14:03
_auto_librespeed-2021-10-04_14:04
_auto_my_webapp-2021-10-04_14:04
_auto_my_webapp__2-2021-10-04_14:05
_auto_my_webapp__3-2021-10-04_14:05
_auto_nextcloud-2021-10-04_14:06
_auto_rainloop-2021-10-04_14:12
_auto_redirect-2021-10-04_14:13
_auto_redirect__2-2021-10-04_14:13
_auto_shaarli-2021-10-04_14:14
_auto_ttrss-2021-10-04_14:14
</code></pre></div></div>
<h3 id="restaurer">Restaurer</h3>
<p>Si on est dans le cas dune migration ou dune réinstallation, il faut réinstaller borg de la même façon. Si le repo est distant il faut changer la clé publique.</p>
<p>Lister les archives disponibles</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)"
</code></pre></div></div>
<p>Créer les archives tar (une archive par app et partie de système)</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar
</code></pre></div></div>
<h4 id="exemple-restauration-shaarli">Exemple restauration shaarli</h4>
<p>Liste des sauvegardes “shaarli”</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg list "$(yunohost app setting $app repository)" |grep "shaarli"
</code></pre></div></div>
<p>On veut restaurer lapplication “shaarli” du 23 juillet (_auto_shaarli-2022-07-23_02:25)</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 " borg export-tar "$(yunohost app setting $app repository)::_auto_shaarli-2022-07-23_02:25" /home/yunohost.backup/archives/_auto_shaarli-2022-07-23_02:25.tar.gz
</code></pre></div></div>
<p>Désinstaller lapplication existante</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>yunohost app remove shaarli
</code></pre></div></div>
<p>Puis restaurer larchive de façon classique.</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>yunohost backup restore _auto_shaarli-2022-07-23_02:25.tar.gz --apps
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Info: Preparing archive for restoration...
Info: Restoring shaarli...
Info: [+...................] &gt; Loading installation settings...
Info: [#++.................] &gt; Validating restoration parameters...
Info: [###++...............] &gt; Restoring the NGINX configuration...
Info: [#####++.............] &gt; Recreating the dedicated system user...
Info: [#######++...........] &gt; Restoring the app main directory...
Info: [#########+..........] &gt; Restoring the PHP-FPM configuration...
Info: [##########++........] &gt; Reinstalling dependencies...
Info: [############++......] &gt; Restoring the logrotate configuration...
Info: [##############++....] &gt; Restoring the Fail2Ban configuration...
Info: [################++..] &gt; Reloading NGINX web server and PHP-FPM...
Info: [##################++] &gt; Restoration completed for shaarli
Success! Restoration completed
apps:
shaarli: Success
system:
</code></pre></div></div>
<h4 id="restaurer-des-grosses-archives">Restaurer des grosses archives</h4>
<p>Si lespace disponible est inférieur au poids de votre archive, des données décompressées et des dépendances, vous devrez restaurer partie par partie, app par app.</p>
<p>Si restaurer app par app ne suffit pas OU si une archive est trop grosse, il peut être judicieux de générer une archive tar sans les “grosses” données dune app comme si elle avait été générée avec l<a href="/backup/include_exclude_files#ne-pas-sauvegarder-les-grosses-quantites-de-donnees">option BACKUP_CORE_ONLY</a>. Exemple avec Nextcloud:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg export-tar -e apps/nextcloud/backup/home/yunohost.app "$(yunohost app setting $app repository)::ARCHIVE" /home/yunohost/archives/ARCHIVE.tar
</code></pre></div></div>
<p>Il faudra ensuite extraire ces données directement avec borg</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd /home/yunohost.app/
app=borg; BORG_PASSPHRASE="$(yunohost app setting $app passphrase)" BORG_RSH="ssh -i /root/.ssh/id_${app}_ed25519 -oStrictHostKeyChecking=yes " borg extract "$(yunohost app setting $app repository)::ARCHIVE" apps/nextcloud/backup/home/yunohost.app/
mv apps/nextcloud/backup/home/yunohost.app/nextcloud ./
rm -r apps
</code></pre></div></div>
<p>Puis restaurer de façon classique</p>
<h2 id="borg---laptop-dell-e6230">Borg - Laptop Dell e6230</h2>
<h3 id="installer-borg">Installer borg</h3>
<p>Installer les paquets suivants</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo pacman -S borg fuse python-llfuse
</code></pre></div></div>
<p>Passer en mode su</p>
<p>Créer une clé SSH pour lauthentification borg</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -t ed25519 -f /root/.ssh/id_borg_ed25519
</code></pre></div></div>
<p>Validez en appuyant sur la touche « Entrée » à toutes les questions</p>
<p>Vous devriez maintenant avoir une clé privée contenue dans le fichier <code class="language-plaintext highlighter-rouge">/root/.ssh/id_borg_ed25519</code>, et une clé publique contenue dans le fichier <code class="language-plaintext highlighter-rouge">/root/.ssh/id_borg_ed25519.pub</code>
La clé privée ne doit jamais être partagée.</p>
<h3 id="clé-publique-borg">Clé publique borg</h3>
<p><strong>Ajouter une autre clé publique</strong> au fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage</p>
<p><u>Depuis un poste ayant un accès à la boîte de stockage</u><br />
On télécharge le fichier existant authorized_keys de la boîte de stockage bx11-yann dans un fichier local nommé <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>echo -e "get .ssh/authorized_keys storagebox_authorized_keys" | sftp -P 23 -i ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Ajout clé publique</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cat &gt;&gt; storagebox_authorized_keys
</code></pre></div></div>
<p>Copier/coller la clé publique dans ce terminal (commande : cat /root/.ssh/id_borg_ed25519.pub) du portable Lenovo e6230 ), et presser [Ctrl]+[D] pour valider.</p>
<p>On renvoie le fichier modifié storagebox_authorized_keys dans le fichier authorized_keys de la boîte de stockage bx11-yann</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>echo -e "put storagebox_authorized_keys .ssh/authorized_keys" | sftp -P 23 -i ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<h3 id="tester-connexion-ssh">Tester connexion SSH</h3>
<p>Tester la connexion SSH à la boîte de stockage</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sftp -P 23 -i /root/.ssh/id_borg_ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>The authenticity of host '[u326239.your-storagebox.de]:23 ([167.235.97.31]:23)' can't be established.
ED25519 key fingerprint is SHA256:XqONwb1S0zuj5A1CDxpOSuD2hnAArV1A3wKY7Z3sdgM.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[u326239.your-storagebox.de]:23' (ED25519) to the list of known hosts.
Connected to u326239.your-storagebox.de.
sftp&gt; quit
</code></pre></div></div>
<h3 id="initialisation-dépôt-repository">Initialisation Dépôt (repository)</h3>
<p><strong>Dépôt (repository)</strong>.Les dépôts de la boîte de stockage sont sous ./backup/borg/</p>
<p>on va maintenant travailler sur un dépôt distant à travers SSH, il va falloir fournir le chemin du dépôt sous la forme dune URL avec un peu plus dinformations</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/e6230
</code></pre></div></div>
<p>phrase forte (passphrase)</p>
<p>Ajout de la phrase forte dans un fichier au dossier <code class="language-plaintext highlighter-rouge">/root/.borg</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mkdir -p /root/.borg
# ajout phrase
echo "&lt;La phrase de passe forte&gt;" &gt; /root/.borg/rnmkcy_eu.passphrase
</code></pre></div></div>
<p><strong>Initialisation dépôt distant</strong></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>export BORG_PASSPHRASE="$(cat /root/.borg/e6230.passphrase)"
export BORG_RSH='ssh -i /root/.ssh/id_borg_ed25519'
BORG_REPOSITORY="$(cat /root/.borg/e6230.repository)"
borg init --encryption=repokey $BORG_REPOSITORY
</code></pre></div></div>
<h3 id="script-de-sauvegarde">Script de sauvegarde</h3>
<p>Créer un fichier dexclusion <code class="language-plaintext highlighter-rouge">/root/.borg/exclusions</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/proc
/sys
/dev
/media
/mnt
/cdrom
/tmp
/run
/var/tmp
/var/run
/var/cache
/swapfile
lost+found
/home/yano/.cache
/home/yano/Téléchargements
/home/yano/Musique
/home/yano/Vidéos
/home/yano/temp
/home/yano/vps
/home/yano/FreeUSB2To
/home/yano/virtuel
/home/yano/media
/home/yano/scripts
/home/yano/.keepassx
</code></pre></div></div>
<p>Script à exécuter en mode su : <code class="language-plaintext highlighter-rouge">/root/.borg/borg-backup.sh</code></p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">#!/bin/sh</span>
<span class="c">#</span>
<span class="c"># Script de sauvegarde.</span>
<span class="c">#</span>
<span class="c"># Envoie les sauvegardes sur un serveur distant, via le programme Borg.</span>
<span class="c"># Les sauvegardes sont chiffrées</span>
<span class="c">#</span>
<span class="nv">flag</span><span class="o">=</span><span class="s2">"/var/tmp/</span><span class="si">$(</span><span class="nb">basename</span> <span class="nt">--</span> <span class="nv">$0</span><span class="si">)</span><span class="s2">.flag"</span>
<span class="k">if</span> <span class="o">[</span> <span class="nt">-e</span> <span class="s2">"</span><span class="nv">$flag</span><span class="s2">"</span> <span class="o">]</span> <span class="p">;</span><span class="k">then
</span><span class="nb">echo</span> <span class="s2">"flag : </span><span class="nv">$flag</span><span class="s2">"</span>
<span class="k">if</span> <span class="o">[</span> <span class="s2">"</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">"</span> <span class="o">==</span> <span class="s2">"</span><span class="si">$(</span><span class="nb">date</span> +%F <span class="nt">-r</span> <span class="nv">$flag</span><span class="si">)</span><span class="s2">"</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="c"># script déjà exécuté 1 fois aujourd'hui, on sort</span>
<span class="nb">echo</span> <span class="s2">"script </span><span class="nv">$0</span><span class="s2"> déjà exécuté ce jour(</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">)"</span>
<span class="nb">echo</span> <span class="s2">"script </span><span class="nv">$0</span><span class="s2"> déjà exécuté ce jour(</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">)"</span> | systemd-cat <span class="nt">-t</span> sauvegardes <span class="nt">-p</span> info
<span class="c"># Envoi notification</span>
<span class="c"># DISPLAY=:0 notify-send "$0" "déjà exécuté ce jour\n($flag)" -i /root/.borg/information.png -t 10000</span>
<span class="nb">exit </span>0
<span class="k">fi
else
</span><span class="nb">touch</span> <span class="s2">"</span><span class="nv">$flag</span><span class="s2">"</span>
<span class="k">fi
</span><span class="nb">set</span> <span class="nt">-e</span>
<span class="nv">LOG_PATH</span><span class="o">=</span>/var/log/borg-backup.log
<span class="nb">export </span><span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="si">$(</span><span class="nb">cat</span> /root/.borg/e6230.passphrase<span class="si">)</span>
<span class="nb">export </span><span class="nv">BORG_RSH</span><span class="o">=</span><span class="s1">'ssh -i /root/.ssh/id_borg_ed25519'</span>
<span class="nb">export </span><span class="nv">BORG_RELOCATED_REPO_ACCESS_IS_OK</span><span class="o">=</span><span class="nb">yes
</span><span class="nv">BACKUP_DATE</span><span class="o">=</span><span class="sb">`</span><span class="nb">date</span> +%Y-%m-%d-%Hh%M<span class="sb">`</span>
<span class="nv">BORG_REPOSITORY</span><span class="o">=</span><span class="si">$(</span><span class="nb">cat</span> /root/.borg/e6230.repository<span class="si">)</span>
<span class="nb">nice</span> <span class="nt">-n</span> 19 ionice <span class="nt">-c</span> 3 borg create <span class="se">\</span>
<span class="nt">-v</span> <span class="nt">--progress</span> <span class="nt">--stats</span> <span class="se">\</span>
<span class="nt">--exclude-from</span> /root/.borg/exclusions <span class="se">\</span>
<span class="k">${</span><span class="nv">BORG_REPOSITORY</span><span class="k">}</span>::<span class="k">${</span><span class="nv">BACKUP_DATE</span><span class="k">}</span> <span class="se">\</span>
/ <span class="se">\</span>
<span class="o">&gt;&gt;</span> <span class="k">${</span><span class="nv">LOG_PATH</span><span class="k">}</span> 2&gt;&amp;1
<span class="c"># Nettoyage des anciens backups</span>
<span class="c"># On conserve</span>
<span class="c"># - une archive par jour les 7 derniers jours,</span>
<span class="c"># - une archive par semaine pour les 4 dernières semaines,</span>
<span class="c"># - une archive par mois pour les 6 derniers mois.</span>
borg prune <span class="se">\</span>
<span class="nt">-v</span> <span class="nt">--list</span> <span class="nt">--stats</span> <span class="nt">--keep-daily</span><span class="o">=</span>7 <span class="nt">--keep-weekly</span><span class="o">=</span>4 <span class="nt">--keep-monthly</span><span class="o">=</span>6 <span class="se">\</span>
<span class="nv">$BORG_REPOSITORY</span> <span class="se">\</span>
<span class="o">&gt;&gt;</span> <span class="k">${</span><span class="nv">LOG_PATH</span><span class="k">}</span> 2&gt;&amp;1
</code></pre></div></div>
<h3 id="exécution-script-au-boot-après-3-min">Exécution script au boot après 3 min</h3>
<p>On va utiliser la fonction timer de systemd en créant 2 fichier de même nom et suffixes différents</p>
<p>Le service</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/etc/systemd/system/run-script-with-delay.service
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[Unit]
Description=Lancer script au démarrage
[Service]
Type=oneshot
ExecStart=/root/.borg/borg-backup.sh
TimeoutStartSec=0
</code></pre></div></div>
<p>Le timer</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/etc/systemd/system/run-script-with-delay.timer
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>[Unit]
Description="Lancer script au démarrage après 3min"
[Timer]
OnBootSec=3min
[Install]
WantedBy=default.target
</code></pre></div></div>
<p>Rafraîchir la configuration systemd</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl daemon-reload
</code></pre></div></div>
<p>Activer le timer</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo systemctl enable run-script-with-delay.timer
</code></pre></div></div>
<h2 id="borgbackup---xoyizenet">BorgBackup - xoyize.net</h2>
<p><em>Sauvegarde borg dans une boîte de stockage</em></p>
<p>Passer en mode su</p>
<h3 id="installer-borg-1">Installer borg</h3>
<p>Installer borg</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt install borgbackup
</code></pre></div></div>
<p>Créer une clé SSH pour lauthentification borg</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -t ed25519 -f /root/.ssh/id_borg_ed25519
</code></pre></div></div>
<p>Validez en appuyant sur la touche « Entrée » à toutes les questions</p>
<p>Vous devriez maintenant avoir une clé privée contenue dans le fichier <code class="language-plaintext highlighter-rouge">/root/.ssh/id_borg_ed25519</code>, et une clé publique contenue dans le fichier <code class="language-plaintext highlighter-rouge">/root/.ssh/id_borg_ed25519.pub</code>
La clé privée ne doit jamais être partagée.</p>
<h3 id="clé-publique-borg-1">Clé publique borg</h3>
<p><strong>Ajouter une autre clé publique</strong> au fichier <code class="language-plaintext highlighter-rouge">authorized_keys</code> de la boîte de stockage</p>
<p><u>Depuis un poste ayant un accès à la boîte de stockage</u><br />
On télécharge le fichier existant authorized_keys de la boîte de stockage bx11-yann dans un fichier local nommé <code class="language-plaintext highlighter-rouge">storagebox_authorized_keys</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>echo -e "get .ssh/authorized_keys storagebox_authorized_keys" | sftp -P 23 -i ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p>Ajout clé publique</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cat &gt;&gt; storagebox_authorized_keys
</code></pre></div></div>
<p>Copier/coller la clé publique dans ce terminal (commande : <code class="language-plaintext highlighter-rouge">cat /root/.ssh/id_borg_ed25519.pub</code>) du VPS Contabo debian 12 xoyize.net ), et presser [Ctrl]+[D] pour valider.</p>
<p>On renvoie le fichier modifié storagebox_authorized_keys dans le fichier authorized_keys de la boîte de stockage bx11-yann</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>echo -e "put storagebox_authorized_keys .ssh/authorized_keys" | sftp -P 23 -i ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<h3 id="tester-connexion-ssh-depuis-le-vps">Tester connexion SSH depuis le VPS</h3>
<p>Tester la connexion SSH à la boîte de stockage</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sftp -P 23 -i /root/.ssh/id_borg_ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>The authenticity of host '[u326239.your-storagebox.de]:23 ([2a01:4f8:261:59d3::2]:23)' can't be established.
ED25519 key fingerprint is SHA256:XqONwb1S0zuj5A1CDxpOSuD2hnAArV1A3wKY7Z3sdgM.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[u326239.your-storagebox.de]:23' (ED25519) to the list of known hosts.
Connected to u326239.your-storagebox.de.
sftp&gt; quit
</code></pre></div></div>
<p>Création dossier pour les paramètres de borg</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mkdir -p /root/.borg
</code></pre></div></div>
<h3 id="initialisation-dépôt-repository-1">Initialisation Dépôt (repository)</h3>
<p><strong>Dépôt (repository)</strong>.Les dépôts de la boîte de stockage sont sous ./backup/borg/</p>
<p>on va maintenant travailler sur un dépôt distant à travers SSH, il va falloir fournir le chemin du dépôt sous la forme dune URL</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code># dépôt distant
echo "ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/xoyize.net" &gt; /root/.borg/xoyize.net.repository
</code></pre></div></div>
<p>phrase forte (passphrase)</p>
<p>Ajout de la phrase forte dans un fichier au dossier <code class="language-plaintext highlighter-rouge">/root/.borg</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code># ajout phrase
echo "&lt;La phrase de passe forte&gt;" &gt; /root/.borg/xoyize.net.passphrase
</code></pre></div></div>
<p><strong>Initialisation dépôt distant</strong></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>export BORG_PASSPHRASE="$(cat /root/.borg/xoyize.net.passphrase)"
export BORG_RSH='ssh -i /root/.ssh/id_borg_ed25519'
BORG_REPOSITORY="$(cat /root/.borg/xoyize.net.repository)"
borg init --encryption=repokey $BORG_REPOSITORY
</code></pre></div></div>
<p>Si tout se passe bien, vous aurez le message suivant</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>By default repositories initialized with this version will produce security
errors if written to with an older version (up to and including Borg 1.0.8).
If you want to use these older versions, you can disable the check by running:
borg upgrade --disable-tam ssh://u326239@u326239.your-storagebox.de:23/./backup/borg/xoyize.net
See https://borgbackup.readthedocs.io/en/stable/changes.html#pre-1-0-9-manifest-spoofing-vulnerability for details about the security implications.
IMPORTANT: you will need both KEY AND PASSPHRASE to access this repo!
If you used a repokey mode, the key is stored in the repo, but you should back it up separately.
Use "borg key export" to export the key, optionally in printable format.
Write down the passphrase. Store both at safe place(s).
</code></pre></div></div>
<h3 id="script-de-sauvegarde-1">Script de sauvegarde</h3>
<p>Créer un fichier dexclusion <code class="language-plaintext highlighter-rouge">/root/.borg/exclusions</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/proc
/sys
/dev
/media
/mnt
/tmp
/run
/var/tmp
/var/run
/var/cache
lost+found
</code></pre></div></div>
<p>Script à exécuter en mode su : <code class="language-plaintext highlighter-rouge">/root/.borg/borg-backup.sh</code></p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">#!/bin/sh</span>
<span class="c">#</span>
<span class="c"># Script de sauvegarde.</span>
<span class="c">#</span>
<span class="c"># Envoie les sauvegardes sur un serveur distant, via le programme Borg.</span>
<span class="c"># Les sauvegardes sont chiffrées</span>
<span class="c">#</span>
<span class="nv">flag</span><span class="o">=</span><span class="s2">"/var/tmp/</span><span class="si">$(</span><span class="nb">basename</span> <span class="nt">--</span> <span class="nv">$0</span><span class="si">)</span><span class="s2">.flag"</span>
<span class="k">if</span> <span class="o">[</span> <span class="nt">-e</span> <span class="s2">"</span><span class="nv">$flag</span><span class="s2">"</span> <span class="o">]</span> <span class="p">;</span><span class="k">then
</span><span class="nb">echo</span> <span class="s2">"flag : </span><span class="nv">$flag</span><span class="s2">"</span>
<span class="k">if</span> <span class="o">[</span> <span class="s2">"</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">"</span> <span class="o">==</span> <span class="s2">"</span><span class="si">$(</span><span class="nb">date</span> +%F <span class="nt">-r</span> <span class="nv">$flag</span><span class="si">)</span><span class="s2">"</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
<span class="c"># script déjà exécuté 1 fois aujourd'hui, on sort</span>
<span class="nb">echo</span> <span class="s2">"script </span><span class="nv">$0</span><span class="s2"> déjà exécuté ce jour(</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">)"</span>
<span class="nb">echo</span> <span class="s2">"script </span><span class="nv">$0</span><span class="s2"> déjà exécuté ce jour(</span><span class="si">$(</span><span class="nb">date</span> +%F<span class="si">)</span><span class="s2">)"</span> | systemd-cat <span class="nt">-t</span> sauvegardes <span class="nt">-p</span> info
<span class="c"># Envoi notification</span>
<span class="c"># DISPLAY=:0 notify-send "$0" "déjà exécuté ce jour\n($flag)" -i /root/.borg/information.png -t 10000</span>
<span class="nb">exit </span>0
<span class="k">fi
else
</span><span class="nb">touch</span> <span class="s2">"</span><span class="nv">$flag</span><span class="s2">"</span>
<span class="k">fi
</span><span class="nb">set</span> <span class="nt">-e</span>
<span class="nv">LOG_PATH</span><span class="o">=</span>/var/log/borg-backup.log
<span class="nb">export </span><span class="nv">BORG_PASSPHRASE</span><span class="o">=</span><span class="si">$(</span><span class="nb">cat</span> /root/.borg/xoyize.net.passphrase<span class="si">)</span>
<span class="nb">export </span><span class="nv">BORG_RSH</span><span class="o">=</span><span class="s1">'ssh -i /root/.ssh/id_borg_ed25519'</span>
<span class="nb">export </span><span class="nv">BORG_RELOCATED_REPO_ACCESS_IS_OK</span><span class="o">=</span><span class="nb">yes
</span><span class="nv">BACKUP_DATE</span><span class="o">=</span><span class="sb">`</span><span class="nb">date</span> +%Y-%m-%d-%Hh%M<span class="sb">`</span>
<span class="nv">BORG_REPOSITORY</span><span class="o">=</span><span class="si">$(</span><span class="nb">cat</span> /root/.borg/xoyize.net.repository<span class="si">)</span>
<span class="nb">nice</span> <span class="nt">-n</span> 19 ionice <span class="nt">-c</span> 3 borg create <span class="se">\</span>
<span class="nt">-v</span> <span class="nt">--progress</span> <span class="nt">--stats</span> <span class="se">\</span>
<span class="nt">--exclude-from</span> /root/.borg/exclusions <span class="se">\</span>
<span class="k">${</span><span class="nv">BORG_REPOSITORY</span><span class="k">}</span>::<span class="k">${</span><span class="nv">BACKUP_DATE</span><span class="k">}</span> <span class="se">\</span>
/ <span class="se">\</span>
<span class="o">&gt;&gt;</span> <span class="k">${</span><span class="nv">LOG_PATH</span><span class="k">}</span> 2&gt;&amp;1
<span class="c"># Nettoyage des anciens backups</span>
<span class="c"># On conserve</span>
<span class="c"># - une archive par jour les 7 derniers jours,</span>
<span class="c"># - une archive par semaine pour les 4 dernières semaines,</span>
<span class="c"># - une archive par mois pour les 6 derniers mois.</span>
borg prune <span class="se">\</span>
<span class="nt">-v</span> <span class="nt">--list</span> <span class="nt">--stats</span> <span class="nt">--keep-daily</span><span class="o">=</span>7 <span class="nt">--keep-weekly</span><span class="o">=</span>4 <span class="nt">--keep-monthly</span><span class="o">=</span>6 <span class="se">\</span>
<span class="nv">$BORG_REPOSITORY</span> <span class="se">\</span>
<span class="o">&gt;&gt;</span> <span class="k">${</span><span class="nv">LOG_PATH</span><span class="k">}</span> 2&gt;&amp;1
</code></pre></div></div>
<p>Le rendre exécutable</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>chmod +x /root/.borg/borg-backup.sh
</code></pre></div></div>
<h3 id="exécution-script-tous-les-jours">Exécution script tous les jours</h3>
<p>On va utiliser cron</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>crontab -e
</code></pre></div></div>
<p>Ajouter la ligne suivante</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>15 2 * * * /root/.borg/borg-backup.sh
</code></pre></div></div>
<p>Script exécuté tous les jours à 2h15</p>
2024-11-07 22:37:17 +01:00
<h2 id="sftp">SFTP</h2>
<h3 id="taille-du-dossier">Taille du dossier</h3>
<p>Pour afficher la taille du dossier via SFTP</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="s2">"df -h"</span> |sftp <span class="nt">-P</span> 23 <span class="nt">-i</span> ~/.ssh/bx11-yann-ed25519 u326239@u326239.your-storagebox.de
</code></pre></div></div>
<p><img src="/images/sftp-df.png" alt="" /></p>
<h3 id="commandes">Commandes</h3>
<p><em>SFTP ou Secure File Transfer Protocol est un utilitaire de transfert de fichiers à distance sécurisé basé sur le protocole de transfert de fichiers FTP. <a href="https://geekflare.com/fr/sftp-command-examples/">(15 Exemples de commandes SFTP sous Linux)</a></em></p>
<p>Pour télécharger un fichier à partir dun serveur distant, utilisez la syntaxe de commande suivante :
<code class="language-plaintext highlighter-rouge">$ sftp {utilisateur}@{hôte distant}:{nom-de-fichier-distant} {nom-de-fichier-local}</code></p>
<p>Connexion serveur SFTP avec clef<br />
<code class="language-plaintext highlighter-rouge">sftp -P {Port} -i {nom-de-fichier-clef} {utilisateur}@{hôte distant}</code></p>
<p>Pour obtenir de laide sur les commandes disponibles et la syntaxe de SFTP, utilisez <code class="language-plaintext highlighter-rouge">?</code> ou <code class="language-plaintext highlighter-rouge">help</code></p>
<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sftp&gt; ?
Commandes disponibles :
bye Quitter sftp
<span class="nb">cd </span>chemin Changer le répertoire distant en <span class="s2">"chemin"</span>
<span class="nb">chgrp</span> <span class="o">[</span><span class="nt">-h</span><span class="o">]</span> grp path Change le groupe <span class="nb">du </span>fichier <span class="s1">'path'</span> en <span class="s1">'grp'</span>
<span class="nb">chmod</span> <span class="o">[</span><span class="nt">-h</span><span class="o">]</span> mode chemin Changer les permissions <span class="nb">du </span>fichier <span class="s1">'chemin'</span> en <span class="s1">'mode'</span>
<span class="nb">chown</span> <span class="o">[</span><span class="nt">-h</span><span class="o">]</span> own chemin Changer le propriétaire <span class="nb">du </span>fichier <span class="s1">'chemin'</span> en <span class="s1">'own'</span>
<span class="nb">df</span> <span class="o">[</span><span class="nt">-hi</span><span class="o">]</span> &lt;x&gt;&lt;x&gt;[chemin]&lt;/x&gt;&lt;/x&gt; Affiche les statistiques <span class="nb">du </span>répertoire ou <span class="nb">du </span>système de
répertoire ou <span class="nb">du </span>système de fichiers contenant <span class="s1">'path'</span>
<span class="nb">exit </span>Quitter sftp
get <span class="o">[</span><span class="nt">-afpR</span><span class="o">]</span> remote &lt;x&gt;[local]&lt;/x&gt; Télécharger un fichier
<span class="nb">help </span>Affiche ce texte d<span class="s1">'aide
lcd path Modifier le répertoire local en '</span>path<span class="s1">'
lls [ls-options &lt;x&gt;&lt;x&gt;[path]]&lt;/x&gt;&lt;/x&gt; Affiche la liste du répertoire local
lmkdir path Créer un répertoire local
ln [-s] oldpath newpath Lier un fichier distant (-s pour un lien symbolique)
lpwd Imprimer le répertoire de travail local
ls [-1afhlnrSt] &lt;x&gt;&lt;x&gt;[path]&lt;/x&gt;&lt;/x&gt; Afficher la liste des répertoires distants
lumask umask Définir l'</span><span class="nb">umask local </span>à <span class="s1">'umask'</span>
<span class="nb">mkdir </span>path Créer un répertoire distant
progress Basculer l<span class="s1">'affichage de l'</span>indicateur de progression
put <span class="o">[</span><span class="nt">-afpR</span><span class="o">]</span> <span class="nb">local</span> &lt;x&gt;[remote]&lt;/x&gt; Télécharger un fichier
<span class="nb">pwd </span>Afficher le répertoire de travail distant
quit Quitter sftp
reget <span class="o">[</span><span class="nt">-fpR</span><span class="o">]</span> remote &lt;x&gt;[local]&lt;/x&gt; Reprendre le téléchargement <span class="nb">du </span>fichier
rename oldpath newpath Renommer le fichier distant
reput <span class="o">[</span><span class="nt">-fpR</span><span class="o">]</span> <span class="nb">local</span> &lt;x&gt;[remote]&lt;/x&gt; Reprendre le téléchargement <span class="nb">du </span>fichier
<span class="nb">rm </span>path Supprimer le fichier distant
<span class="nb">rmdir </span>path Supprimer le répertoire distant
symlink oldpath newpath Symlink fichier distant
version Affiche la version SFTP
<span class="o">!</span><span class="nb">command </span>Exécuter <span class="s1">'command'</span> dans l<span class="s1">'interpréteur de commandes local
! Echapper à l'</span>interpréteur de commandes <span class="nb">local</span>
? Synonyme de <span class="nb">help
</span>sftp&gt;
</code></pre></div></div>
2024-10-31 20:18:37 +01:00
</div>
<div class="d-print-none"><footer class="article__footer"><meta itemprop="dateModified" content="2023-10-31T00:00:00+01:00"><!-- start custom article footer snippet -->
<!-- end custom article footer snippet -->
<!--
<div align="right"><a type="application/rss+xml" href="/feed.xml" title="S'abonner"><i class="fa fa-rss fa-2x"></i></a>
&emsp;</div>
-->
</footer>
<div class="article__section-navigator clearfix"><div class="previous"><span>PRÉCÉDENT</span><a href="/2023/10/27/LibreTranslate.html">LibreTranslate API de traduction</a></div><div class="next"><span>SUIVANT</span><a href="/2023/11/03/Archlinux-PACMAN_Liste_des_paquets_installes_et_reinstallation.html">PACMAN Créer une liste des paquets installés et les installer plus tard dans Arch Linux</a></div></div></div>
</div>
<script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
$(function() {
var $this ,$scroll;
var $articleContent = $('.js-article-content');
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
var scroll = hasSidebar ? '.js-page-main' : 'html, body';
$scroll = $(scroll);
$articleContent.find('.highlight').each(function() {
$this = $(this);
$this.attr('data-lang', $this.find('code').attr('data-lang'));
});
$articleContent.find('h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]').each(function() {
$this = $(this);
$this.append($('<a class="anchor d-print-none" aria-hidden="true"></a>').html('<i class="fas fa-anchor"></i>'));
});
$articleContent.on('click', '.anchor', function() {
$scroll.scrollToAnchor('#' + $(this).parent().attr('id'), 400);
});
});
});
})();
</script>
</div><section class="page__comments d-print-none"></section></article><!-- start custom main bottom snippet -->
<!-- end custom main bottom snippet -->
</div>
</div></div></div></div>
</div><script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
var $body = $('body'), $window = $(window);
var $pageRoot = $('.js-page-root'), $pageMain = $('.js-page-main');
var activeCount = 0;
function modal(options) {
var $root = this, visible, onChange, hideWhenWindowScroll = false;
var scrollTop;
function setOptions(options) {
var _options = options || {};
visible = _options.initialVisible === undefined ? false : show;
onChange = _options.onChange;
hideWhenWindowScroll = _options.hideWhenWindowScroll;
}
function init() {
setState(visible);
}
function setState(isShow) {
if (isShow === visible) {
return;
}
visible = isShow;
if (visible) {
activeCount++;
scrollTop = $(window).scrollTop() || $pageMain.scrollTop();
$root.addClass('modal--show');
$pageMain.scrollTop(scrollTop);
activeCount === 1 && ($pageRoot.addClass('show-modal'), $body.addClass('of-hidden'));
hideWhenWindowScroll && window.hasEvent('touchstart') && $window.on('scroll', hide);
$window.on('keyup', handleKeyup);
} else {
activeCount > 0 && activeCount--;
$root.removeClass('modal--show');
$window.scrollTop(scrollTop);
activeCount === 0 && ($pageRoot.removeClass('show-modal'), $body.removeClass('of-hidden'));
hideWhenWindowScroll && window.hasEvent('touchstart') && $window.off('scroll', hide);
$window.off('keyup', handleKeyup);
}
onChange && onChange(visible);
}
function show() {
setState(true);
}
function hide() {
setState(false);
}
function handleKeyup(e) {
// Char Code: 27 ESC
if (e.which === 27) {
hide();
}
}
setOptions(options);
init();
return {
show: show,
hide: hide,
$el: $root
};
}
$.fn.modal = modal;
});
})();
</script><div class="modal modal--overflow page__search-modal d-print-none js-page-search-modal"><script>
(function () {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
// search panel
var search = (window.search || (window.search = {}));
var useDefaultSearchBox = window.useDefaultSearchBox === undefined ?
true : window.useDefaultSearchBox ;
var $searchModal = $('.js-page-search-modal');
var $searchToggle = $('.js-search-toggle');
var searchModal = $searchModal.modal({ onChange: handleModalChange, hideWhenWindowScroll: true });
var modalVisible = false;
search.searchModal = searchModal;
var $searchBox = null;
var $searchInput = null;
var $searchClear = null;
function getModalVisible() {
return modalVisible;
}
search.getModalVisible = getModalVisible;
function handleModalChange(visible) {
modalVisible = visible;
if (visible) {
search.onShow && search.onShow();
useDefaultSearchBox && $searchInput[0] && $searchInput[0].focus();
} else {
search.onShow && search.onHide();
useDefaultSearchBox && $searchInput[0] && $searchInput[0].blur();
setTimeout(function() {
useDefaultSearchBox && ($searchInput.val(''), $searchBox.removeClass('not-empty'));
search.clear && search.clear();
window.pageAsideAffix && window.pageAsideAffix.refresh();
}, 400);
}
}
$searchToggle.on('click', function() {
modalVisible ? searchModal.hide() : searchModal.show();
});
// Char Code: 83 S, 191 /
$(window).on('keyup', function(e) {
if (!modalVisible && !window.isFormElement(e.target || e.srcElement) && (e.which === 83 || e.which === 191)) {
modalVisible || searchModal.show();
}
});
if (useDefaultSearchBox) {
$searchBox = $('.js-search-box');
$searchInput = $searchBox.children('input');
$searchClear = $searchBox.children('.js-icon-clear');
search.getSearchInput = function() {
return $searchInput.get(0);
};
search.getVal = function() {
return $searchInput.val();
};
search.setVal = function(val) {
$searchInput.val(val);
};
$searchInput.on('focus', function() {
$(this).addClass('focus');
});
$searchInput.on('blur', function() {
$(this).removeClass('focus');
});
$searchInput.on('input', window.throttle(function() {
var val = $(this).val();
if (val === '' || typeof val !== 'string') {
search.clear && search.clear();
} else {
$searchBox.addClass('not-empty');
search.onInputNotEmpty && search.onInputNotEmpty(val);
}
}, 400));
$searchClear.on('click', function() {
$searchInput.val(''); $searchBox.removeClass('not-empty');
search.clear && search.clear();
});
}
});
})();
</script><div class="search search--dark">
<div class="main">
<div class="search__header">Recherche</div>
<div class="search-bar">
<div class="search-box js-search-box">
<div class="search-box__icon-search"><i class="fas fa-search"></i></div>
<input id="search-input" type="text" />
<div class="search-box__icon-clear js-icon-clear">
<a><i class="fas fa-times"></i></a>
</div>
</div>
<button class="button button--theme-dark button--pill search__cancel js-search-toggle">
Annuler</button>
</div>
<div id="results-container" class="search-result js-search-result"></div>
</div>
</div>
<!-- Script pointing to search-script.js -->
<script>/*!
* Simple-Jekyll-Search
* Copyright 2015-2020, Christian Fei
* Licensed under the MIT License.
*/
(function(){
'use strict'
var _$Templater_7 = {
compile: compile,
setOptions: setOptions
}
const options = {}
options.pattern = /\{(.*?)\}/g
options.template = ''
options.middleware = function () {}
function setOptions (_options) {
options.pattern = _options.pattern || options.pattern
options.template = _options.template || options.template
if (typeof _options.middleware === 'function') {
options.middleware = _options.middleware
}
}
function compile (data) {
return options.template.replace(options.pattern, function (match, prop) {
const value = options.middleware(prop, data[prop], options.template)
if (typeof value !== 'undefined') {
return value
}
return data[prop] || match
})
}
'use strict';
function fuzzysearch (needle, haystack) {
var tlen = haystack.length;
var qlen = needle.length;
if (qlen > tlen) {
return false;
}
if (qlen === tlen) {
return needle === haystack;
}
outer: for (var i = 0, j = 0; i < qlen; i++) {
var nch = needle.charCodeAt(i);
while (j < tlen) {
if (haystack.charCodeAt(j++) === nch) {
continue outer;
}
}
return false;
}
return true;
}
var _$fuzzysearch_1 = fuzzysearch;
'use strict'
/* removed: const _$fuzzysearch_1 = require('fuzzysearch') */;
var _$FuzzySearchStrategy_5 = new FuzzySearchStrategy()
function FuzzySearchStrategy () {
this.matches = function (string, crit) {
return _$fuzzysearch_1(crit.toLowerCase(), string.toLowerCase())
}
}
'use strict'
var _$LiteralSearchStrategy_6 = new LiteralSearchStrategy()
function LiteralSearchStrategy () {
this.matches = function (str, crit) {
if (!str) return false
str = str.trim().toLowerCase()
crit = crit.trim().toLowerCase()
return crit.split(' ').filter(function (word) {
return str.indexOf(word) >= 0
}).length === crit.split(' ').length
}
}
'use strict'
var _$Repository_4 = {
put: put,
clear: clear,
search: search,
setOptions: __setOptions_4
}
/* removed: const _$FuzzySearchStrategy_5 = require('./SearchStrategies/FuzzySearchStrategy') */;
/* removed: const _$LiteralSearchStrategy_6 = require('./SearchStrategies/LiteralSearchStrategy') */;
function NoSort () {
return 0
}
const data = []
let opt = {}
opt.fuzzy = false
opt.limit = 10
opt.searchStrategy = opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = NoSort
opt.exclude = []
function put (data) {
if (isObject(data)) {
return addObject(data)
}
if (isArray(data)) {
return addArray(data)
}
return undefined
}
function clear () {
data.length = 0
return data
}
function isObject (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Object]'
}
function isArray (obj) {
return Boolean(obj) && Object.prototype.toString.call(obj) === '[object Array]'
}
function addObject (_data) {
data.push(_data)
return data
}
function addArray (_data) {
const added = []
clear()
for (let i = 0, len = _data.length; i < len; i++) {
if (isObject(_data[i])) {
added.push(addObject(_data[i]))
}
}
return added
}
function search (crit) {
if (!crit) {
return []
}
return findMatches(data, crit, opt.searchStrategy, opt).sort(opt.sort)
}
function __setOptions_4 (_opt) {
opt = _opt || {}
opt.fuzzy = _opt.fuzzy || false
opt.limit = _opt.limit || 10
opt.searchStrategy = _opt.fuzzy ? _$FuzzySearchStrategy_5 : _$LiteralSearchStrategy_6
opt.sort = _opt.sort || NoSort
opt.exclude = _opt.exclude || []
}
function findMatches (data, crit, strategy, opt) {
const matches = []
for (let i = 0; i < data.length && matches.length < opt.limit; i++) {
const match = findMatchesInObject(data[i], crit, strategy, opt)
if (match) {
matches.push(match)
}
}
return matches
}
function findMatchesInObject (obj, crit, strategy, opt) {
for (const key in obj) {
if (!isExcluded(obj[key], opt.exclude) && strategy.matches(obj[key], crit)) {
return obj
}
}
}
function isExcluded (term, excludedTerms) {
for (let i = 0, len = excludedTerms.length; i < len; i++) {
const excludedTerm = excludedTerms[i]
if (new RegExp(excludedTerm).test(term)) {
return true
}
}
return false
}
/* globals ActiveXObject:false */
'use strict'
var _$JSONLoader_2 = {
load: load
}
function load (location, callback) {
const xhr = getXHR()
xhr.open('GET', location, true)
xhr.onreadystatechange = createStateChangeListener(xhr, callback)
xhr.send()
}
function createStateChangeListener (xhr, callback) {
return function () {
if (xhr.readyState === 4 && xhr.status === 200) {
try {
callback(null, JSON.parse(xhr.responseText))
} catch (err) {
callback(err, null)
}
}
}
}
function getXHR () {
return window.XMLHttpRequest ? new window.XMLHttpRequest() : new ActiveXObject('Microsoft.XMLHTTP')
}
'use strict'
var _$OptionsValidator_3 = function OptionsValidator (params) {
if (!validateParams(params)) {
throw new Error('-- OptionsValidator: required options missing')
}
if (!(this instanceof OptionsValidator)) {
return new OptionsValidator(params)
}
const requiredOptions = params.required
this.getRequiredOptions = function () {
return requiredOptions
}
this.validate = function (parameters) {
const errors = []
requiredOptions.forEach(function (requiredOptionName) {
if (typeof parameters[requiredOptionName] === 'undefined') {
errors.push(requiredOptionName)
}
})
return errors
}
function validateParams (params) {
if (!params) {
return false
}
return typeof params.required !== 'undefined' && params.required instanceof Array
}
}
'use strict'
var _$utils_9 = {
merge: merge,
isJSON: isJSON
}
function merge (defaultParams, mergeParams) {
const mergedOptions = {}
for (const option in defaultParams) {
mergedOptions[option] = defaultParams[option]
if (typeof mergeParams[option] !== 'undefined') {
mergedOptions[option] = mergeParams[option]
}
}
return mergedOptions
}
function isJSON (json) {
try {
if (json instanceof Object && JSON.parse(JSON.stringify(json))) {
return true
}
return false
} catch (err) {
return false
}
}
var _$src_8 = {};
(function (window) {
'use strict'
let options = {
searchInput: null,
resultsContainer: null,
json: [],
success: Function.prototype,
searchResultTemplate: '<li><a href="{url}" title="{desc}">{title}</a></li>',
templateMiddleware: Function.prototype,
sortMiddleware: function () {
return 0
},
noResultsText: 'No results found',
limit: 10,
fuzzy: false,
debounceTime: null,
exclude: []
}
let debounceTimerHandle
const debounce = function (func, delayMillis) {
if (delayMillis) {
clearTimeout(debounceTimerHandle)
debounceTimerHandle = setTimeout(func, delayMillis)
} else {
func.call()
}
}
const requiredOptions = ['searchInput', 'resultsContainer', 'json']
/* removed: const _$Templater_7 = require('./Templater') */;
/* removed: const _$Repository_4 = require('./Repository') */;
/* removed: const _$JSONLoader_2 = require('./JSONLoader') */;
const optionsValidator = _$OptionsValidator_3({
required: requiredOptions
})
/* removed: const _$utils_9 = require('./utils') */;
window.SimpleJekyllSearch = function (_options) {
const errors = optionsValidator.validate(_options)
if (errors.length > 0) {
throwError('You must specify the following required options: ' + requiredOptions)
}
options = _$utils_9.merge(options, _options)
_$Templater_7.setOptions({
template: options.searchResultTemplate,
middleware: options.templateMiddleware
})
_$Repository_4.setOptions({
fuzzy: options.fuzzy,
limit: options.limit,
sort: options.sortMiddleware,
exclude: options.exclude
})
if (_$utils_9.isJSON(options.json)) {
initWithJSON(options.json)
} else {
initWithURL(options.json)
}
const rv = {
search: search
}
typeof options.success === 'function' && options.success.call(rv)
return rv
}
function initWithJSON (json) {
_$Repository_4.put(json)
registerInput()
}
function initWithURL (url) {
_$JSONLoader_2.load(url, function (err, json) {
if (err) {
throwError('failed to get JSON (' + url + ')')
}
initWithJSON(json)
})
}
function emptyResultsContainer () {
options.resultsContainer.innerHTML = ''
}
function appendToResultsContainer (text) {
options.resultsContainer.innerHTML += text
}
function registerInput () {
options.searchInput.addEventListener('input', function (e) {
if (isWhitelistedKey(e.which)) {
emptyResultsContainer()
debounce(function () { search(e.target.value) }, options.debounceTime)
}
})
}
function search (query) {
if (isValidQuery(query)) {
emptyResultsContainer()
render(_$Repository_4.search(query), query)
}
}
function render (results, query) {
const len = results.length
if (len === 0) {
return appendToResultsContainer(options.noResultsText)
}
for (let i = 0; i < len; i++) {
results[i].query = query
appendToResultsContainer(_$Templater_7.compile(results[i]))
}
}
function isValidQuery (query) {
return query && query.length > 0
}
function isWhitelistedKey (key) {
return [13, 16, 20, 37, 38, 39, 40, 91].indexOf(key) === -1
}
function throwError (message) {
throw new Error('SimpleJekyllSearch --- ' + message)
}
})(window)
}());
</script>
<!-- Configuration -->
<script>
SimpleJekyllSearch({
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
noResultsText: '<p>Aucun résultat!</p>',
json: '/search.json',
searchResultTemplate: '<li><a href="{url}">{date}&nbsp;{title}</a>&nbsp;(Création {create})</li>'
})
</script>
</div></div>
<script>(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function scrollToAnchor(anchor, duration, callback) {
var $root = this;
$root.animate({ scrollTop: $(anchor).position().top }, duration, function() {
window.history.replaceState(null, '', window.location.href.split('#')[0] + anchor);
callback && callback();
});
}
$.fn.scrollToAnchor = scrollToAnchor;
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function affix(options) {
var $root = this, $window = $(window), $scrollTarget, $scroll,
offsetBottom = 0, scrollTarget = window, scroll = window.document, disabled = false, isOverallScroller = true,
rootTop, rootLeft, rootHeight, scrollBottom, rootBottomTop,
hasInit = false, curState;
function setOptions(options) {
var _options = options || {};
_options.offsetBottom && (offsetBottom = _options.offsetBottom);
_options.scrollTarget && (scrollTarget = _options.scrollTarget);
_options.scroll && (scroll = _options.scroll);
_options.disabled !== undefined && (disabled = _options.disabled);
$scrollTarget = $(scrollTarget);
isOverallScroller = window.isOverallScroller($scrollTarget[0]);
$scroll = $(scroll);
}
function preCalc() {
top();
rootHeight = $root.outerHeight();
rootTop = $root.offset().top + (isOverallScroller ? 0 : $scrollTarget.scrollTop());
rootLeft = $root.offset().left;
}
function calc(needPreCalc) {
needPreCalc && preCalc();
scrollBottom = $scroll.outerHeight() - offsetBottom - rootHeight;
rootBottomTop = scrollBottom - rootTop;
}
function top() {
if (curState !== 'top') {
$root.removeClass('fixed').css({
left: 0,
top: 0
});
curState = 'top';
}
}
function fixed() {
if (curState !== 'fixed') {
$root.addClass('fixed').css({
left: rootLeft + 'px',
top: 0
});
curState = 'fixed';
}
}
function bottom() {
if (curState !== 'bottom') {
$root.removeClass('fixed').css({
left: 0,
top: rootBottomTop + 'px'
});
curState = 'bottom';
}
}
function setState() {
var scrollTop = $scrollTarget.scrollTop();
if (scrollTop >= rootTop && scrollTop <= scrollBottom) {
fixed();
} else if (scrollTop < rootTop) {
top();
} else {
bottom();
}
}
function init() {
if(!hasInit) {
var interval, timeout;
calc(true); setState();
// run calc every 100 millisecond
interval = setInterval(function() {
calc();
}, 100);
timeout = setTimeout(function() {
clearInterval(interval);
}, 45000);
window.pageLoad.then(function() {
setTimeout(function() {
clearInterval(interval);
clearTimeout(timeout);
}, 3000);
});
$scrollTarget.on('scroll', function() {
disabled || setState();
});
$window.on('resize', function() {
disabled || (calc(true), setState());
});
hasInit = true;
}
}
setOptions(options);
if (!disabled) {
init();
}
$window.on('resize', window.throttle(function() {
init();
}, 200));
return {
setOptions: setOptions,
refresh: function() {
calc(true, { animation: false }); setState();
}
};
}
$.fn.affix = affix;
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
function toc(options) {
var $root = this, $window = $(window), $scrollTarget, $scroller, $tocUl = $('<ul class="toc toc--ellipsis"></ul>'), $tocLi, $headings, $activeLast, $activeCur,
selectors = 'h1,h2,h3', container = 'body', scrollTarget = window, scroller = 'html, body', disabled = false,
headingsPos, scrolling = false, hasRendered = false, hasInit = false;
function setOptions(options) {
var _options = options || {};
_options.selectors && (selectors = _options.selectors);
_options.container && (container = _options.container);
_options.scrollTarget && (scrollTarget = _options.scrollTarget);
_options.scroller && (scroller = _options.scroller);
_options.disabled !== undefined && (disabled = _options.disabled);
$headings = $(container).find(selectors).filter('[id]');
$scrollTarget = $(scrollTarget);
$scroller = $(scroller);
}
function calc() {
headingsPos = [];
$headings.each(function() {
headingsPos.push(Math.floor($(this).position().top));
});
}
function setState(element, disabled) {
var scrollTop = $scrollTarget.scrollTop(), i;
if (disabled || !headingsPos || headingsPos.length < 1) { return; }
if (element) {
$activeCur = element;
} else {
for (i = 0; i < headingsPos.length; i++) {
if (scrollTop >= headingsPos[i]) {
$activeCur = $tocLi.eq(i);
} else {
$activeCur || ($activeCur = $tocLi.eq(i));
break;
}
}
}
$activeLast && $activeLast.removeClass('active');
($activeLast = $activeCur).addClass('active');
}
function render() {
if(!hasRendered) {
$root.append($tocUl);
$headings.each(function() {
var $this = $(this);
$tocUl.append($('<li></li>').addClass('toc-' + $this.prop('tagName').toLowerCase())
.append($('<a></a>').text($this.text()).attr('href', '#' + $this.prop('id'))));
});
$tocLi = $tocUl.children('li');
$tocUl.on('click', 'a', function(e) {
e.preventDefault();
var $this = $(this);
scrolling = true;
setState($this.parent());
$scroller.scrollToAnchor($this.attr('href'), 400, function() {
scrolling = false;
});
});
}
hasRendered = true;
}
function init() {
var interval, timeout;
if(!hasInit) {
render(); calc(); setState(null, scrolling);
// run calc every 100 millisecond
interval = setInterval(function() {
calc();
}, 100);
timeout = setTimeout(function() {
clearInterval(interval);
}, 45000);
window.pageLoad.then(function() {
setTimeout(function() {
clearInterval(interval);
clearTimeout(timeout);
}, 3000);
});
$scrollTarget.on('scroll', function() {
disabled || setState(null, scrolling);
});
$window.on('resize', window.throttle(function() {
if (!disabled) {
render(); calc(); setState(null, scrolling);
}
}, 100));
}
hasInit = true;
}
setOptions(options);
if (!disabled) {
init();
}
$window.on('resize', window.throttle(function() {
init();
}, 200));
return {
setOptions: setOptions
};
}
$.fn.toc = toc;
});
})();
/*(function () {
})();*/
</script><script>
/* toc must before affix, since affix need to konw toc' height. */(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
var TOC_SELECTOR = window.TEXT_VARIABLES.site.toc.selectors;
window.Lazyload.js(SOURCES.jquery, function() {
var $window = $(window);
var $articleContent = $('.js-article-content');
var $tocRoot = $('.js-toc-root'), $col2 = $('.js-col-aside');
var toc;
var tocDisabled = false;
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
var hasToc = $articleContent.find(TOC_SELECTOR).length > 0;
function disabled() {
return $col2.css('display') === 'none' || !hasToc;
}
tocDisabled = disabled();
toc = $tocRoot.toc({
selectors: TOC_SELECTOR,
container: $articleContent,
scrollTarget: hasSidebar ? '.js-page-main' : null,
scroller: hasSidebar ? '.js-page-main' : null,
disabled: tocDisabled
});
$window.on('resize', window.throttle(function() {
tocDisabled = disabled();
toc && toc.setOptions({
disabled: tocDisabled
});
}, 100));
});
})();
(function() {
var SOURCES = window.TEXT_VARIABLES.sources;
window.Lazyload.js(SOURCES.jquery, function() {
var $window = $(window), $pageFooter = $('.js-page-footer');
var $pageAside = $('.js-page-aside');
var affix;
var tocDisabled = false;
var hasSidebar = $('.js-page-root').hasClass('layout--page--sidebar');
affix = $pageAside.affix({
offsetBottom: $pageFooter.outerHeight(),
scrollTarget: hasSidebar ? '.js-page-main' : null,
scroller: hasSidebar ? '.js-page-main' : null,
scroll: hasSidebar ? $('.js-page-main').children() : null,
disabled: tocDisabled
});
$window.on('resize', window.throttle(function() {
affix && affix.setOptions({
disabled: tocDisabled
});
}, 100));
window.pageAsideAffix = affix;
});
})();
</script><!---->
</div>
<script>(function () {
var $root = document.getElementsByClassName('root')[0];
if (window.hasEvent('touchstart')) {
$root.dataset.isTouch = true;
document.addEventListener('touchstart', function(){}, false);
}
})();
</script>
</body>
</html>