flyingscorpio/setup-cockpit
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Remove pre-ansible-migration related things in README

Browse source
This commit is contained in:
flyingscorpio@clevo 2022-03-10 23:26:31 +01:00
parent 1609c1fcf5
commit 0621e5a050
1 changed files with 2 additions and 105 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

107
README.md
View file

@ -1,106 +1,3 @@
# Getting started
The Python requirements are all in `requirements.txt`, so before starting you need to issue the following command:
```sh
$ pip install -r requirements.txt --user
```
**without** using sudo. Using sudo with pip is a bad idea because it will interfere with your distribution's package manager.
# setup-cockpit
If you're on a fresh install, you won't have `pip` installed, so you'll need:
```sh
$ sudo pacman -S python-pip
```
or
```sh
$ sudo apt install python3-pip
```
The authentication details are stored in `secrets`. Therefore, you have a template `secrets.template` that you need to copy and rename:
```sh
$ cp secrets{.template,}
```
Modify the resulting file, and then run `./install.py` with needed flags (`./install.py -h` is your friend).
# About the files in the repo
* `borg_backup.sh`<br>
Borg backup script.
Used by a pacman hook to backup my system, but it can also be run manually.
* `configs.yml`<br>
Lists the things to install, which includes programs, symlinks, git clones, shell commands...
* `dotfiles/`<br>
The actual dotfiles.
They are symlinked to the location that the system expects to find them.
* `firefox_addons.txt`<br>
I like to install my Firefox add-ons manually in the Firefox add-on manager, so this file just reminds me what to install and includes the urls to each add-on.
* `install.py`<br>
Installs everything using `configs.yml`.
This is the file to actually run.
* `rsync_backup.sh`<br>
rsync backup script.
Used by a systemd timer to backup my system, but it can also be run manually.
* `secrets.template`<br>
Contains environment variables for authentication and personnalization.
Use it to create a file named `secrets`.
* `shellcheck_binary_fix.sh`<br>
When running this on ARM, pacman there was no shellcheck package, so this script installs the pre-compiled binary instead.
If your package manager finds shellcheck, this script won't run.
* `todo`<br>
Never seems to remain empty...
# YML commands
`configs.yml` contains instructions as keys, which trigger commands.
Here is a brief explanation of the implemented commands:
* `clone`<br>
Perform a `git clone`.
With `-f`, remove and clone.
With `-u`, perform a `git pull`.
Branch can also be specified.
* `copy`<br>
Copy a file.
With `-f`, overwrite existing.
* `download`<br>
Download a file with a URL.
With `-f`, overwrite existing.
* `install`<br>
Use the package manager to install a package.
Specific packages for Debian-based or Arch-based distros can be set.
* `include`<br>
Include another config file (also yml).
* `run`<br>
Pass a line of text to a subshell.
A condition can be added to launch the command.
* `depend`<br>
Install another part of the config file before.
* `symlink`<br>
Make a symlink.
* `symlink_dir`<br>
Make a symlink to a directory.
* `append`<br>
Append text to the end of a file.
Will only append if the content isn't already in the file.
* `write`<br>
Write text to a file, overwriting if it exists.
# Thanks
The idea for the architecture was taken from Dimitri Merejkowsky's [GitHub](https://github.com/dmerejkowsky/dotfiles).
My personal dotfiles managed with ansible.