Sync latest changes from Christian

doctorfree · doctorfree · commit 3f32b3c18da2 · 2022-10-27T15:53:12.000-07:00
diff --git a/apps/argocd.md b/apps/argocd.md
@@ -145,3 +145,10 @@ spec:
         server: '{{server}}'
         namespace: default
 ```
+
+## Further information
+
+More examples and tutorials regarding ArgoCD can be found in the link list below:
+
+- Basic tutorial for installation and configuration: [Let loose the squid - Deploy ArgoCD the declarative way](https://thedatabaseme.de/2022/06/05/let-loose-the-squid-deploy-argocd-the-declarative-way/)
+- Writing ArgoCD Plugins: [ArgoCD Custom Plugins](https://dev.to/tylerauerbeck/argocd-custom-plugins-creating-a-custom-plugin-to-process-openshift-templates-4p5m)
diff --git a/apps/proxmox.md b/apps/proxmox.md
@@ -20,3 +20,10 @@ qemu-img resize -f raw vm-100.raw 10G
 ```
 qemu-img convert -p -O qcow2 vm-100.raw vm-100.qcow2
 ```
+
+## Further information
+
+More examples and tutorials regarding Proxmox can be found in the link list below:
+
+- Ansible playbook that automates Linux VM updates running on Proxmox (including snapshots): [TheDatabaseMe - update_proxmox_vm](https://github.com/thedatabaseme/update_proxmox_vm)
+- Manage Proxmox VM templates with Packer: [Use Packer to build Proxmox images](https://thedatabaseme.de/2022/10/16/what-a-golden-boy-use-packer-to-build-proxmox-images/)
diff --git a/databases/postgres.md b/databases/postgres.md
@@ -1,13 +1,28 @@
 # PostgreSQL Cheat-Sheet
 PostgreSQL or also known as Postgres, is a free and open-source relational database management system. PostgreSQL features transactions with Atomicity, Consistency, Isolation, Durability (ACID) properties automatically updatable views, materialized views, triggers, foreign keys, and stored procedures. It is designed to handle a range of workloads, from single machines to data warehouses or web services with many concurrent users.
 
-## Install PostgreSQL 12 on Ubuntu 20.04 LTS
+## Installation
+
+### Install PostgreSQL 12 on Ubuntu 20.04 LTS
 ```bash
 sudo apt update
 sudo apt install -y postgresql postgresql-contrib postgresql-client
 sudo systemctl status postgresql.service
 ```
 
+### Install / deploy Postgres on Kubernetes with Zalando Postgres Operator
+
+Postgres is probably the database which is most common on Cloud platforms and also, running
+on Kubernetes environments. There are several so called "Kubernetes Operators" which handle
+the deployment of Postgres clusters for you. One of it is the [Postgres Operator by Zalando](https://github.com/zalando/postgres-operator).
+
+You can find some tutorials regarding deployment of the operator and how to work with it,
+in the link list below:
+
+- [Deploy Zalando Postgres Operator on your Kubernetes cluster](https://thedatabaseme.de/2022/03/13/keep-the-elefants-in-line-deploy-zalando-operator-on-your-kubernetes-cluster/)
+- [Configure Zalando Postgres Operator Backup with WAL-G](https://thedatabaseme.de/2022/03/26/backup-to-s3-configure-zalando-postgres-operator-backup-with-wal-g/)
+- [Configure Zalando Postgres Operator Restore with WAL-G](https://thedatabaseme.de/2022/05/03/restore-and-clone-from-s3-configure-zalando-postgres-operator-restore-with-wal-g/)
+
 ## Initial database connection
 
 A local connection (from the database server) can be done by the following command:
@@ -104,4 +119,4 @@ To change the owner of an existing database later, you can use the following com
 ```sql
 postgres=# alter database dbname owner to myuser;
 ALTER DATABASE
-```
+```
diff --git a/docker/docker.md b/docker/docker.md
@@ -140,12 +140,24 @@ COMMAND | DESCRIPTION
 `docker volume prune` | Delete all volumes (not referenced by any container)
 
 ### Backup a container
