gitcid
1.0.0
gitc.id ⊙ "power tools for git" ⊙ Copyright © 2021 Jeremy Carter <[email protected]>
Use of this software is governed by the terms of the included MIT License (GitHub mirror).
git remotes using ssh and rsync that you can push to, with gitcid tools activated inside them.git repos, and add gitcid tools inside them.gitcid tools live inside each local or remote git repo, you can add them to any of your existing repos with one command.gitcid to your repo, it gains built-in CI/CD features with a bit of help from docker-compose (work-in-progress).CI/CD pipelines in a yaml format that might be comfortable for you if you've used other CI/CD systems before.dedicated git servers to ssh remote locations using one command. It's recommended to install them on some dedicated devices on your LAN such as Raspberry Pi running Raspberry Pi OS (aarch64 or armhf). Regular Debian (amd64) targets are also supported. Perhaps it works on some Debian-derived distros as well, but that hasn't been tested.git server and it will automatically share any git repos it finds to the rest of your LAN.git repos with a familiar GitWeb UI.GitCid will try to install these for you automatically if they're missing from your system, but if it fails, you might need to install them yourself:
pip or pip3 (python's package manager) is the one that works properly.There are a few more dependencies needed depending on your OS, but they should be installed automatically in most cases. See the files in .gc/.gc-deps for full details.
Make sure you've installed git and
curl first,
then run the following command:
source <(curl -sL https://tinyurl.com/gitcid)When this command finishes, it will have created a new folder called gitcid in your current directory, and then it will bring you into this new folder.
(Optional) Or if you prefer, you can run this command instead:
git clone https://gitlab.com/defcronyke/gitcid.git && cd gitcid && echo "" && .gc/init.sh -hIn the gitcid folder, run this command:
.gc/new-remote.sh ~/repo1.git~/repo1.gitgit clone command that you can use to clone your new repo at the bottom of the output if everything worked properly.You can use remote ssh paths for the new remote repo location also, instead of a local path, for example:
.gc/new-remote.sh git1:~/repo1.gitAn example git clone command to clone your git repo might look something like this:
git clone git1:~/repo1.git && cd repo1It's just the regular way of cloning git repos.
When you make your new remote repo, you will also be given a command you can use to add GitCid features to your locally cloned repo that you cloned from the remote. Here's that same command in case you need it. Make sure you're inside your local repo when you run this command:
source <(curl -sL https://tinyurl.com/gitcid) -eThe above command will add GitCid to your git repo in a .gitignore'd folder called: .gc/
Run this command from the top-level directory of the GitCid repo, for usage info:
.gc/init.sh -hRun this command from the top-level directory of your existing git repo that you'd like to install GitCid into (it works for both regular and bare repos):
source <(curl -sL https://tinyurl.com/gitcid) -eNOTE: The remote targets need to have rsync installed.
Run these .gc/init.sh commands from the top-level directory of the GitCid repo,
to make new GitCid git repositories.
Make a new local git repo with the default name of "repo" in the current directory:
.gc/init.shMake a new local git repo:
.gc/init.sh ./local-repoMake a new remote git repo at a target ssh server path:
.gc/init.sh user@host:~/remote-repoMake several new git repos at once, local and/or remote ones:
.gc/init.sh local-repo1 user@host:~/remote-repo1 user@host:~/remote-repo2 ./local-repo2Make several new bare git repos at once (suitable for using as git remotes), local and/or remote ones:
.gc/init.sh -b user@host:~/remote-bare-repo1.git local-bare-repo1.git ./local-bare-repo2Install a git server at a target ssh location, using tools from this project:
https://gitlab.com/defcronyke/git-server
Currently supported target platforms:
Platform support wishlist (Please feel free to test and contribute fix suggestions if you'd like to help with adding support for these):
Maybe it works on other Debian or Debian-based platforms, but this hasn't been tested yet.
WARNING: USE AT YOUR OWN RISK! You should only run the commands in this section to install a dedicated git server onto a freshly installed Linux distro which is intended to be used only as a dedicated git server! This will install some dependencies automatically and do some system configurations that you might not prefer to have on devices that are being used for other purposes. USE AT YOUR OWN RISK! YOU HAVE BEEN WARNED!!
Install a git server to a remote ssh location (or two as in this example), by running the following command in a bash terminal:
source <(curl -sL https://tinyurl.com/gitcid) && .gc/new-git-server.sh -o pi@git1 $USER@gitlabUsually it just works, and with the -o flag used above, it should auto-open a web page for each git server it finds on your network after the install is finished. For more info and other options, see the next section below.
The example above will also install gitcid, which makes it easier to work with the git server. If you already have gitcid installed, you don't need to install it again, so in that case you can omit the first part of the above command, for example:
.gc/new-git-server.sh -o pi@git1 $USER@gitlabJust make sure you're inside the gitcid/ folder first (or any gitcid-enabled git repo), before trying to run any gitcid commands.
Install GitCid:
source <(curl -sL https://tinyurl.com/gitcid)If successful, you will now be inside the freshly downloaded ./gitcid/ folder. You need to be inside this folder for step 2.
Install new git server(s) onto dedicated device(s) at the given ssh target location(s):
.gc/new-git-server.sh -h.gc/new-git-server.sh git1 git2 gitlab.gc/new-git-server.sh -o git1 git2 gitlab.gc/new-git-server.sh -y git1 git2 gitlab.gc/new-git-server.sh -yo git1 git2 gitlab.gc/new-git-server.sh -s git1 git2 gitlab.gc/new-git-server.sh -so git1 git2 gitlab~/.ssh/config file, but if you prefer, you can add a username in the command below for each target. You can do this for any of the various commands listed above, for example:.gc/new-git-server.sh -yo pi@git1 pi@git2 $USER@gitlabIf everything worked as intended, your git server(s) are now ready to use. See the output in your terminal for more details. During parallel installs (the default behaviour unless using the -s flag variants), if non-interactive sudo support isn't configured on the target, the system will fall back to sequential install mode for any targets which need the sudo password typed manually. After typing the sudo password once successfully, a passwordless sudo configuration will be attempted on the target, so that any future interactions with that target can be fully-automated.
Here's some examples of how to use your git server for some common git-related tasks. The following commands should be run from inside your gitcid/ folder, or inside any gitcid-enabled git repo.
Create a new git remote repo on the git server, for example, a repo named repo1.git at the hostname git1:
.gc/new-remote.sh git1:repo1Newly created remote repos will become available for use after a short delay, typically less than 1 minute. If you receive an error when trying to use a newly created remote repo, try again after 1 minute has passed since creating it and it should work.
Clone a local copy of your new repo from the server:
git clone git1:~/git/repo1.git
cd repo1Commit some changes to your new repo, then push it to the origin remote on your git server:
date | tee -a test1.txt
git add .
git commit -m "A test commit."
git push(Optional) Add gitcid to your local copy of your git repo if you'd like to use any gitcid commands while working inside your repo. Run the following command while inside your repo to install gitcid features:
source <(curl -sL https://tinyurl.com/gitcid) -e(Optional) With gitcid added to your repo from the previous step, you can commit and push more easily:
.gc/commit-push.sh Commit message.If you'd like to contribute to the development of the git server, you can run this command if you want, to help you set up your dev environment for this purpose:
source <(curl -sL https://tinyurl.com/gitcid) -dIt will clone all related project git repositories, and it will install gitcid into them for convenience.
