From 3da3dc425905846f8b48963b1fe31fe436ea1a5c Mon Sep 17 00:00:00 2001 From: Jens True Date: Sat, 1 May 2021 19:16:57 +0200 Subject: [PATCH] Clean up language --- config/_default/config.yaml | 1 - content/post/architectural-overview/index.md | 42 +++++--------------- content/post/bit-magic/index.md | 22 ---------- content/post/btrfs-commands/index.md | 19 +++++---- content/post/online-tools/index.md | 24 +---------- 5 files changed, 19 insertions(+), 89 deletions(-) diff --git a/config/_default/config.yaml b/config/_default/config.yaml index b166390..baf5a7e 100644 --- a/config/_default/config.yaml +++ b/config/_default/config.yaml @@ -23,7 +23,6 @@ removePathAccents: true module: imports: - path: github.com/wowchemy/wowchemy-hugo-modules/wowchemy - ############################ ## ADVANCED ############################ diff --git a/content/post/architectural-overview/index.md b/content/post/architectural-overview/index.md index e64f934..d201003 100644 --- a/content/post/architectural-overview/index.md +++ b/content/post/architectural-overview/index.md @@ -1,71 +1,46 @@ --- -# Documentation: https://sourcethemes.com/academic/docs/managing-content/ - title: "Architectural Overview" subtitle: "Overview of the architecture behind this website." summary: "Overview of the architecture behind this website." -authors: ["admin"] -tags: [] -categories: [] date: 2020-02-27T22:10:31+01:00 lastmod: 2020-02-27T22:10:31+01:00 -featured: false -draft: false -math: false diagram: true -highlight: false - -# Featured image -# To use, add an image named `featured.jpg/png` to your page's folder. -# Focal points: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight. -image: - caption: "" - focal_point: "" - preview_only: false - -# Projects (optional). -# Associate this post with one or more of your projects. -# Simply enter your project's folder or file name without extension. -# E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`. -# Otherwise, set `projects = []`. -projects: [] --- - ## Introduction -I self host this site. I consider it a learning experience into hosting and managing a full linux server stack. The purpose of this post is to describe my current setup as notes to myself should I ever need to redo a similar setup. +I self host this site. I consider it a learning experience into hosting and managing a full Linux server stack. The purpose of this post is to describe my current setup as notes to myself should I ever need to redo a similar setup. My setup attempts to achieve the following goals: - Require no or little maintenance - I do not wish to daily check the status of the server - High data integrity - - Loosing data is not acceptable. Downtime while data is being recovered is however okay. + - Losing data is not acceptable. Downtime, while data is being recovered, is however okay. - Employ best practices - - TLS, Git and containers are all considered best practices in modern software development. + - TLS, Git, and containers are all considered best practices in modern software development. Out of scope: - Uptime and reliability - - I self host and do not host any critical services. + - I self-host and do not host any critical services. - Performance and scaling - The server is purely for personal use and hardware is cheap. ## Hardware -The websever is hosted on an HP MicroServer Gen8. The OS runs off a 120GB SSD drive and 2x3TB HDD running RAID1 using the btrfs filesystem. This provides a suitable balance between storage capacity, and performance. Offsite backup is done weekly through https://wasabi.com/ and their S3 compatible service. +The webserver is hosted on an HP MicroServer Gen8. The OS runs off a 120GB SSD drive and 2x3TB HDD running RAID1 using the Btrfs filesystem. This provides a suitable balance between storage capacity, and performance. Offsite backup is done weekly through https://wasabi.com/ and their S3 compatible service. ## Network The server is connected via Gigabit Ethernet to an ASUS router. The router supports both IPv4 and IPv6 and does port forwarding for port 80 and port 443 to the statically configured IP address. -On the WAN side a 150/150Mb/sec fiber line from Altibox provides internet connection, while the IP address is not static it changes rarely enough for this not to be an issue. +On the WAN side, a 150/150Mb/sec fiber line from Altibox provides the internet connection, and while the IP address is not static it changes rarely enough for this not to be an issue. The domain is registered via gandi.net providing both registration and name servers. ## Software -The software stack is built on containers. A reverse-proxy is employed to provide SSL certificates through LetsEncrypt. The webserver itself is Nginx running on an internal virtual network. +The software stack is built on containers. A reverse proxy is employed to provide SSL certificates through LetsEncrypt. The webserver itself is Nginx running on an internal virtual network. All containers are automatically updated as is the host system. @@ -83,4 +58,5 @@ graph LR; ## Build -The site uses the hugo static site generator. The content of the site are maintained in a git repository. On each update to the repository a dedicated build server generates the HTML and pushes it to the webserver. This allows the site to be updated from any machine with access to git. +The site uses the Hugo static site generator. The content of the site is maintained in a git repository. On each update to the repository, a dedicated build server generates the HTML and pushes it to the webserver. This allows the site to be updated from any machine with access to git. + diff --git a/content/post/bit-magic/index.md b/content/post/bit-magic/index.md index 39628f0..9889ba1 100644 --- a/content/post/bit-magic/index.md +++ b/content/post/bit-magic/index.md @@ -1,31 +1,9 @@ --- -# Documentation: https://sourcethemes.com/academic/docs/managing-content/ - title: "Bit magic in C (and C++)" subtitle: "Tips and trick for embedded C/C++" summary: "Tips and trick for embedded C/C++" -authors: [] -tags: [] -categories: [] date: 2020-06-13T19:01:19+02:00 lastmod: 2020-06-13T19:01:19+02:00 -featured: false -draft: false - -# Featured image -# To use, add an image named `featured.jpg/png` to your page's folder. -# Focal points: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight. -image: - caption: "" - focal_point: "" - preview_only: false - -# Projects (optional). -# Associate this post with one or more of your projects. -# Simply enter your project's folder or file name without extension. -# E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`. -# Otherwise, set `projects = []`. -projects: [] --- # Set a bit diff --git a/content/post/btrfs-commands/index.md b/content/post/btrfs-commands/index.md index 7a64393..d2f019c 100644 --- a/content/post/btrfs-commands/index.md +++ b/content/post/btrfs-commands/index.md @@ -1,21 +1,20 @@ --- title: "Btrfs - Helpful commands" date: 2020-09-03T00:00:00 -subtitle: "Useful commands for the btrfs file system" -summary: "Useful commands for the btrfs file system" +subtitle: "Useful commands for the Btrfs file system" +summary: "Useful commands for the Btrfs file system" --- +Quick collection of useful commands for maintaining a Btrfs filesystem. -Quick collection of useful commands for maintaining a btrfs filesystem. - -Btrfs allows for easy management of software raids in RAID0, RAID1 and RAID10. RAID5 and RAID6 are implemented but not suggested for use. +Btrfs allows for easy management of software raids in RAID0, RAID1, and RAID10. RAID5 and RAID6 are implemented but not suggested for use. {{% callout note %}} Btrfs (pronounced as "butter fuss", "better F S", "butter F S", "b-tree F S", or simply by spelling it out) is a file system based on the copy-on-write (COW) principle, initially designed at Oracle Corporation for use in Linux. The development of Btrfs began in 2007, and since August 2014 the file system's on-disk format has been marked as stable.[13] {{% /callout %}} -## btrfs device statistics -The btrfs device commands are used to check the status of the device, such as read / write errors and disk usage. +## Btrfs device statistics +The Btrfs device commands are used to check the status of the device, such as read / write errors and disk usage. See the current statistic. ```shell sudo btrfs device stats /path/to/fs @@ -27,7 +26,7 @@ sudo btrfs device usage /path/to/fs ``` ## btrfs scrub -btrfs scrub is used to scrub a btrfs filesystem, which will read all data and metadata blocks from all devices and verify checksums. Automatically repair corrupted blocks if there’s a correct copy available. +btrfs scrub is used to scrub a Btrfs filesystem, which will read all data and metadata blocks from all devices and verify checksums. Automatically repair corrupted blocks if there’s a correct copy available. ```shell sudo btrfs scrub start /path/to/fs/ @@ -40,7 +39,7 @@ sudo btrfs scrub status /path/to/fs/ ``` ## btrfs balance -The primary purpose of the balance feature is to spread block groups across all devices so they match constraints defined by the respective profiles. See mkfs.btrfs(8) section PROFILES for more details. The scope of the balancing process can be further tuned by use of filters that can select the block groups to process. Balance works only on a mounted filesystem. +The primary purpose of the balance feature is to spread block groups across all devices so they match constraints defined by the respective profiles. See mkfs.btrfs(8) section PROFILES for more details. The scope of the balancing process can be further tuned by the use of filters that can select the block groups to process. Balance works only on a mounted filesystem. ```shell sudo btrfs balance start /path/to/fs/ @@ -50,4 +49,4 @@ To see the status of an ongoing (or last run) balance use ```shell sudo btrfs balance status /path/to/fs/ -``` +``` \ No newline at end of file diff --git a/content/post/online-tools/index.md b/content/post/online-tools/index.md index f575637..46ad83f 100644 --- a/content/post/online-tools/index.md +++ b/content/post/online-tools/index.md @@ -1,35 +1,13 @@ --- -# Documentation: https://sourcethemes.com/academic/docs/managing-content/ - title: "Online Tools" subtitle: "A range of high quality tools you can use from your browser on any system." summary: "A range of high quality tools you can use from your browser on any system." -authors: [] -tags: [] -categories: [] date: 2020-04-08T22:09:37+02:00 lastmod: 2020-04-08T22:09:37+02:00 -featured: false -draft: false - -# Featured image -# To use, add an image named `featured.jpg/png` to your page's folder. -# Focal points: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight. -image: - caption: "" - focal_point: "" - preview_only: false - -# Projects (optional). -# Associate this post with one or more of your projects. -# Simply enter your project's folder or file name without extension. -# E.g. `projects = ["internal-project"]` references `content/project/deep-learning/index.md`. -# Otherwise, set `projects = []`. -projects: [] --- # Why -Sometimes you are simply stuck on a system where you can not install your own prefered tools. This is where online browser based tools comes to the assistance. +Sometimes you are simply stuck on a system where you can not install your own preferred tools. This is where online browser-based tools come to the rescue. - [urlscan.io](https://urlscan.io/) - Scan a url and provide a detailed report. Great for checking suspicious links without opening them in your own browser.