CDIST-TYPE__GIT(7)

📦
version 7.0.0 · 8 versions
, in fedora 43, fedora 44

✨ cdist-type__git ✨

okay bestie, gather round, because this is the cdist-type__git manual page and it's literally about keeping your git repos cloned and up-to-date. no cap. it's giving "your infra, but make it version-controlled" 💅

🌸 NAME 🌸

cdist-type__git — Get and or keep git repositories up-to-date 🦋

💖 DESCRIPTION 💖

so basically this cdist type lets you clone git repositories. that's the whole vibe. you point it at a remote, it does the thing. iconic behavior honestly 🎀

👑 REQUIRED PARAMETERS 👑

like, you have to give it these, it's not optional, it's the main character:

  • source — specifies the git remote to clone from. yes queen, tell it where the repo lives 🔥

✨ OPTIONAL PARAMETERS ✨

these are the lil extras you can sprinkle in if you want, no pressure bestie:

  • state — either "present" or "absent", and it defaults to "present" 🌈
  • branch — create this branch by checking out the remote branch of this name. the default branch is "master" 🌿
  • group — group to chgrp to. 🫶
  • mode — Unix permissions, suitable for chmod. 🔐
  • owner — user to chown to. 👤
  • recursive — passes the --recurse-submodules flag to git when cloning the repository. submodules get the submodule treatment, fr fr 🧚
  • shallow — sets --depth=1 and --shallow-submodules for cloning repositories with big history. perfect for when the history is doing the absolute most and you simply cannot 💀

🎀 EXAMPLES 🎀

here's how it actually looks in the wild, copy-paste ready:

__git /home/services/dokuwiki --source git://github.com/splitbrain/dokuwiki.git

# Checkout cdist, stay on branch 2.1
__git /home/nico/cdist --source git@code.ungleich.ch:ungleich-public/cdist.git --branch 2.1

see? easy. ate that 🍓

💜 AUTHORS 💜

  • Nico Schottelius <nico-cdist--@--schottelius.org> ✨

🌈 COPYING 🌈

Copyright (C) 2012 Nico Schottelius. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. 📜 (yes bestie, that's the whole license paragraph, we keep it exactly as it is, no edits, periodt)

ungleich GmbH 2021 ⭐

and that's the tea, bestie 🫶 this page came from version 7.0.0, dated Jul 31, 2022 — go forth and clone responsibly 💖

📦 where this page comes from