From 53eaf5254d50ead907e6e8167d68fe327f04e26b Mon Sep 17 00:00:00 2001 From: vincent Date: Tue, 29 Nov 2022 22:08:34 +0100 Subject: [PATCH] style: lint markdown --- .markdownlint.yaml | 1 + README.md | 7 +++---- docs/ADR/001-Development-environment.md | 5 +---- docs/Concepts/DNS.md | 2 +- docs/How-to/Add a new job.md | 3 --- docs/Installation/Bootstrap-dev.md | 6 ++---- 6 files changed, 8 insertions(+), 16 deletions(-) diff --git a/.markdownlint.yaml b/.markdownlint.yaml index a085265..857f770 100755 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -7,3 +7,4 @@ MD009: MD013: false MD033: false MD024: false +MD041: false diff --git a/README.md b/README.md index 68eb7e9..b8899aa 100644 --- a/README.md +++ b/README.md @@ -8,16 +8,15 @@ this Homelab is build over Hashicorp software: - Consul - Vault -## Rebuild +## Rebuild + to rebuild from scratch ansible need a vault server up and unseal you can rebuild a standalone vault server with a consul database snaphot with -``` +```sh make vault-dev FILE=./yourconsulsnaphot.snap ``` - - ## Architecture ```mermaid diff --git a/docs/ADR/001-Development-environment.md b/docs/ADR/001-Development-environment.md index e72caa4..834687d 100644 --- a/docs/ADR/001-Development-environment.md +++ b/docs/ADR/001-Development-environment.md @@ -6,15 +6,13 @@ Accepted ## Context -we need to create a virtual cluster to do test without impact on production -diferent way: +we need to create a virtual cluster to do test without impact on production. ### Virtualisation or Container Virtualisation provide better isolation but must ressource are needed. Container able to create more item without consum as resource than virtual machine. - ### Creation Wrapper Vagrant is good top manage virtual machine but not a lot of LXC box availlable, Vagant van be use with other configuration manager than ansible. @@ -29,4 +27,3 @@ Molecule wrapper will be use because all our configuration is already provide b ## Consequences Need to create dev env other an LXD server. - diff --git a/docs/Concepts/DNS.md b/docs/Concepts/DNS.md index 3d9a4be..1269c4a 100644 --- a/docs/Concepts/DNS.md +++ b/docs/Concepts/DNS.md @@ -23,7 +23,7 @@ Pihole container in nomad cluster is set as primary DNS as add blocker secondary DNS locate on NAS manage domain *ducamps.win* on local network pihole forward each request on *ducamps.win* to this DNS. -Each DNS forward *service.consul* request to the consul cluster. On Pihole a template configure each consul server. +Each DNS forward *service.consul* request to the consul cluster. On Pihole a template configure each consul server. On diskstation every request as forward to one consul node this point is to improve we because we have a possibility of outtage. du to synology DNSServer limitation we only put a forward on port 53 so we need on the target consul node to redirect port 53 to 8300 by iptables rules. diff --git a/docs/How-to/Add a new job.md b/docs/How-to/Add a new job.md index 06db044..9222a9c 100644 --- a/docs/How-to/Add a new job.md +++ b/docs/How-to/Add a new job.md @@ -1,12 +1,9 @@ # Add a new job - ## Create Nomad job - ## Add secret to vault - ## Add a new policy to Vault terraform ## Add Database creation in ansible variable (if neeeded) diff --git a/docs/Installation/Bootstrap-dev.md b/docs/Installation/Bootstrap-dev.md index 7ff83a5..674a2ca 100644 --- a/docs/Installation/Bootstrap-dev.md +++ b/docs/Installation/Bootstrap-dev.md @@ -1,13 +1,13 @@ # How to Bootstrap dev env ## prerequisite + dev environment is manage by molecule job who launch container via LXD you need following software to launch it: - LXD server up on your local machine -- molecule install ``` pip install molecule``` +- molecule install ```pip install molecule``` - molecule-LXD plugins ```pip install molecule-lxd``` - ## provissionning you can launch ```make create-dev``` on root project @@ -20,6 +20,4 @@ molecule will create 3 container on different distribution To bootstrap the container (base account, sudo configuration) role [ansible_bootstrap](https://git.ducamps.win/ansible-roles/ansible_bootstrap) will be apply - Converge step call playbook [site.yml](https://git.ducamps.win/vincent/homelab/src/commit/c5ff235b9768d91b240ec97e7ff8e2ad5a9602ca/ansible/site.yml) to provission the cluster -