-Backup docker data from inside container volumes and package it in a tarball archive.
-`docker run --rm --volumes-from CONTAINER -v $(pwd):/backup busybox tar cvfz /backup/backup.tar CONTAINERPATH`
+
+Backup docker data from inside container volumes and package it in a tarball archive:
+
+```shell
+docker run --rm --volumes-from CONTAINER -v $(pwd):/backup busybox tar cvfz /backup/backup.tar CONTAINERPATH
+```
+
+An automated backup can be done also by this [Ansible playbook](https://github.com/thedatabaseme/docker_backup). The output is also a (compressed) tar. The playbook can also manage the backup retention. So older backups will get deleted automatically.
+
+To also create and backup the container configuration itself, you can use `docker-replay`for that. If you lose the entire container, you can recreate it with the export from `docker-replay`. A more detailed tutorial on how to use docker-replay can be found [here](https://thedatabaseme.de/2022/03/18/shorty-generate-docker-run-commands-using-docker-replay/).
 
 ### Restore container from backup
-Restore the volume with a tarball archive.
-`docker run --rm --volumes-from CONTAINER -v $(pwd):/backup busybox sh -c "cd CONTAINERPATH && tar xvf /backup/backup.tar --strip 1"`
+
+Restore the volume with a tarball archive:
+
+```shell
+docker run --rm --volumes-from CONTAINER -v $(pwd):/backup busybox sh -c "cd CONTAINERPATH && tar xvf /backup/backup.tar --strip 1"
+```
 
 ## Networks
 
diff --git a/kubernetes/kind.md b/kubernetes/kind.md
@@ -0,0 +1,94 @@
+# Kind
+
+Using the Kind project, you are able to easily deploy a Kubernetes cluster on top of Docker as Docker containers. Kind will spawn separate containers which be shown as the Kubernetes nodes. In this documentation, you can find some examples, as well as a link to a Ansible playbook which can do the cluster creation / deletion for you. This document only describes the basics of Kind. To find more detailed information, you can check the [official Kind documentation](https://kind.sigs.k8s.io/docs/user/quick-start/).
+
+Kind is ideal to use in a local development environment or even during a build pipeline run.
+
+## Installation on Linux
+
+Since Kind deploys Docker containers, it needs to have a Container engine (like Docker) installed.
+
+Installing Kind can be done by downloading the latest available release / binary for your platform:
+
+```bash
+curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.16.0/kind-linux-amd64
+chmod +x ./kind
+sudo mv ./kind /usr/local/bin/kind
+```
+
+## Cluster management
+
+### Cluster creation
+
+You have to provide a configuration file which tells Kind how you want your Kubernetes cluster to be deployed. Find an example configuration file below:
+
+```yaml
+kind: Cluster
+apiVersion: kind.x-k8s.io/v1alpha4
+name: testcluster
+# 1 control plane node and 2 workers
+nodes:
+# the control plane node config
+- role: control-plane
+# the two workers
+- role: worker
+- role: worker
+```
+
+Create the cluster by the following command:
+
+```bash
+kind create cluster --config kind-cluster-config.yaml
+Creating cluster "testcluster" ...
+Ensuring node image (kindest/node:v1.25.2)
+Preparing nodes
+Writing configuration
+Starting control-plane
+Installing CNI
+Installing StorageClass
+Joining worker nodes
+
+Set kubectl context to "kind-testcluster"
+You can now use your cluster with:
+kubectl cluster-info --context kind-testcluster
+
+Not sure what to do next? Check out https://kind.sigs.k8s.io/docs/user/quick-start/
+```
+
+Checking for Docker containers running, you can see the following:
+
+```bash
+docker ps -a
+
+CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+ac14d8c7a3c9 kindest/node:v1.25.2 "/usr/local/bin/entr..." 2 minutes ago Up About a minute testcluster-worker2
+096dd4bf1718 kindest/node:v1.25.2 "/usr/local/bin/entr..." 2 minutes ago Up About a minute 127.0.0.1:42319->6443/tcp testcluster-control-plane
+e1ae2d701394 kindest/node:v1.25.2 "/usr/local/bin/entr..." 2 minutes ago Up About a minute testcluster-worker
+```
+
+### Interacting with your cluster
+
+You may have multiple Kind clusters deployed at the same time. To get a list of running clusters, you can use the following command:
+
+```bash
+kind get clusters
+kind
+kind-2
+```
+
+After cluster creation, the Kubernetes context is set automatically to the newly created cluster. In order to set the currently used kubeconfig, you may use some tooling like [kubectx](https://github.com/ahmetb/kubectx). You may also set the current context used by `kubectl` with the `--context` option, which refers to the Kind cluster name.
+
+### Cluster deletion
+
+To delete a Kind cluster, you can use the following command. Kind will also delete the kubeconfig of the deleted cluster. So you don't need to do this on your own.
+
+```bash
+kind delete cluster -n testcluster
+Deleting cluster "testcluster" ...
+```
+
+## Further information
+
+More examples and tutorials regarding Proxmox can be found in the link list below:
+
+- Creating an Ansible playbook to manage Kind cluster: [Lightweight Kubernetes cluster using Kind and Ansible](https://thedatabaseme.de/2022/04/22/lightweight-kubernetes-cluster-using-kind-and-ansible/)
diff --git a/kubernetes/kubernetes.md b/kubernetes/kubernetes.md
@@ -28,6 +28,7 @@ Github Repository: https://github.com/kubernetes/kubernetes
 - [k3s-install-ha-externaldb](k3s-install-ha-externaldb.md)
 - [k3s-install-single](k3s-install-single.md)
 - [k9s](k9s.md)
+- [kind](kind.md)
 - [kubernetes-automation](kubernetes-automation.md)
 - [kubernetes-dns](kubernetes-dns.md)
 - [docker](../docker/docker.md)
diff --git a/kubernetes/kubernetes_index.md b/kubernetes/kubernetes_index.md
@@ -9,6 +9,7 @@ Index of kubernetes category
 - [K3s-install-single](k3s-install-single.md)
 - [K3s](k3s.md)
 - [K9s](k9s.md)
+- [Kind](kind.md)
 - [Kubectl](kubectl.md)
 - [Kubernetes-automation](kubernetes-automation.md)
 - [Kubernetes-dns](kubernetes-dns.md)
diff --git a/macos/chrome-on-macos.md b/macos/chrome-on-macos.md
@@ -0,0 +1,10 @@
+# Google Chrome
+
+## Advanced
+
+### No "Proceed Anyway" Option
+
+Chrome on MacOS won't show a "Proceed Anyway" Option on `NE:ERR_CERT_INVALID` invalid SSL Certificates. Use the secret passphrase as a workaround.
+
+1. Make sure the website is selected
+2. Just type in `thisisunsafe`
diff --git a/macos/macos_index.md b/macos/macos_index.md
@@ -2,7 +2,8 @@
 
 Index of macos category
 
-- [Docker-on-macos-silicon](docker-on-macos-silicon.md)
-- [Macos](macos.md)
-- [Macos-shortcuts](macos-shortcuts.md)
-- [Vscode-macos-shortcuts](vscode-macos-shortcuts.md)
+- [Chrome on Mac OS](chrome-on-macos.md)
+- [Docker on Mac OS Silicon](docker-on-macos-silicon.md)
+- [Mac OS](macos.md)
+- [Macos Shortcuts](macos-shortcuts.md)
+- [Vscode Mac OS Shortcuts](vscode-macos-shortcuts.md)
diff --git a/tools/git.md b/tools/git.md
@@ -18,7 +18,76 @@ Repository: https://git.kernel.org/pub/scm/git/git.git
 
 Website: https://git-scm.com/
 
-## Usage
+## Installation
+
+Git can easily be installed on Linux systems with the available package managers (e.g. for Debian based systems by `apt install git`).
+
+For other systems, see the [git download page](https://git-scm.com/downloads).
+
+## Configuration
+
+Git can be configured from the command line using the `git config` command. For first configuration it is necessary to configure at least the parameters `user.name` and `user.email`. This can be done with the following commands:
+
+```bash
+git config --global user.name "MyFancyUser"
+```
+
+```bash
+git config --global user.email "developer@mydomain.com"
+```
+
+## Using Git
+
+The following commands can be helpful for working with `git`.
+
+| git command                        | Comment                                                                                                                                        |
+| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `git init`                         | Initialize a directory as git managed repository                                                                                               |
+| `git clone <repo_url>`             | Clone a remote repository to your local client                                                                                                 |
+| `git status`                       | Shows uncommited changes, new files etc.                                                                                                       |
+| `git add <wildcard_or_filename>`   | Stage an updated / new file to the next commit                                                                                                 |
+| `git rm <wildcard_or_filename>`    | Remove a file and stage the removal for the next commit                                                                                        |
+| `git commit -m "<commit message">` | Commit staged changes under a new commit                                                                                                       |
+| `git commit`                       | Will open an editor to write more descriptive commit messages.<br> See [here](https://cbea.ms/git-commit/) for a guide on good commit messages |
+| `git checkout <branch_name>`       | Switch to another branch                                                                                                                       |
+| `git branch`                       | Shows a list of existing branches                                                                                                              |
+| `git branch <branch_name>`         | Creates a new branch (from the currently checked out branch)                                                                                   |
+| `git merge <branch_name>`          | Merge changes from `branch_name` to the currently checked out branch                                                                           |
+| `git push`                         | Push commited changes to the remote repository                                                                                                 |
+| `git pull`                         | Pull current state from the remote repository to your local repo                                                                               |
+
+### Working with git-flow
+
+Git-flow assists you by combining multiple steps of `git` commands to one `git-flow` command which will do a workflow of steps. Although `git-flow` makes live easier in some cases, it makes it also more complex sometimes and you need to execute some steps before or after using a `git-flow` command as regular `git` command. (See below)
+
+As an example, here is the comparison between the regular `git` commands and the appropriate `git-flow` command for creating a release.
+
+| git-flow command                                    | git command                                           |
+| --------------------------------------------------- | ----------------------------------------------------- |
+| `git-flow feature start <feature_name>`             | `git checkout -b feature/<feature_name> develop`      |
+| `git-flow feature finish <feature_name> [--squash]` | `git checkout develop`                                |
+|                                                     | `git merge [--squash] --no-ff feature/<feature_name>` |
+|                                                     | `git branch -d feature/<feature_name>`                |
+
+Another `git-flow` cheat sheet can be found [here](https://danielkummer.github.io/git-flow-cheatsheet/).
+
+## Using git-crypt
+
+Having secret or sensitive information in your git repository is never a good choice. But sometimes it's necessary. Never push unencrypted data to your remote repository.
+
+Git-crypt is a transparent encryption tool that works seamless with your Git repository. All sensitive information is encrypted before pushed to the remote repository. Once you've unlocked the repository locally, all data will be decrypted automatically when pulling from the remote repo. This makes development with encrypted data effortless.
+
+To install git-crypt, you can use the distribution package manager (e.g. `apt`):
+
+```bash
+sudo apt install git-crypt
+```
+
+To initialize a new repository with git-crypt, you can use `git-crypt init` when located in the repository directory. An already encrypted git repository can be unlocked by `git-crypt unlock`. This requires you to have either the repository encryption key in your GPG keychain, or that your private GPG key has been added to the allowed keys in the repository. For more details, see the links below.
+
+For more information, check out the [official Github repository](https://github.com/AGWA/git-crypt). A tutorial on git-crypt can be found [here](https://thedatabaseme.de/2022/04/13/lets-keep-this-our-secret-transparent-git-encryption-using-git-crypt/).
+
+## Example usage
 
 ### Create a Repository
 Create a new local repository
@@ -288,18 +357,24 @@ A `.gitignore` file specifies intentionally untracked files that Git should igno
 ## Git Tricks
 
 ### Rename branch 
-- #### **Renamed** to `new_name`
-    ```bash
-    git branch -m <new_name>
-    ```
-- #### **Push** and reset
-    ```bash
-    git push origin -u <new_name>
-    ```
-- #### **Delete** remote branch
-    ```bash
-    git push origin --delete <old>
-    ```
+
+#### **Renamed** to `new_name`
+
+```bash
+git branch -m <new_name>
+```
+
+#### **Push** and reset
+
+```bash
+git push origin -u <new_name>
+```
+
+#### **Delete** remote branch
+
+```bash
+git push origin --delete <old>
+```
 
 ### Log
 Search change by content
diff --git a/tools/vagrant.md b/tools/vagrant.md
@@ -34,3 +34,7 @@ COMMAND | DESCRIPTION
 `vagrant box outdated` | Check for updates vagrant box update
 `vagrant box remove <BOXNAME>` | Deletes a box from the machine
 `vagrant package` | Packages a running virtualbox env in a reusable box
+
+## Vagrant with WSL2
+
+Vagrant is able to run inside your Windows Subsystem for Linux environment. A tutorial on how to install and use it with your Windows installed Virtualbox can be found [here](https://thedatabaseme.de/2022/02/20/vagrant-up-running-vagrant-under-wsl2/).
diff --git a/tools/wsl.md b/tools/wsl.md
@@ -65,3 +65,7 @@ netsh advfirewall firewall delete rule name=$port
 ```powershell
 netsh interface portproxy show v4tov4
 ```
+
+## Linux desktop in WSL2
+
+With WSL2 it's possible to install and run a Linux desktop environment (XFCE). A tutorial on how to implement that, can be found [here](https://thedatabaseme.de/2022/05/15/shorty-running-xfce-linux-desktop-on-wsl2/).
