docs: cleanup README
This commit is contained in:
parent
e788fa6ef8
commit
82164be2e2
6 changed files with 33 additions and 112 deletions
104
README.md
104
README.md
|
@ -4,13 +4,9 @@ Code name given on 2024-05-16 : "MonakhOS"
|
||||||
|
|
||||||
Architecture:
|
Architecture:
|
||||||
- Sway
|
- Sway
|
||||||
|
- Support of dots file repository
|
||||||
- A single `venv` in dots containing all utilities and libs
|
- A single `venv` in dots containing all utilities and libs
|
||||||
|
|
||||||
## Ansible
|
|
||||||
|
|
||||||
https://github.com/id101010/ansible-archlinux
|
|
||||||
|
|
||||||
## Getting started with a VM (qemu)
|
## Getting started with a VM (qemu)
|
||||||
|
|
||||||
Cd in `sandbox_vms/vm1`
|
Cd in `sandbox_vms/vm1`
|
||||||
|
@ -35,15 +31,19 @@ Create snapshot to be able to quickly restart the ansible script with a clean im
|
||||||
|
|
||||||
qemu-img create -f qcow2 -b after_ssh_init.img -F qcow2 ready_for_ansible.img
|
qemu-img create -f qcow2 -b after_ssh_init.img -F qcow2 ready_for_ansible.img
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Steps to install
|
## Steps to install
|
||||||
|
|
||||||
- find a new name for the device eg. blackjack
|
- find a new name for the device eg. blackjack
|
||||||
- connect to wifi
|
- install with `archinstall` to initialize the computer
|
||||||
- enable ssh server to access it from the exterior
|
- use the profiles defined in `archinstall_configs`
|
||||||
- generate ssh key
|
- connect to the internet
|
||||||
- add sshkey to forge.lefuturiste.fr
|
- enable an ssh server to access it from the ansible runner host
|
||||||
|
- on the host, generate a private ssh key
|
||||||
|
- add the public key on the target host
|
||||||
|
- create a target directory in `target` directory
|
||||||
|
- configure `vars.yaml`, see example vars file
|
||||||
|
- create on the host, the private ssh key that will be installed on target
|
||||||
|
- add this sshkey to your forge that host your dots file, eg. forge.lefuturiste.fr
|
||||||
|
|
||||||
### Generate a unprotected default ssh key
|
### Generate a unprotected default ssh key
|
||||||
|
|
||||||
|
@ -74,86 +74,14 @@ Host aur.archlinux.org
|
||||||
User aur
|
User aur
|
||||||
```
|
```
|
||||||
|
|
||||||
### Clone dots
|
|
||||||
|
|
||||||
```
|
|
||||||
cd ~
|
|
||||||
git clone git@forge.lefuturiste.fr:mbess/dots .dots
|
|
||||||
```
|
|
||||||
|
|
||||||
```
|
|
||||||
cd ~/.dots
|
|
||||||
python3 -m venv venv
|
|
||||||
|
|
||||||
pip install -r requirements.txt
|
|
||||||
|
|
||||||
# create symbolic link to access dots
|
|
||||||
ln -s ~/.dots ~/dots
|
|
||||||
```
|
|
||||||
|
|
||||||
### install yay
|
|
||||||
|
|
||||||
```
|
|
||||||
git clone https://aur.archlinux.org/yay.git
|
|
||||||
cd yay
|
|
||||||
makepkg -si
|
|
||||||
```
|
|
||||||
|
|
||||||
### configure Zsh
|
|
||||||
|
|
||||||
https://wiki.archlinux.org/title/Zsh
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### configure xremap
|
|
||||||
|
|
||||||
sudo systemctl daemon-reload
|
|
||||||
|
|
||||||
sudo systemctl enable --now xremap
|
|
||||||
|
|
||||||
|
|
||||||
### Import and configure GPG keys
|
|
||||||
|
|
||||||
### Configure unix password manager
|
|
||||||
|
|
||||||
using `extra/gopass`
|
|
||||||
|
|
||||||
### Setup symbolic links to configs files
|
|
||||||
|
|
||||||
run the script `setup_dot.sh`
|
|
||||||
|
|
||||||
## Shell
|
|
||||||
|
|
||||||
### Fish
|
|
||||||
|
|
||||||
#### install fisher
|
|
||||||
|
|
||||||
https://github.com/jorgebucaran/fisher
|
|
||||||
|
|
||||||
use `fisher package`
|
|
||||||
|
|
||||||
#### fzf fish
|
|
||||||
|
|
||||||
https://github.com/PatrickF1/fzf.fish
|
|
||||||
|
|
||||||
require fd and bat
|
|
||||||
|
|
||||||
#### lfcd
|
|
||||||
https://github.com/gokcehan/lf/blob/master/etc/lfcd.fish
|
|
||||||
|
|
||||||
### Zsh
|
|
||||||
|
|
||||||
https://yewtu.be/watch?v=ud7YxC33Z3w
|
|
||||||
https://github.com/jeffreytse/zsh-vi-mode
|
|
||||||
|
|
||||||
How to handle different profiles
|
|
||||||
|
|
||||||
## Pacman packages
|
## Pacman packages
|
||||||
|
|
||||||
defined in dots file
|
defined in dots file
|
||||||
|
|
||||||
arch_packages.yaml
|
arch_packages.yaml
|
||||||
|
|
||||||
|
categories: commons, work
|
||||||
|
|
||||||
## Sway
|
## Sway
|
||||||
|
|
||||||
### swayidle
|
### swayidle
|
||||||
|
@ -166,7 +94,7 @@ Ly is a TUI greeter, it will show a terminal based login prompt
|
||||||
|
|
||||||
https://github.com/fairyglade/ly
|
https://github.com/fairyglade/ly
|
||||||
|
|
||||||
## ansible
|
## Ansible
|
||||||
|
|
||||||
### auto run archinstall with ansible
|
### auto run archinstall with ansible
|
||||||
|
|
||||||
|
@ -174,8 +102,8 @@ https://github.com/fairyglade/ly
|
||||||
|
|
||||||
https://archinstall.archlinux.page/
|
https://archinstall.archlinux.page/
|
||||||
|
|
||||||
|
|
||||||
## Pistes
|
## Pistes
|
||||||
|
|
||||||
https://github.com/kewlfft/ansible-aur
|
- https://github.com/id101010/ansible-archlinux
|
||||||
|
- https://github.com/kewlfft/ansible-aur
|
||||||
|
|
||||||
|
|
|
@ -1,8 +0,0 @@
|
||||||
https://runebook.dev/fr/docs/ansible/collections/community/general/pacman_module
|
|
||||||
https://docs.ansible.com/ansible/2.8/modules/pacman_module.html
|
|
||||||
https://docs.ansible.com/ansible/latest/collections/community/general/pacman_module.html
|
|
||||||
|
|
||||||
## External modules
|
|
||||||
|
|
||||||
https://github.com/kewlfft/ansible-aur/tree/master
|
|
||||||
|
|
|
@ -357,10 +357,16 @@ common:
|
||||||
mail:
|
mail:
|
||||||
- thunderbird
|
- thunderbird
|
||||||
communication:
|
communication:
|
||||||
|
_:
|
||||||
- signal-desktop
|
- signal-desktop
|
||||||
|
matrix:
|
||||||
- name: fractal
|
- name: fractal
|
||||||
desc: matrix client that seem to work in Rust
|
desc: Matrix client that seem to work in Rust
|
||||||
upstream: https://gitlab.gnome.org/World/fractal
|
upstream: https://gitlab.gnome.org/World/fractal
|
||||||
|
- name: aur/cinny-desktop-bin
|
||||||
|
desc: Electron matrix client
|
||||||
|
issues:
|
||||||
|
- Notifications doesn't work with this package
|
||||||
document:
|
document:
|
||||||
viewer:
|
viewer:
|
||||||
- zathura
|
- zathura
|
||||||
|
|
|
@ -1,6 +0,0 @@
|
||||||
device_name: blackjack
|
|
||||||
user: mbess
|
|
||||||
device_platform: vm
|
|
||||||
profile: perso OR pro (work)
|
|
||||||
target_is_real: true (if not a vm)
|
|
||||||
|
|
|
@ -1,2 +0,0 @@
|
||||||
user: mbess
|
|
||||||
device_name: grayblower
|
|
|
@ -1,8 +1,10 @@
|
||||||
user: mbess
|
|
||||||
device_name: somehost
|
device_name: somehost
|
||||||
profile: pro
|
device_type: laptop
|
||||||
|
# the username to install
|
||||||
|
user: mbess
|
||||||
|
# if it's a VM: false, if it's bare metal: false
|
||||||
target_is_real: true
|
target_is_real: true
|
||||||
organization: companyA
|
# optionally configure openfortivpn
|
||||||
openfortivpn_profiles:
|
openfortivpn_profiles:
|
||||||
- name: companyA
|
- name: companyA
|
||||||
p:
|
p:
|
||||||
|
@ -11,9 +13,10 @@ openfortivpn_profiles:
|
||||||
username: user
|
username: user
|
||||||
password: XXX
|
password: XXX
|
||||||
trusted_cert: XXXXX
|
trusted_cert: XXXXX
|
||||||
|
# What user config profiles to enable
|
||||||
enabled_profiles:
|
enabled_profiles:
|
||||||
- name: pro
|
- name: pro
|
||||||
|
# What kind of categories to enable
|
||||||
packages_categories:
|
packages_categories:
|
||||||
- common
|
- common
|
||||||
- proprietary_vpns
|
- proprietary_vpns
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue