Shell-Konfiguration
Go to file
Jakobus Schürz d6326111d9 next try 2024-02-27 15:11:10 +01:00
.githooks transition from HOSTCONFIG to MYSHELLCONFIG 2020-01-14 10:12:00 +01:00
bash_completion.d source completion for pass only, if it exists 2023-02-21 02:20:44 +01:00
bin Merged detached head into master 2023-11-17 14:05:59 +01:00
tmux update submodules 2023-02-15 14:53:31 +01:00
vim add vimwiki plugin for vim 2024-01-11 10:24:38 +01:00
.gitconfig add safedir * 2023-02-15 22:20:41 +01:00
.gitignore remove unneeded to ignore files 2021-02-15 15:32:25 +01:00
.gitignore_global add global ignore-file to ignore helptags from vim 2020-10-30 23:47:03 +01:00
.gitmodules add vimwiki plugin for vim 2024-01-11 10:24:38 +01:00
.gitmodules.github.com add files for github and own repos for submodules 2020-10-25 12:01:44 +01:00
.gitmodules.schuerz.at change paths 2020-10-25 23:06:00 +01:00
LICENSE Create LICENSE 2020-01-15 10:21:50 +01:00
PS1 Merged detached head into master 2024-01-11 10:24:38 +01:00
README.md change variable from MYHSHELLCONFIG_ to MSC_ and fix 2020-12-10 09:31:38 +01:00
aliases add alias to mbackups 2024-02-08 22:27:05 +01:00
aliases_remote add alias for deploy pvp and do not run jra/cnf again 2024-01-19 08:24:32 +01:00
bashrc_add Merged detached head into master 2024-01-11 10:24:38 +01:00
defaults.conf change default remote name from gitea to origin 2023-02-02 02:54:49 +01:00
defaults.conf.sample move and introduce new defaults 2023-01-20 21:51:12 +01:00
functions.sh next try 2024-02-27 15:11:10 +01:00
logging fix basename, when -bash is shell 2022-09-14 16:38:04 +02:00
myshell_git_sync change git checkout 2022-10-31 03:08:04 +01:00
myshell_load_defaults Merged detached head into master 2024-01-11 10:24:38 +01:00
myshell_load_fortmpconfig read local ~/.bash_aliases 2023-02-09 10:19:51 +01:00
myshell_load_x2go_tokenforward comment create symlink 2023-01-09 08:21:39 +01:00
sshs set environment in tmux 2023-05-30 17:21:09 +02:00
sshs_addfiles.conf add functions and aliases 2023-10-12 17:24:36 +02:00
vimplugins add vimwiki plugin for vim 2024-01-11 10:24:38 +01:00
vimrc add copy to clipboard in vim on wayland 2023-06-12 09:37:56 +02:00

README.md

myshellconfig

Am Einfachsten ist es, das github-Repo zu forken und in .gitconfig den Namen und die Emailadresse an die eigenen Werte anzupassen. Das Repo ist öffentlich, also keine Passwörter speichern!!!

ACHTUNG

Diese automatische Konfiguration überschreibt bei jedem Login in ${HOME} einige Dateien mit Symlinks in das lokale Repo. Die zuvor vorhandenen Dateien werden nicht gesichert und gehen daher verloren. Folgende Dateien werden durch Symlinks ersetzt. Diese bitte VOR dem ersten Aufruf sichern.

~/.gitconfig -> ${HOME}/.local/myshellconfig/.gitconfig
~/.tmux -> ${HOME}/.local/myshellconfig/tmux
~/.tmux.conf -> ${HOME}/.local/myshellconfig/tmux/tmux.conf
~/.vim -> ${HOME}/.local/myshellconfig/vim
~/.vimrc -> ${HOME}/.local/myshellconfig/vimrc

Bitte beachten, dass damit eine schon vorhandene eigene Datei überschrieben wird!

Proxy

Wenn in einem Setup ein Proxy verwendet werden muss, so ist dieser VORHER zu konfigurieren. Da Proxyeinstellungen Hostabhängig sind und nicht generell in die allgemeine Konfiguration aufgenommen werden können, sind die Proxy-Einstellungen für git im File

~/.gitconfig_local
[http]
        proxy = http://username:password@proxy.domain.tld:1233/

abzulegen. Die verteilte .gitconfig enthält bereits eine Zeile, welche dieses lokale File für git sourced.

Installation

Damit auf einem neuen Server meine persönlichen Alias und Bash-Promt, wie auch verschiedene andere Befehle (vim in sudo mit der vimrc des Benutzers) zur Verfügung stehen, muss als erstes nach dem ersten Login folgendes ausgeführt werden:

Clone von github

git clone https://github.com/xundeenergie/myshellconfig.git ${HOME}/.local/myshellconfig

~/.bashrc ist am Ende um folgende Zeilen zu ergänzen

#MYSHELLCONFIG-start
if [ -e ~/.local/myshellconfig/bashrc_add ]; then . ~/.local/myshellconfig/bashrc_add; fi
#MYSHELLCONFIG-end

Ausloggen und neu Einloggen.

Lokale Configuration

in ~/.bashrc werden vor der Zeile zum Einbinden der myshellconfig die Variablen eingefügt um damit ein hostspezifisches Verhalten zu steuern

MSC_GIT_CHECKOUTSCRIPT_OPTIONS=

Mögliche Optionen:

* -h
* -s
* ''

Verwendung: Damit kann man angeben, ob ein headless Repo erzeugt wird. Ohne -h folgt das Repo origin/master Default ist die Option "-h". Soll ein normales Repo (nicht headless) verwendet werden, so MUSS die Variable so gesetzt werden

Mit der Option -s kann ein Update der Submodules (tmux-, vim-plugins) erzwungen werden

MSC_GIT_CHECKOUTSCRIPT_OPTIONS=""

Git Protokolle für push und pull

MSC_GIT_REMOTE_PROTOCOL=git # git ist default
MSC_GIT_REMOTE_PUSH_PROTOCOL=$MSC_GIT_REMOTE_PROTOCOL # MSC_GIT_REMOTE_PROTOCOL ist default

Mögliche Optionen:

* git - (default) Gitprotokoll ist git (Auf manchen Umgebungen kann der dazu notwenidge Port gesperrt sein)
* http - wenn git nicht möglich ist, kann das http/https Protokoll verwendet werden. (ist langsamer als git, jedoch ist fast überall Port 80 oder 440 freigeschaltet)
* ssh - Wenn auch schreibend auf das Repo zugegriffen werden soll, so muss Privatekey, Pubkey (und wenn konfiguriert Certifikate mit den notwendigen Principals) vorhanden sein, dann kann das ssh-Prodokoll verwendet werden.
* file - Das entfernte Repository ist auf einem USB-Stick, welcher unter /media/$USER/gitstick beim Einstecken gemountet wird. Der Pfad ist anpassbar (siehe MSC_GIT_REPO_PATH)

Vim Plugins werden prinzipiell von github.com bezogen. Für spezielle Anwendungsfälle (github.com ist per firewall gesperrt), kann man diese auch in eigenen Repos hosten. Um diese eigenen Repos zu verwenden, muss in ~/.bashrc die Variable entsprechend gesetzt werden. Es ist ein Verzeichnis anzugeben, unter dem alle Pluginrepos als bare-Repos gecloned werden. Wichtig ist, dass die Usernamenverzeichnisse von github.com hier auch vorhanden sind, damit ohne dieser gesetzten Variable die Plugins direkt von github.com geladen werden können.

MSC_VIM_PLUGINS=https://my.git.server/public/Vim

Z.B. das Plugin Vundle.vim hat ist auf github unter dieser URL zu finden

//github.com/gmarik/Vundle.vim.git

Damit ist das eigene Repo am eigenen git-server unter dieser Adresse erreichbar zu machen wenn die Variable MYSHELLCONFIG_VIM_PLUGINS wie oben Angegeben gesetzt wird.:

https://my.git.server/public/Vim/gmarik/Vundle

Über ~/.bashrc manuell festlegbare Variablen und ihre Default-Werte, wenn nicht manuell gesetzt:

MSC_SUBPATH=.local/myshellconfig
MSC_BASE="${HOME}/${MSC_SUBPATH}"
MSC_LOGDIR="${MSC_BASE}/logs"
MSC_LOGFILE="${MSC_LOGDIR}/git.log"
MSC_GIT_TIMEOUT=5s

MSC_GIT_SERVER="git.schuerz.at"
MSC_GIT_REPO_NAME="server-config.git"
MSC_GIT_REPO_PATH_HTTP="/public/"
MSC_GIT_REPO_PATH_SSH=":public/"
MSC_GIT_REPO_PATH_GIT="/public/"

Verteilen auf neuen Host/User

Einen neuen User auf einem anderen Host mit der selben Konfiguration versehen funktioniert folgendermaßen:

sshmyshellconfig USER@HOST

und dann auf dem Host einloggen

ssh USER@HOST

es können die üblichen ssh-Optionen und Parameter verwendet werden.

Signieren der Commits mit gpg

Wenn man seine Commits signieren möchte, kann dazu in der Datei

~/.gitconfig_local

folgendes eingetragen werden:

[user]
	signingKey = 0xABC123DEF456GHI7
[gpg]
	program = gpg2

signingKey muss natürlich dem eigenen gpg-Key entsprechen, der lokal vorhanden ist und verwendet werden soll.