{"id":20596285,"url":"https://github.com/ulhpc/puppet-bontmia","last_synced_at":"2026-02-07T09:32:44.315Z","repository":{"id":5194608,"uuid":"35233031","full_name":"ULHPC/puppet-bontmia","owner":"ULHPC","description":"Puppet module which configures and manages bontmia backup script","archived":false,"fork":false,"pushed_at":"2024-11-04T20:41:49.000Z","size":141,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":8,"default_branch":"devel","last_synced_at":"2025-06-20T19:09:21.770Z","etag":null,"topics":["backup","bontmia","puppet"],"latest_commit_sha":null,"homepage":null,"language":"Puppet","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ULHPC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-05-07T17:12:42.000Z","updated_at":"2024-11-04T20:41:46.000Z","dependencies_parsed_at":"2024-05-21T12:58:37.559Z","dependency_job_id":"f4acdeb6-ecda-4ad3-872a-acfe1a9f1d20","html_url":"https://github.com/ULHPC/puppet-bontmia","commit_stats":{"total_commits":116,"total_committers":5,"mean_commits":23.2,"dds":0.1724137931034483,"last_synced_commit":"ea9325196380ea5ede8646d89cd52950fd10c062"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/ULHPC/puppet-bontmia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ULHPC%2Fpuppet-bontmia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ULHPC%2Fpuppet-bontmia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ULHPC%2Fpuppet-bontmia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ULHPC%2Fpuppet-bontmia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ULHPC","download_url":"https://codeload.github.com/ULHPC/puppet-bontmia/tar.gz/refs/heads/devel","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ULHPC%2Fpuppet-bontmia/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265561006,"owners_count":23788292,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","bontmia","puppet"],"created_at":"2024-11-16T08:16:11.048Z","updated_at":"2026-02-07T09:32:44.309Z","avatar_url":"https://github.com/ULHPC.png","language":"Puppet","funding_links":[],"categories":[],"sub_categories":[],"readme":"-*- mode: markdown; mode: visual-line;  -*-\n\n# Bontmia Puppet Module\n\n[![Puppet Forge](http://img.shields.io/puppetforge/v/ULHPC/bontmia.svg)](https://forge.puppetlabs.com/ulhpc/bontmia)\n[![License](http://img.shields.io/:license-GPL3.0-blue.svg)](LICENSE)\n![Supported Platforms](http://img.shields.io/badge/platform-debian|centos-lightgrey.svg)\n\nConfigure and manage bontmia\n\n      Copyright (c) 2021 UL HPC Team \u003chpc-sysadmins@uni.lu\u003e\n\n\n| [Project Page](https://github.com/ULHPC/puppet-bontmia) | [Sources](https://github.com/ULHPC/puppet-bontmia) | [Issues](https://github.com/ULHPC/puppet-bontmia/issues) |\n\n## Synopsis\n\nThis module configures a bontmia installation and the backup tasks.\n\nThis module implements the following elements:\nNote that we use a [forked version of bontmia](https://github.com/hcartiaux/bontmia).\n\n* __Puppet classes__:\n    - `bontmia`\n    - `bontmia::common`\n    - `bontmia::common::debian`\n    - `bontmia::common::redhat`\n    - `bontmia::params`\n\n* __Puppet definitions__:\n    - `bontmia::target`\n\nAll these components are configured through a set of variables you will find in\n[`manifests/params.pp`](manifests/params.pp).\n\n_Note_: the various operations that can be conducted from this repository are piloted from a [`Rakefile`](https://github.com/ruby/rake) and assumes you have a running [Ruby](https://www.ruby-lang.org/en/) installation.\nSee `docs/contributing.md` for more details on the steps you shall follow to have this `Rakefile` working properly.\n\n## Dependencies\n\nSee [`metadata.json`](metadata.json). In particular, this module depends on\n\n* [puppetlabs/stdlib](https://forge.puppetlabs.com/puppetlabs/stdlib)\n\n## General Parameters\n\nSee:\n\n* [manifests/params.pp](manifests/params.pp)\n* the headers of [manifests/bontmia.pp](manifests/bontmia.pp)\n* the headers of [manifests/target.pp](manifests/target.pp)\n\n## Overview and Usage\n\n### class `bontmia`\n\n     class { 'bontmia':\n         ensure =\u003e 'present',\n         prefix =\u003e '/data/bontmia',\n         sudo   =\u003e true\n     }\n\n### definition `bontmia::target`\n\nThe definition `bontmia::target` permits to set-up one backup task.\nThis definition accepts the following parameters:\n\n* `ensure`: default to 'present', can be 'absent'.\n* `dest_dir`: destination directory of the backup\n* `src_dir`, `src_host`, `src_user`, `src_port`: defines the backup source.\n  If `src_host` is not set, it assumes that we want to backup the local directory `src_dir`.\n\n* `rotation_days`, `rotation_weeks`, `rotation_months`, `rotation_years`:\n  set-up the rotation policy with these values, see the bontmia documentation for more information\n\n* `cron_minute`, `cron_hour`, `cron_weekday`, `cron_monthday`, `cron_month`:\n  set-up a cronjob with these settings\n\n* `email`: send the execution output to this email address\n\nExample:\n\n     bontmia::target{ 'backup_hcartiaux':\n         ensure   =\u003e 'present',\n         dest_dir =\u003e '/data/test/hcartiaux',\n         src_user =\u003e 'localadmin',\n         src_host =\u003e 'nfs.chaos',\n         src_dir  =\u003e '/export/users/homedirs/hcartiaux',\n         src_port =\u003e '2222',\n         days     =\u003e '7',\n         weeks    =\u003e '4',\n         months   =\u003e '12',\n         years    =\u003e '2',\n         email    =\u003e 'hpc-sysadmins@uni.lu'\n     }\n\n## Librarian-Puppet / R10K Setup\n\nYou can of course configure the bontmia module in your `Puppetfile` to make it available with [Librarian puppet](http://librarian-puppet.com/) or\n[r10k](https://github.com/adrienthebo/r10k) by adding the following entry:\n\n     # Modules from the Puppet Forge\n     mod \"ULHPC/bontmia\"\n\nor, if you prefer to work on the git version:\n\n     mod \"ULHPC/bontmia\",\n         :git =\u003e 'https://github.com/ULHPC/puppet-bontmia',\n         :ref =\u003e 'production'\n\n## Issues / Feature request\n\nYou can submit bug / issues / feature request using the [ULHPC/bontmia Puppet Module Tracker](https://github.com/ULHPC/puppet-bontmia/issues).\n\n## Developments / Contributing to the code\n\nIf you want to contribute to the code, you shall be aware of the way this module is organized.\nThese elements are detailed on [`docs/contributing.md`](contributing/index.md).\n\nYou are more than welcome to contribute to its development by [sending a pull request](https://help.github.com/articles/using-pull-requests).\n\n## Puppet modules tests within a Vagrant box\n\nThe best way to test this module in a non-intrusive way is to rely on [Vagrant](http://www.vagrantup.com/).\nThe `Vagrantfile` at the root of the repository pilot the provisioning various vagrant boxes available on [Vagrant cloud](https://atlas.hashicorp.com/boxes/search?utf8=%E2%9C%93\u0026sort=\u0026provider=virtualbox\u0026q=svarrette) you can use to test this module.\n\nSee [`docs/vagrant.md`](vagrant.md) for more details.\n\n## Licence\n\nThis project and the sources proposed within this repository are released under the terms of the [GPL-3.0](LICENCE) licence.\n\n\n[![Licence](https://www.gnu.org/graphics/gplv3-88x31.png)](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulhpc%2Fpuppet-bontmia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fulhpc%2Fpuppet-bontmia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fulhpc%2Fpuppet-bontmia/lists"}